@mj-biz-apps/orders-core-entities-server 0.0.1 → 5.2.0

package/dist/EntitlementRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntitlementRead.d.ts","sourceRoot":"","sources":["../src/EntitlementRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACH,iBAAiB,EAKjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIH,KAAK,mBAAmB,EAE3B,MAAM,0BAA0B,CAAC;AAUlC,MAAM,WAAW,qBAAqB;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6FAA6F;IAC7F,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAqDD,uGAAuG;AACvG,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAiO/C;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CACxC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC,CAkFjC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CACxC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC,CA2GjC"}

package/dist/EntitlementRead.js

@@ -0,0 +1,368 @@
+/**
+ * Entitlement read path — load the rows, then ask `EvaluateGrantAccess`.
+ *
+ * `Orders.CheckEntitlement` and `Orders.ListEntitlements` share this so they cannot disagree
+ * about which grants count, how email resolves, or how a cancelled subscription is read.
+ * The judgement itself lives in `EntitlementBehavior` and has no database.
+ *
+ * v1 is person grants only. Org-only rows (`BeneficiaryPersonID` null) are never loaded.
+ * Email is a convenience: normalised, and refused when it matches more than one person —
+ * first-match would be an authorization bug dressed as helpfulness.
+ *
+ * CONNECTS TO:
+ *   PURE:   ./EntitlementBehavior.ts
+ *   OPS:    ./CheckEntitlementOperation.ts, ./ListEntitlementsOperation.ts
+ *   DOC:    plans/entitlement-read-contract.md
+ */
+import { LogError, LogStatus, RunView, } from '@memberjunction/core';
+import { CacheUntilFor, EvaluateGrantAccess, PickWinningAccess, } from './EntitlementBehavior.js';
+import { EscapeText, InvalidOperationInputError, RequireOptionalUUID, RequireUUID } from './sql-guards.js';
+const PRODUCT_ENTITLEMENT_ENTITY = 'MJ_BizApps_Orders: Product Entitlements';
+const ENTITLEMENT_GRANT_ENTITY = 'MJ_BizApps_Orders: Entitlement Grants';
+const PRODUCT_ENTITY = 'MJ_BizApps_Orders: Products';
+const SUBSCRIPTION_ENTITY = 'MJ_BizApps_Orders: Subscriptions';
+const SUBSCRIPTION_TERM_ENTITY = 'MJ_BizApps_Orders: Subscription Terms';
+const PERSON_ENTITY = 'MJ_BizApps_Common: People';
+function quoteIds(ids, field) {
+    return [...new Set(ids.map((id) => `'${RequireUUID(id, field)}'`))].join(',');
+}
+function toDate(value) {
+    if (value == null || value === '')
+        return null;
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? null : value;
+    const d = new Date(String(value));
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+function toISO(d) {
+    return d ? d.toISOString() : undefined;
+}
+/** NTP skew between LXP and Orders. CacheUntil does not use AsOf, so this cannot mint a long cache. */
+export const ASOF_FUTURE_TOLERANCE_MS = 60_000;
+function parseAsOf(value, now = new Date()) {
+    if (value == null || value === '')
+        return now;
+    let d;
+    if (value instanceof Date) {
+        d = value;
+    }
+    else {
+        const text = String(value);
+        if (/['";]/.test(text)) {
+            throw new InvalidOperationInputError('AsOf must be an ISO datetime.');
+        }
+        d = new Date(text);
+    }
+    if (Number.isNaN(d.getTime())) {
+        throw new InvalidOperationInputError('AsOf must be an ISO datetime.');
+    }
+    // Historical audit ("did they have access on the 3rd?") is the point of AsOf.
+    // Hours/years ahead is refused. Sub-minute skew is NTP, not a diagnostic of 2030.
+    if (d.getTime() > now.getTime() + ASOF_FUTURE_TOLERANCE_MS) {
+        throw new InvalidOperationInputError('AsOf cannot be in the future.');
+    }
+    return d;
+}
+function requireCode(value) {
+    const code = String(value ?? '').trim();
+    if (!code)
+        throw new InvalidOperationInputError('Code is required.');
+    if (code.length > 80)
+        throw new InvalidOperationInputError('Code is too long.');
+    return code;
+}
+function normalizeEmail(value) {
+    const email = String(value ?? '').trim().toLowerCase();
+    if (!email)
+        return null;
+    if (email.length > 254)
+        throw new InvalidOperationInputError('Email is too long.');
+    return email;
+}
+function closedCheck(evaluatedAt, issuedAt = new Date()) {
+    return {
+        HasAccess: false,
+        Decision: 'NoGrant',
+        EvaluatedAt: evaluatedAt.toISOString(),
+        CacheUntil: CacheUntilFor(issuedAt, null, false).toISOString(),
+    };
+}
+function toCheckOutput(evaluatedAt, picked, issuedAt = new Date()) {
+    if (!picked)
+        return closedCheck(evaluatedAt, issuedAt);
+    return {
+        HasAccess: picked.HasAccess,
+        Decision: picked.Decision,
+        ValidFrom: toISO(picked.ValidFrom),
+        ValidTo: toISO(picked.ValidTo),
+        Quantity: picked.Quantity ?? undefined,
+        GrantID: picked.GrantID,
+        EvaluatedAt: evaluatedAt.toISOString(),
+        CacheUntil: CacheUntilFor(issuedAt, picked.ValidTo, picked.HasAccess).toISOString(),
+    };
+}
+async function runSimple(rv, user, entity, extraFilter, fields, maxRows) {
+    const result = await rv.RunView({
+        EntityName: entity,
+        ExtraFilter: extraFilter,
+        ...(fields ? { Fields: fields } : {}),
+        ...(maxRows != null ? { MaxRows: maxRows } : {}),
+        ResultType: 'simple',
+        BypassCache: true,
+    }, user);
+    if (!result?.Success) {
+        LogError(`[ENTITLEMENT-READ] ${entity} lookup failed: ${result?.ErrorMessage ?? 'unknown error'}`);
+        return { ok: false, rows: [] };
+    }
+    return { ok: true, rows: result.Results ?? [] };
+}
+/**
+ * PersonID is authoritative. Email is convenience: 0 or >1 matches → null, indistinguishable
+ * from unknown. Never first-match.
+ */
+async function resolvePersonID(rv, user, personID, email) {
+    if (personID)
+        return RequireUUID(personID, 'PersonID');
+    const normalised = normalizeEmail(email);
+    if (!normalised)
+        return null;
+    const escaped = EscapeText(normalised);
+    const found = await runSimple(rv, user, PERSON_ENTITY, `LOWER(Email) = '${escaped}'`, ['ID'], 2);
+    if (!found.ok)
+        return null;
+    if (found.rows.length !== 1)
+        return null;
+    const id = found.rows[0]?.ID;
+    if (!id)
+        return null;
+    try {
+        return RequireUUID(id, 'PersonID');
+    }
+    catch {
+        return null;
+    }
+}
+async function filterTemplatesByCompany(rv, user, templates, companyID) {
+    const productIDs = [...new Set(templates.map((t) => t.ProductID).filter(Boolean))];
+    if (!productIDs.length)
+        return [];
+    const products = await runSimple(rv, user, PRODUCT_ENTITY, `ID IN (${quoteIds(productIDs, 'ProductID')}) AND CompanyID = '${companyID}'`, ['ID', 'CompanyID']);
+    if (!products.ok)
+        return null;
+    const allowed = new Set(products.rows.map((p) => p.ID.toLowerCase()));
+    return templates.filter((t) => allowed.has(t.ProductID.toLowerCase()));
+}
+async function loadContext(rv, user, grants) {
+    const subs = new Map();
+    const terms = new Map();
+    const subIDs = [...new Set(grants.map((g) => g.SubscriptionID).filter((id) => !!id))];
+    const termIDs = [...new Set(grants.map((g) => g.SubscriptionTermID).filter((id) => !!id))];
+    if (subIDs.length) {
+        const loaded = await runSimple(rv, user, SUBSCRIPTION_ENTITY, `ID IN (${quoteIds(subIDs, 'SubscriptionID')})`, ['ID', 'Status', 'EndDate']);
+        if (!loaded.ok)
+            return { ok: false, subs, terms };
+        for (const row of loaded.rows)
+            subs.set(row.ID.toLowerCase(), row);
+    }
+    if (termIDs.length) {
+        const loaded = await runSimple(rv, user, SUBSCRIPTION_TERM_ENTITY, `ID IN (${quoteIds(termIDs, 'SubscriptionTermID')})`, ['ID', 'Status', 'StartDate', 'EndDate']);
+        if (!loaded.ok)
+            return { ok: false, subs, terms };
+        for (const row of loaded.rows)
+            terms.set(row.ID.toLowerCase(), row);
+    }
+    return { ok: true, subs, terms };
+}
+function evaluateGrant(grant, asOf, code, subs, terms) {
+    const sub = grant.SubscriptionID ? subs.get(grant.SubscriptionID.toLowerCase()) : undefined;
+    const term = grant.SubscriptionTermID ? terms.get(grant.SubscriptionTermID.toLowerCase()) : undefined;
+    const evaluation = EvaluateGrantAccess({
+        Status: grant.Status,
+        ValidFrom: toDate(grant.ValidFrom),
+        ValidTo: toDate(grant.ValidTo),
+        LinkedToSubscription: !!grant.SubscriptionID,
+        LinkedToTerm: !!grant.SubscriptionTermID,
+    }, asOf, sub
+        ? { Status: sub.Status, EndDate: toDate(sub.EndDate) }
+        : grant.SubscriptionID
+            ? null
+            : undefined, term
+        ? {
+            Status: term.Status,
+            StartDate: toDate(term.StartDate) ?? asOf,
+            EndDate: toDate(term.EndDate) ?? asOf,
+        }
+        : grant.SubscriptionTermID
+            ? null
+            : undefined);
+    return {
+        ...evaluation,
+        Code: code,
+        GrantID: grant.ID,
+        Quantity: grant.Quantity,
+    };
+}
+/**
+ * Ask: does this person currently have this capability?
+ *
+ * Unknown person, ambiguous email, unknown code, and known-person-without-access share one
+ * response shape. Lookup faults fail closed the same way. Caller bugs (missing Code, bad
+ * UUID) throw `InvalidOperationInputError` so an integrator learns they sent garbage.
+ */
+export async function CheckPersonEntitlement(input, provider, user) {
+    const evaluatedAt = parseAsOf(input?.AsOf);
+    const code = requireCode(input?.Code);
+    RequireOptionalUUID(input?.PersonID ?? undefined, 'PersonID');
+    const companyID = RequireOptionalUUID(input?.CompanyID ?? undefined, 'CompanyID') || undefined;
+    if (!input?.PersonID && !normalizeEmail(input?.Email)) {
+        throw new InvalidOperationInputError('PersonID or Email is required.');
+    }
+    const closed = (reason) => {
+        LogStatus(`[ENTITLEMENT-CHECK] code=${code} decision=NoGrant hasAccess=false grant=- (${reason})`);
+        return closedCheck(evaluatedAt);
+    };
+    try {
+        const rv = new RunView(provider);
+        const personID = await resolvePersonID(rv, user, input.PersonID, input.Email);
+        if (!personID)
+            return closed('unresolved-person');
+        const templates = await runSimple(rv, user, PRODUCT_ENTITLEMENT_ENTITY, `Code = '${EscapeText(code)}'`, ['ID', 'ProductID', 'Code']);
+        if (!templates.ok)
+            return closed('template-lookup-failed');
+        let matching = templates.rows;
+        if (companyID && matching.length) {
+            const scoped = await filterTemplatesByCompany(rv, user, matching, companyID);
+            if (scoped == null)
+                return closed('company-lookup-failed');
+            matching = scoped;
+        }
+        if (!matching.length)
+            return closed('no-template');
+        const grants = await runSimple(rv, user, ENTITLEMENT_GRANT_ENTITY, `BeneficiaryPersonID = '${personID}' AND ProductEntitlementID IN (${quoteIds(matching.map((t) => t.ID), 'ProductEntitlementID')})`, [
+            'ID',
+            'ProductEntitlementID',
+            'Status',
+            'ValidFrom',
+            'ValidTo',
+            'Quantity',
+            'SubscriptionID',
+            'SubscriptionTermID',
+        ]);
+        if (!grants.ok)
+            return closed('grant-lookup-failed');
+        if (!grants.rows.length)
+            return closed('no-grant');
+        const ctx = await loadContext(rv, user, grants.rows);
+        if (!ctx.ok)
+            return closed('context-lookup-failed');
+        const codeByTemplate = new Map(matching.map((t) => [t.ID.toLowerCase(), t.Code]));
+        const evaluated = grants.rows.map((g) => evaluateGrant(g, evaluatedAt, codeByTemplate.get(g.ProductEntitlementID.toLowerCase()) ?? code, ctx.subs, ctx.terms));
+        const picked = PickWinningAccess(evaluated);
+        const out = toCheckOutput(evaluatedAt, picked);
+        LogStatus(`[ENTITLEMENT-CHECK] code=${code} decision=${out.Decision} hasAccess=${out.HasAccess} grant=${out.GrantID ?? '-'}`);
+        return out;
+    }
+    catch (err) {
+        if (err instanceof InvalidOperationInputError)
+            throw err;
+        LogError(`[ENTITLEMENT-CHECK] failed: ${err instanceof Error ? err.message : String(err)}`);
+        return closed('fault');
+    }
+}
+/**
+ * The person's library, one row per Code, each evaluated the same way as a point check.
+ * Empty when the person cannot be resolved — same non-leak as the check.
+ */
+export async function ListPersonEntitlements(input, provider, user) {
+    const evaluatedAt = parseAsOf(input?.AsOf);
+    RequireOptionalUUID(input?.PersonID ?? undefined, 'PersonID');
+    const companyID = RequireOptionalUUID(input?.CompanyID ?? undefined, 'CompanyID') || undefined;
+    const includeInactive = input?.IncludeInactive !== false;
+    if (!input?.PersonID && !normalizeEmail(input?.Email)) {
+        throw new InvalidOperationInputError('PersonID or Email is required.');
+    }
+    const empty = () => ({
+        EvaluatedAt: evaluatedAt.toISOString(),
+        Items: [],
+    });
+    try {
+        const rv = new RunView(provider);
+        const personID = await resolvePersonID(rv, user, input.PersonID, input.Email);
+        if (!personID) {
+            LogStatus('[ENTITLEMENT-LIST] person=- items=0 (unresolved-person)');
+            return empty();
+        }
+        const grants = await runSimple(rv, user, ENTITLEMENT_GRANT_ENTITY, `BeneficiaryPersonID = '${personID}'`, [
+            'ID',
+            'ProductEntitlementID',
+            'Status',
+            'ValidFrom',
+            'ValidTo',
+            'Quantity',
+            'SubscriptionID',
+            'SubscriptionTermID',
+        ]);
+        if (!grants.ok)
+            return empty();
+        if (!grants.rows.length) {
+            LogStatus(`[ENTITLEMENT-LIST] person=${personID} items=0`);
+            return empty();
+        }
+        const templateIDs = [...new Set(grants.rows.map((g) => g.ProductEntitlementID))];
+        const templates = await runSimple(rv, user, PRODUCT_ENTITLEMENT_ENTITY, `ID IN (${quoteIds(templateIDs, 'ProductEntitlementID')})`, ['ID', 'ProductID', 'Code']);
+        if (!templates.ok)
+            return empty();
+        let matching = templates.rows;
+        if (companyID && matching.length) {
+            const scoped = await filterTemplatesByCompany(rv, user, matching, companyID);
+            if (scoped == null)
+                return empty();
+            matching = scoped;
+        }
+        const templateByID = new Map(matching.map((t) => [t.ID.toLowerCase(), t]));
+        const inScope = grants.rows.filter((g) => templateByID.has(g.ProductEntitlementID.toLowerCase()));
+        if (!inScope.length) {
+            LogStatus(`[ENTITLEMENT-LIST] person=${personID} items=0`);
+            return empty();
+        }
+        const ctx = await loadContext(rv, user, inScope);
+        if (!ctx.ok)
+            return empty();
+        const evaluated = inScope.map((g) => {
+            const template = templateByID.get(g.ProductEntitlementID.toLowerCase());
+            return evaluateGrant(g, evaluatedAt, template.Code, ctx.subs, ctx.terms);
+        });
+        const byCode = new Map();
+        for (const row of evaluated) {
+            const list = byCode.get(row.Code) ?? [];
+            list.push(row);
+            byCode.set(row.Code, list);
+        }
+        const issuedAt = new Date();
+        const items = [...byCode.entries()]
+            .map(([code, group]) => {
+            const picked = PickWinningAccess(group);
+            return {
+                Code: code,
+                HasAccess: picked.HasAccess,
+                Decision: picked.Decision,
+                ValidFrom: toISO(picked.ValidFrom),
+                ValidTo: toISO(picked.ValidTo),
+                Quantity: picked.Quantity ?? undefined,
+                GrantID: picked.GrantID,
+                CacheUntil: CacheUntilFor(issuedAt, picked.ValidTo, picked.HasAccess).toISOString(),
+            };
+        })
+            .filter((item) => includeInactive || item.HasAccess)
+            .sort((a, b) => a.Code.localeCompare(b.Code));
+        LogStatus(`[ENTITLEMENT-LIST] person=${personID} items=${items.length}`);
+        return { EvaluatedAt: evaluatedAt.toISOString(), Items: items };
+    }
+    catch (err) {
+        if (err instanceof InvalidOperationInputError)
+            throw err;
+        LogError(`[ENTITLEMENT-LIST] failed: ${err instanceof Error ? err.message : String(err)}`);
+        return empty();
+    }
+}
+//# sourceMappingURL=EntitlementRead.js.map

package/dist/EntitlementRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntitlementRead.js","sourceRoot":"","sources":["../src/EntitlementRead.ts"],"names":[],"mappings":"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"}

package/dist/FulfillOrderLinesOperation.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview `Orders.FulfillOrderLines` — flip lines, and close the order when the last one goes.
+ *
+ * WHY ONE OPERATION AND NOT TWO. Marking lines shipped and advancing the order are the same
+ * decision. Split across two calls there is a window in which every line is Fulfilled and the order
+ * still reads Posted — which a warehouse experiences as the system losing its work, and which a
+ * second caller can widen indefinitely by never making the second call.
+ *
+ * THE ADVANCE RULE, and the mistake it avoids. An order advances when nothing is AWAITING
+ * fulfilment — not when every line is Fulfilled. On a mixed order the subscription line never flips,
+ * because it has nothing to flip, so the stricter test would hold that order open forever while the
+ * warehouse insists it shipped everything. Only lines that CAN be fulfilled are allowed to hold it.
+ *
+ * NO JOURNAL ENTRY FIRES (D15). Fulfilment is a logistics fact; revenue was settled at booking and
+ * releases on its own schedule. Coupling them would let a warehouse delay restate a closed period.
+ *
+ * A REFUSAL IS DATA, NOT AN ERROR. Scanning an already-shipped item is an ordinary mistake, so
+ * refusals come back per line with reasons and the rest of the batch still lands — a picker who
+ * scans one wrong item should not lose nine good scans. `AllOrNothing` is there for callers that
+ * want the opposite.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { OrdersFulfillOrderLinesOperation as OrdersFulfillOrderLinesOperationBase, type OrdersFulfillOrderLinesInput, type OrdersFulfillOrderLinesOutput } from '@mj-biz-apps/orders-entities';
+export declare class FulfillOrderLinesOperation extends OrdersFulfillOrderLinesOperationBase {
+    protected InternalExecute(input: OrdersFulfillOrderLinesInput, provider: IMetadataProvider, user: UserInfo): Promise<OrdersFulfillOrderLinesOutput>;
+    /** product id → does its type require fulfilment. Two queries, not one per line. */
+    private buildRequiresFulfillment;
+    private refuseAll;
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export declare function LoadFulfillOrderLinesOperation(): void;
+//# sourceMappingURL=FulfillOrderLinesOperation.d.ts.map

package/dist/FulfillOrderLinesOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FulfillOrderLinesOperation.d.ts","sourceRoot":"","sources":["../src/FulfillOrderLinesOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAIH,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EAChB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACH,gCAAgC,IAAI,oCAAoC,EACxE,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAGrC,MAAM,8BAA8B,CAAC;AAkBtC,qBACa,0BAA2B,SAAQ,oCAAoC;cAChE,eAAe,CAC3B,KAAK,EAAE,4BAA4B,EACnC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,6BAA6B,CAAC;IAiLzC,oFAAoF;YACtE,wBAAwB;IA0BtC,OAAO,CAAC,SAAS;CAWpB;AAED,0FAA0F;AAC1F,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/FulfillOrderLinesOperation.js

@@ -0,0 +1,208 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview `Orders.FulfillOrderLines` — flip lines, and close the order when the last one goes.
+ *
+ * WHY ONE OPERATION AND NOT TWO. Marking lines shipped and advancing the order are the same
+ * decision. Split across two calls there is a window in which every line is Fulfilled and the order
+ * still reads Posted — which a warehouse experiences as the system losing its work, and which a
+ * second caller can widen indefinitely by never making the second call.
+ *
+ * THE ADVANCE RULE, and the mistake it avoids. An order advances when nothing is AWAITING
+ * fulfilment — not when every line is Fulfilled. On a mixed order the subscription line never flips,
+ * because it has nothing to flip, so the stricter test would hold that order open forever while the
+ * warehouse insists it shipped everything. Only lines that CAN be fulfilled are allowed to hold it.
+ *
+ * NO JOURNAL ENTRY FIRES (D15). Fulfilment is a logistics fact; revenue was settled at booking and
+ * releases on its own schedule. Coupling them would let a warehouse delay restate a closed period.
+ *
+ * A REFUSAL IS DATA, NOT AN ERROR. Scanning an already-shipped item is an ordinary mistake, so
+ * refusals come back per line with reasons and the rest of the batch still lands — a picker who
+ * scans one wrong item should not lose nine good scans. `AllOrNothing` is there for callers that
+ * want the opposite.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { BaseRemotableOperation, RunView, } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { OrdersFulfillOrderLinesOperation as OrdersFulfillOrderLinesOperationBase, } from '@mj-biz-apps/orders-entities';
+import { ExplainRefusal, RefuseFlip, ShouldAdvanceToFulfilled, } from './FulfillmentBehavior.js';
+import { RequireUUID } from './sql-guards.js';
+const ORDER_HEADER_ENTITY = 'MJ_BizApps_Orders: Order Headers';
+const ORDER_LINE_ENTITY = 'MJ_BizApps_Orders: Order Lines';
+const PRODUCT_ENTITY = 'MJ_BizApps_Orders: Products';
+const PRODUCT_TYPE_ENTITY = 'MJ_BizApps_Orders: Product Types';
+const key = (id) => (id ?? '').toLowerCase();
+const quote = (ids) => [...new Set(ids.map((i) => `'${RequireUUID(i, 'OrderLineID')}'`))].join(',');
+let FulfillOrderLinesOperation = class FulfillOrderLinesOperation extends OrdersFulfillOrderLinesOperationBase {
+    async InternalExecute(input, provider, user) {
+        const requested = [...new Set((input?.OrderLineIDs ?? []).filter(Boolean))];
+        if (!requested.length) {
+            return this.refuseAll('No order lines were given to fulfil.');
+        }
+        const rv = new RunView(provider);
+        const lines = await rv.RunView({ EntityName: ORDER_LINE_ENTITY, ExtraFilter: `ID IN (${quote(requested)})`, ResultType: 'simple' }, user);
+        const lineRows = lines.Results ?? [];
+        // Every order the requested lines belong to — plus, crucially, ALL of those orders' lines,
+        // because deciding whether an order may advance needs its whole picture, not just the lines
+        // in this batch.
+        const orderIDs = [...new Set(lineRows.map((l) => l.OrderHeaderID))];
+        const orders = orderIDs.length
+            ? await rv.RunView({ EntityName: ORDER_HEADER_ENTITY, ExtraFilter: `ID IN (${quote(orderIDs)})`, ResultType: 'simple' }, user)
+            : { Results: [] };
+        const orderByID = new Map((orders.Results ?? []).map((o) => [key(o.ID), o]));
+        const allLines = orderIDs.length
+            ? await rv.RunView({
+                EntityName: ORDER_LINE_ENTITY,
+                ExtraFilter: `OrderHeaderID IN (${quote(orderIDs)})`,
+                ResultType: 'simple',
+            }, user)
+            : { Results: [] };
+        const allLineRows = allLines.Results ?? [];
+        const requiresFulfillment = await this.buildRequiresFulfillment(rv, allLineRows, user);
+        const shape = (l) => ({
+            ID: l.ID,
+            RequiresFulfillment: requiresFulfillment(l.ProductID),
+            FulfillmentStatus: l.FulfillmentStatus ?? null,
+            ReversesOrderLineID: l.ReversesOrderLineID,
+            IsRollupParent: !!l.IsRollupParent,
+        });
+        // ── DECIDE FIRST, WRITE SECOND ──
+        // With AllOrNothing the caller expects nothing to move if anything is refused, so every
+        // decision has to be made before the first write.
+        const byID = new Map(lineRows.map((l) => [key(l.ID), l]));
+        const decisions = requested.map((id) => {
+            const row = byID.get(key(id));
+            const order = row ? orderByID.get(key(row.OrderHeaderID)) : undefined;
+            const refusal = RefuseFlip(row ? shape(row) : null, order?.Status ?? '');
+            return refusal
+                ? { OrderLineID: id, Fulfilled: false, Refusal: refusal, RefusalReason: ExplainRefusal(refusal, id) }
+                : { OrderLineID: id, Fulfilled: true, Refusal: null, RefusalReason: null };
+        });
+        const refused = decisions.filter((d) => !d.Fulfilled);
+        if (input?.AllOrNothing && refused.length) {
+            return {
+                Success: false,
+                Message: `Refused: ${refused.length} of ${requested.length} line(s) cannot be fulfilled, and ` +
+                    `AllOrNothing was set, so nothing was changed. First reason: ${refused[0].RefusalReason}`,
+                Lines: decisions.map((d) => ({ ...d, Fulfilled: false })),
+                Orders: [],
+                FulfilledCount: 0,
+                RefusedCount: refused.length,
+                AdvancedCount: 0,
+            };
+        }
+        // ── WRITE ──
+        const flipped = new Set();
+        for (const decision of decisions.filter((d) => d.Fulfilled)) {
+            const entity = await provider.GetEntityObject(ORDER_LINE_ENTITY, user);
+            const loaded = await entity.Load(decision.OrderLineID);
+            if (!loaded) {
+                decision.Fulfilled = false;
+                decision.Refusal = 'LineNotFound';
+                decision.RefusalReason = ExplainRefusal('LineNotFound', decision.OrderLineID);
+                continue;
+            }
+            entity.FulfillmentStatus = 'Fulfilled';
+            if (!(await entity.Save())) {
+                // FulfillmentStatus is the ONE line column the immutability trigger lets a fulfiller
+                // change on a Confirmed order (the D15 carve-out). A refusal here means something
+                // else objected, and the caller needs the reason rather than a silent skip.
+                decision.Fulfilled = false;
+                decision.Refusal = 'SaveFailed';
+                decision.RefusalReason =
+                    `Order line ${decision.OrderLineID} could not be marked Fulfilled: ` +
+                        `${entity.LatestResult?.CompleteMessage ?? 'no reason given'}`;
+                continue;
+            }
+            flipped.add(key(decision.OrderLineID));
+        }
+        // ── ADVANCE the orders whose last fulfillable line just went ──
+        const advanced = [];
+        for (const orderID of orderIDs) {
+            const order = orderByID.get(key(orderID));
+            if (!order)
+                continue;
+            const after = allLineRows
+                .filter((l) => key(l.OrderHeaderID) === key(orderID))
+                .map((l) => (flipped.has(key(l.ID)) ? { ...l, FulfillmentStatus: 'Fulfilled' } : l))
+                .map(shape);
+            const remaining = after.filter((l) => l.RequiresFulfillment &&
+                !l.ReversesOrderLineID &&
+                !l.IsRollupParent &&
+                (l.FulfillmentStatus ?? 'Pending') === 'Pending').length;
+            let statusAfter = order.FulfillmentStatus ?? 'Pending';
+            let didAdvance = false;
+            if (ShouldAdvanceToFulfilled(after) && order.FulfillmentStatus !== 'Fulfilled') {
+                const header = await provider.GetEntityObject(ORDER_HEADER_ENTITY, user);
+                if (await header.Load(orderID)) {
+                    header.FulfillmentStatus = 'Fulfilled';
+                    if (await header.Save()) {
+                        didAdvance = true;
+                        statusAfter = 'Fulfilled';
+                    }
+                }
+            }
+            advanced.push({
+                OrderHeaderID: orderID,
+                OrderNumber: order.OrderNumber,
+                StatusBefore: order.FulfillmentStatus ?? 'Pending',
+                StatusAfter: statusAfter,
+                AdvancedToFulfilled: didAdvance || remaining === 0,
+                RemainingLineCount: remaining,
+            });
+        }
+        const fulfilledCount = decisions.filter((d) => d.Fulfilled).length;
+        const refusedCount = decisions.length - fulfilledCount;
+        return {
+            Success: true,
+            Message: refusedCount > 0
+                ? `${fulfilledCount} line(s) fulfilled, ${refusedCount} refused. See Lines for reasons.`
+                : undefined,
+            Lines: decisions,
+            Orders: advanced,
+            FulfilledCount: fulfilledCount,
+            RefusedCount: refusedCount,
+            AdvancedCount: advanced.filter((a) => a.AdvancedToFulfilled).length,
+        };
+    }
+    /** product id → does its type require fulfilment. Two queries, not one per line. */
+    async buildRequiresFulfillment(rv, lines, user) {
+        const productIDs = [...new Set(lines.map((l) => l.ProductID))].filter(Boolean);
+        if (!productIDs.length)
+            return () => false;
+        const products = await rv.RunView({ EntityName: PRODUCT_ENTITY, ExtraFilter: `ID IN (${quote(productIDs)})`, ResultType: 'simple' }, user);
+        const rows = products.Results ?? [];
+        const typeIDs = [...new Set(rows.map((p) => p.ProductTypeID))].filter(Boolean);
+        if (!typeIDs.length)
+            return () => false;
+        const types = await rv.RunView({ EntityName: PRODUCT_TYPE_ENTITY, ExtraFilter: `ID IN (${quote(typeIDs)})`, ResultType: 'simple' }, user);
+        const requiresByType = new Map((types.Results ?? []).map((t) => [key(t.ID), !!t.RequiresFulfillment]));
+        const typeByProduct = new Map(rows.map((p) => [key(p.ID), key(p.ProductTypeID)]));
+        return (productID) => requiresByType.get(typeByProduct.get(key(productID)) ?? '') ?? false;
+    }
+    refuseAll(message) {
+        return {
+            Success: false,
+            Message: message,
+            Lines: [],
+            Orders: [],
+            FulfilledCount: 0,
+            RefusedCount: 0,
+            AdvancedCount: 0,
+        };
+    }
+};
+FulfillOrderLinesOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.FulfillOrderLines')
+], FulfillOrderLinesOperation);
+export { FulfillOrderLinesOperation };
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadFulfillOrderLinesOperation() {
+    // intentionally empty
+}
+//# sourceMappingURL=FulfillOrderLinesOperation.js.map