001// --------------------------------------------------------------------------------
002// Copyright 2002-2026 Echo Three, LLC
003//
004// Licensed under the Apache License, Version 2.0 (the "License");
005// you may not use this file except in compliance with the License.
006// You may obtain a copy of the License at
007//
008//     http://www.apache.org/licenses/LICENSE-2.0
009//
010// Unless required by applicable law or agreed to in writing, software
011// distributed under the License is distributed on an "AS IS" BASIS,
012// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013// See the License for the specific language governing permissions and
014// limitations under the License.
015// --------------------------------------------------------------------------------
016
017package com.echothree.model.control.subscription.server.logic;
018
019import com.echothree.model.control.chain.common.ChainKinds;
020import com.echothree.model.control.chain.common.ChainTypes;
021import com.echothree.model.control.chain.common.ChainEntityRoleTypes;
022import com.echothree.model.control.chain.server.control.ChainControl;
023import com.echothree.model.control.chain.server.logic.ChainInstanceLogic;
024import com.echothree.model.control.chain.server.logic.ChainLogic;
025import com.echothree.model.control.chain.server.logic.ChainTypeLogic;
026import com.echothree.model.control.subscription.server.control.SubscriptionControl;
027import com.echothree.model.data.chain.server.entity.Chain;
028import com.echothree.model.data.chain.server.entity.ChainInstance;
029import com.echothree.model.data.subscription.server.entity.Subscription;
030import com.echothree.util.common.persistence.BasePK;
031import com.echothree.util.server.control.BaseLogic;
032import com.echothree.util.server.message.ExecutionErrorAccumulator;
033import javax.enterprise.context.ApplicationScoped;
034import javax.enterprise.inject.spi.CDI;
035import javax.inject.Inject;
036
037@ApplicationScoped
038public class SubscriptionChainLogic
039        extends BaseLogic {
040
041    @Inject
042    ChainControl chainControl;
043
044    @Inject
045    SubscriptionControl subscriptionControl;
046
047    @Inject
048    protected ChainInstanceLogic chainInstanceLogic;
049
050    @Inject
051    protected ChainLogic chainLogic;
052
053    @Inject
054    protected ChainTypeLogic chainTypeLogic;
055
056    protected SubscriptionChainLogic() {
057        super();
058    }
059
060    public static SubscriptionChainLogic getInstance() {
061        return CDI.current().select(SubscriptionChainLogic.class).get();
062    }
063    
064    /** createChainInstance is different than the version in BaseChainLogic, it requires a Subscription parameter. Subscriptions
065     * are allowed to override the Chain being used in each SubscriptionType, so this takes that into account when choosing a
066     * Chain. If there is no SubscriptionTypeChain, then we fall back to the default for the ChainType, following the normal
067     * rules that take OfferChainTypes into account as well. If the chainTypeName == RENEWAL, then we immediately fall back to the
068     * default for the ChainType.
069     * 
070     * TODO: RENEWAL should really be based on the amount of time remaining in the Subscription, and not just fall back to the
071     * default. getSubscriptionTypeChainsBySubscriptionTypeAndChainType(...) could order by the remaining time, and then search
072     * for the one that's the best fit.
073     */
074    protected ChainInstance createChainInstance(final ExecutionErrorAccumulator eea, final String chainKindName, final String chainTypeName,
075            final Subscription subscription, final BasePK createdBy) {
076        var subscriptionType = subscription.getLastDetail().getSubscriptionType();
077        var chainType = chainTypeLogic.getChainTypeByName(eea, chainKindName, chainTypeName);
078        var party = subscription.getLastDetail().getParty();
079        var subscriptionTypeChains = chainTypeName.equals(ChainTypes.RENEWAL.name()) ? null
080                : subscriptionControl.getSubscriptionTypeChainsBySubscriptionTypeAndChainType(subscriptionType, chainType);
081        Chain chain;
082        ChainInstance chainInstance = null;
083        
084        if(subscriptionTypeChains == null || subscriptionTypeChains.isEmpty()) {
085            chain = chainLogic.getChain(eea, chainType, party);
086        } else {
087            chain = subscriptionTypeChains.iterator().next().getChain();
088        }
089        
090        if(chain != null) {
091            chainInstance = chainInstanceLogic.createChainInstance(eea, chainType, party, createdBy);
092        }
093        
094        return chainInstance;
095    }
096    
097    protected ChainInstance createSubscriptionChainInstance(final ExecutionErrorAccumulator eea, final String chainTypeName, final Subscription subscription,
098            final BasePK createdBy) {
099        var chainInstance = createChainInstance(eea, ChainKinds.SUBSCRIPTION.name(), chainTypeName, subscription, createdBy);
100        
101        if(chainInstance != null) {
102            var chainType = chainInstance.getLastDetail().getChain().getLastDetail().getChainType();
103        
104            chainControl.createChainInstanceEntityRole(chainInstance, chainControl.getChainEntityRoleTypeByName(chainType,
105                    ChainEntityRoleTypes.SUBSCRIPTION.name()), subscription.getPrimaryKey(), createdBy);
106        }
107        
108        return chainInstance;
109    }
110    
111    public ChainInstance createSubscriptionInitialChainInstance(final ExecutionErrorAccumulator eea, final Subscription subscription,
112            final BasePK createdBy) {
113        return createSubscriptionChainInstance(eea, ChainTypes.INITIAL.name(), subscription, createdBy);
114    }
115    
116    public ChainInstance createSubscriptionExpirationWarningChainInstance(final ExecutionErrorAccumulator eea, final Subscription subscription,
117            final BasePK createdBy) {
118        return createSubscriptionChainInstance(eea, ChainTypes.EXPIRATION_WARNING.name(), subscription, createdBy);
119    }
120    
121    /** TODO: Consider the RemainingTime in the SubscriptionDetail when choosing the Chain to use.
122     */
123    public ChainInstance createSubscriptionRenewalChainInstance(final ExecutionErrorAccumulator eea, final Subscription subscription,
124            final BasePK createdBy) {
125        return createSubscriptionChainInstance(eea, ChainTypes.RENEWAL.name(), subscription, createdBy);
126    }
127    
128    public ChainInstance createSubscriptionExpirationChainInstance(final ExecutionErrorAccumulator eea, final Subscription subscription,
129            final BasePK createdBy) {
130        return createSubscriptionChainInstance(eea, ChainTypes.EXPIRATION.name(), subscription, createdBy);
131    }
132    
133}