@tinkerlandai/longplay-sdk 0.10.18 → 0.10.19

package/dist/{funnel-node-evaluation-BLnJp8vj.d.ts → funnel-node-evaluation-D9FwkMa3.d.ts}

@@ -1,6 +1,18 @@
 import { z } from 'zod';
 import { E as EvaluationContext, J as JsonValue } from './growth-rules-B4YYy64R.js';
 
+declare const commerceSubjectSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        projectId: z.ZodUUID;
+        environmentId: z.ZodUUID;
+        environment: z.ZodEnum<{
+            sandbox: "sandbox";
+            live: "live";
+        }>;
+    }, z.core.$strict>;
+    customerId: z.ZodUUID;
+}, z.core.$strict>;
+
 declare const merchantBridgeCommandSchema: z.ZodEnum<{
     "session.create": "session.create";
     "catalog.read": "catalog.read";
@@ -46,6 +58,7 @@ declare const merchantBridgeManifestSchema: z.ZodObject<{
         "subscription.observed": "subscription.observed";
         "invoice.paid": "invoice.paid";
         "subscription.change.completed": "subscription.change.completed";
+        "subscription.change.closed": "subscription.change.closed";
         "refund.updated": "refund.updated";
     }>>;
     profiles: z.ZodArray<z.ZodEnum<{
@@ -272,6 +285,173 @@ declare const merchantBridgeOperationAuthoritySchema: z.ZodObject<{
         currency: z.ZodString;
         expiresAt: z.ZodISODateTime;
     }, z.core.$strict>], "type">;
+    merchantTerms: z.ZodOptional<z.ZodObject<{
+        request: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodLiteral<"purchase">;
+            mode: z.ZodEnum<{
+                payment: "payment";
+                subscription: "subscription";
+            }>;
+            currency: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+                merchantProductId: z.ZodString;
+                merchantPriceId: z.ZodString;
+                productVersionId: z.ZodOptional<z.ZodUUID>;
+                quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            }, z.core.$strict>>;
+            offerRefs: z.ZodArray<z.ZodString>;
+            subject: z.ZodObject<{
+                scope: z.ZodObject<{
+                    projectId: z.ZodUUID;
+                    environmentId: z.ZodUUID;
+                    environment: z.ZodEnum<{
+                        sandbox: "sandbox";
+                        live: "live";
+                    }>;
+                }, z.core.$strict>;
+                customerId: z.ZodUUID;
+            }, z.core.$strict>;
+            operationId: z.ZodUUID;
+            configurationRevision: z.ZodNumber;
+            connectionRevision: z.ZodNumber;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strict>, z.ZodObject<{
+            action: z.ZodLiteral<"subscription_change">;
+            currency: z.ZodString;
+            merchantSubscriptionId: z.ZodString;
+            change: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"cancel">;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"uncancel">;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"plan">;
+                productVersionId: z.ZodUUID;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"seats">;
+                licenseKey: z.ZodString;
+                quantity: z.ZodNumber;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"quantity">;
+                internal_feature_id: z.ZodUUID;
+                quantity: z.ZodNumber;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"billing_cycle">;
+                billingCycleAnchor: z.ZodUnion<readonly [z.ZodLiteral<"now">, z.ZodNumber]>;
+            }, z.core.$strict>], "type">;
+            timing: z.ZodEnum<{
+                immediate: "immediate";
+                renewal: "renewal";
+            }>;
+            proration: z.ZodEnum<{
+                none: "none";
+                create_prorations: "create_prorations";
+                always_invoice: "always_invoice";
+            }>;
+            offerRefs: z.ZodArray<z.ZodString>;
+            subject: z.ZodObject<{
+                scope: z.ZodObject<{
+                    projectId: z.ZodUUID;
+                    environmentId: z.ZodUUID;
+                    environment: z.ZodEnum<{
+                        sandbox: "sandbox";
+                        live: "live";
+                    }>;
+                }, z.core.$strict>;
+                customerId: z.ZodUUID;
+            }, z.core.$strict>;
+            operationId: z.ZodUUID;
+            configurationRevision: z.ZodNumber;
+            connectionRevision: z.ZodNumber;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strict>, z.ZodObject<{
+            action: z.ZodLiteral<"refund">;
+            currency: z.ZodString;
+            merchantInvoiceId: z.ZodString;
+            mode: z.ZodEnum<{
+                full: "full";
+                partial: "partial";
+            }>;
+            amountMinor: z.ZodOptional<z.ZodNumber>;
+            entitlementAction: z.ZodEnum<{
+                retain: "retain";
+                revoke: "revoke";
+            }>;
+            subject: z.ZodObject<{
+                scope: z.ZodObject<{
+                    projectId: z.ZodUUID;
+                    environmentId: z.ZodUUID;
+                    environment: z.ZodEnum<{
+                        sandbox: "sandbox";
+                        live: "live";
+                    }>;
+                }, z.core.$strict>;
+                customerId: z.ZodUUID;
+            }, z.core.$strict>;
+            operationId: z.ZodUUID;
+            configurationRevision: z.ZodNumber;
+            connectionRevision: z.ZodNumber;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strict>], "action">;
+        requestDigest: z.ZodString;
+        merchantQuoteId: z.ZodString;
+        quoteTermsDigest: z.ZodString;
+        termsVersion: z.ZodString;
+        sourceRevisions: z.ZodArray<z.ZodObject<{
+            reference: z.ZodString;
+            revision: z.ZodString;
+        }, z.core.$strict>>;
+        observedAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+        currency: z.ZodString;
+        automaticTax: z.ZodBoolean;
+        lines: z.ZodArray<z.ZodObject<{
+            merchantLineId: z.ZodString;
+            merchantPriceId: z.ZodNullable<z.ZodString>;
+            quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            subtotalMinor: z.ZodNumber;
+            discountMinor: z.ZodNumber;
+            taxMinor: z.ZodNullable<z.ZodNumber>;
+            totalMinor: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+        subscriptionTerms: z.ZodNullable<z.ZodObject<{
+            items: z.ZodArray<z.ZodObject<{
+                merchantPriceId: z.ZodString;
+                quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+                interval: z.ZodEnum<{
+                    week: "week";
+                    month: "month";
+                    year: "year";
+                }>;
+                intervalCount: z.ZodNumber;
+                amountMinor: z.ZodNumber;
+            }, z.core.$strict>>;
+            trial: z.ZodNullable<z.ZodObject<{
+                days: z.ZodNumber;
+                cardRequired: z.ZodBoolean;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        subtotalMinor: z.ZodNumber;
+        discountMinor: z.ZodNumber;
+        taxMinor: z.ZodNullable<z.ZodNumber>;
+        totalMinor: z.ZodNullable<z.ZodNumber>;
+        effectiveAt: z.ZodNullable<z.ZodISODateTime>;
+        expectedEffects: z.ZodArray<z.ZodObject<{
+            reference: z.ZodString;
+            kind: z.ZodEnum<{
+                change: "change";
+                revoke: "revoke";
+                grant: "grant";
+            }>;
+            description: z.ZodString;
+            quantity: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+            unit: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        requiredConsents: z.ZodArray<z.ZodObject<{
+            reference: z.ZodString;
+            version: z.ZodString;
+            summary: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const merchantBridgeCommandInputs: {
     readonly "bridge.ping": z.ZodObject<{
@@ -338,6 +518,7 @@ declare const merchantBridgeCommandOutputs: {
             "subscription.observed": "subscription.observed";
             "invoice.paid": "invoice.paid";
             "subscription.change.completed": "subscription.change.completed";
+            "subscription.change.closed": "subscription.change.closed";
             "refund.updated": "refund.updated";
         }>>;
         profiles: z.ZodArray<z.ZodEnum<{
@@ -2077,6 +2258,249 @@ declare const funnelLocalConfigurationSchema: z.ZodObject<{
 }, z.core.$strict>;
 type FunnelLocalConfiguration = z.infer<typeof funnelLocalConfigurationSchema>;
 
+/** A check observes access. Consumption and reservations remain explicit server operations. */
+declare const entitlementRequirementSchema: z.ZodObject<{
+    internal_feature_id: z.ZodUUID;
+    quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    properties: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodTransform<{
+        [k: string]: string;
+    }, Record<string, string | number | boolean>>>;
+    entityId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strict>;
+declare function entitlementRequirementDigest(subject: z.input<typeof commerceSubjectSchema>, requirement: z.input<typeof entitlementRequirementSchema>): string;
+declare const entitlementCheckResultSchema: z.ZodObject<{
+    internal_feature_id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        access: "access";
+        metered: "metered";
+        credit: "credit";
+    }>;
+    quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    allowed: z.ZodBoolean;
+    observation: z.ZodOptional<z.ZodObject<{
+        subject: z.ZodObject<{
+            scope: z.ZodObject<{
+                projectId: z.ZodUUID;
+                environmentId: z.ZodUUID;
+                environment: z.ZodEnum<{
+                    sandbox: "sandbox";
+                    live: "live";
+                }>;
+            }, z.core.$strict>;
+            customerId: z.ZodUUID;
+        }, z.core.$strict>;
+        authority: z.ZodEnum<{
+            longplay: "longplay";
+            merchant: "merchant";
+        }>;
+        observedAt: z.ZodISODateTime;
+        sourceRevision: z.ZodString;
+        requirementDigest: z.ZodString;
+    }, z.core.$strict>>;
+    reason: z.ZodNullable<z.ZodEnum<{
+        not_entitled: "not_entitled";
+        insufficient_balance: "insufficient_balance";
+        capacity_exceeded: "capacity_exceeded";
+        limit_exceeded: "limit_exceeded";
+        awaiting_topup: "awaiting_topup";
+        authorization_required: "authorization_required";
+        payment_blocked: "payment_blocked";
+        cash_budget_exceeded: "cash_budget_exceeded";
+        unavailable: "unavailable";
+        authentication_required: "authentication_required";
+    }>>;
+    preview: z.ZodNullable<z.ZodObject<{
+        scenario: z.ZodEnum<{
+            feature_flag: "feature_flag";
+            usage_limit: "usage_limit";
+        }>;
+        candidates: z.ZodArray<z.ZodObject<{
+            productId: z.ZodString;
+            productVersionId: z.ZodString;
+            name: z.ZodString;
+            action: z.ZodEnum<{
+                purchase: "purchase";
+                upgrade: "upgrade";
+                addon: "addon";
+                topup: "topup";
+            }>;
+            membershipId: z.ZodNullable<z.ZodString>;
+            currency: z.ZodEnum<{
+                USD: "USD";
+                EUR: "EUR";
+                CNY: "CNY";
+                GBP: "GBP";
+                JPY: "JPY";
+                CAD: "CAD";
+                AUD: "AUD";
+                NZD: "NZD";
+                CHF: "CHF";
+                HKD: "HKD";
+                SGD: "SGD";
+                KRW: "KRW";
+                INR: "INR";
+                BRL: "BRL";
+                MXN: "MXN";
+                TWD: "TWD";
+                THB: "THB";
+                IDR: "IDR";
+                MYR: "MYR";
+                PHP: "PHP";
+                VND: "VND";
+                ZAR: "ZAR";
+                AED: "AED";
+                SAR: "SAR";
+                SEK: "SEK";
+                NOK: "NOK";
+                DKK: "DKK";
+                PLN: "PLN";
+                CZK: "CZK";
+                HUF: "HUF";
+                ILS: "ILS";
+                TRY: "TRY";
+                RON: "RON";
+            }>;
+            amountMinor: z.ZodString;
+            interval: z.ZodEnum<{
+                free: "free";
+                week: "week";
+                month: "month";
+                year: "year";
+                one_time: "one_time";
+            }>;
+            intervalCount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type EntitlementCheckResult = z.infer<typeof entitlementCheckResultSchema>;
+/** Admission for a merchant observation reuses the common Check result. */
+declare const merchantRequirementCheckInputSchema: z.ZodObject<{
+    subject: z.ZodObject<{
+        scope: z.ZodObject<{
+            projectId: z.ZodUUID;
+            environmentId: z.ZodUUID;
+            environment: z.ZodEnum<{
+                sandbox: "sandbox";
+                live: "live";
+            }>;
+        }, z.core.$strict>;
+        customerId: z.ZodUUID;
+    }, z.core.$strict>;
+    requirement: z.ZodObject<{
+        internal_feature_id: z.ZodUUID;
+        quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        properties: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>, z.ZodTransform<{
+            [k: string]: string;
+        }, Record<string, string | number | boolean>>>;
+        entityId: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const merchantRequirementCheckResultSchema: z.ZodObject<{
+    internal_feature_id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        access: "access";
+        metered: "metered";
+        credit: "credit";
+    }>;
+    quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    allowed: z.ZodBoolean;
+    reason: z.ZodNullable<z.ZodEnum<{
+        not_entitled: "not_entitled";
+        insufficient_balance: "insufficient_balance";
+        capacity_exceeded: "capacity_exceeded";
+        limit_exceeded: "limit_exceeded";
+        awaiting_topup: "awaiting_topup";
+        authorization_required: "authorization_required";
+        payment_blocked: "payment_blocked";
+        cash_budget_exceeded: "cash_budget_exceeded";
+        unavailable: "unavailable";
+        authentication_required: "authentication_required";
+    }>>;
+    preview: z.ZodNullable<z.ZodObject<{
+        scenario: z.ZodEnum<{
+            feature_flag: "feature_flag";
+            usage_limit: "usage_limit";
+        }>;
+        candidates: z.ZodArray<z.ZodObject<{
+            productId: z.ZodString;
+            productVersionId: z.ZodString;
+            name: z.ZodString;
+            action: z.ZodEnum<{
+                purchase: "purchase";
+                upgrade: "upgrade";
+                addon: "addon";
+                topup: "topup";
+            }>;
+            membershipId: z.ZodNullable<z.ZodString>;
+            currency: z.ZodEnum<{
+                USD: "USD";
+                EUR: "EUR";
+                CNY: "CNY";
+                GBP: "GBP";
+                JPY: "JPY";
+                CAD: "CAD";
+                AUD: "AUD";
+                NZD: "NZD";
+                CHF: "CHF";
+                HKD: "HKD";
+                SGD: "SGD";
+                KRW: "KRW";
+                INR: "INR";
+                BRL: "BRL";
+                MXN: "MXN";
+                TWD: "TWD";
+                THB: "THB";
+                IDR: "IDR";
+                MYR: "MYR";
+                PHP: "PHP";
+                VND: "VND";
+                ZAR: "ZAR";
+                AED: "AED";
+                SAR: "SAR";
+                SEK: "SEK";
+                NOK: "NOK";
+                DKK: "DKK";
+                PLN: "PLN";
+                CZK: "CZK";
+                HUF: "HUF";
+                ILS: "ILS";
+                TRY: "TRY";
+                RON: "RON";
+            }>;
+            amountMinor: z.ZodString;
+            interval: z.ZodEnum<{
+                free: "free";
+                week: "week";
+                month: "month";
+                year: "year";
+                one_time: "one_time";
+            }>;
+            intervalCount: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    observation: z.ZodObject<{
+        subject: z.ZodObject<{
+            scope: z.ZodObject<{
+                projectId: z.ZodUUID;
+                environmentId: z.ZodUUID;
+                environment: z.ZodEnum<{
+                    sandbox: "sandbox";
+                    live: "live";
+                }>;
+            }, z.core.$strict>;
+            customerId: z.ZodUUID;
+        }, z.core.$strict>;
+        observedAt: z.ZodISODateTime;
+        sourceRevision: z.ZodString;
+        requirementDigest: z.ZodString;
+        authority: z.ZodLiteral<"merchant">;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type MerchantRequirementCheckInput = z.input<typeof merchantRequirementCheckInputSchema>;
+type MerchantRequirementCheckResult = z.infer<typeof merchantRequirementCheckResultSchema>;
+
 type FunnelNodeEvaluationContext = Pick<EvaluationContext, "attributes" | "stickyBucketAssignmentDocs" | "saveStickyBucketAssignmentDoc" | "onFeatureUsage" | "onExperimentViewed">;
 
 /** Pure rule evaluation, never a command or permission to perform a commercial action. No network I/O. */
@@ -2087,4 +2511,4 @@ declare function evaluateFunnelNode(configuration: FunnelConfiguration, nodeId:
     value?: JsonValue;
 };
 
-export { type FunnelNodeEvaluationContext as F, type MerchantBridgeManifest as M, type FunnelLocalConfiguration as a, type MerchantBridgeCommand as b, type MerchantBridgeRequest as c, merchantBridgeCommandInputs as d, evaluateFunnelNode as e, merchantBridgeCommandOutputs as f, merchantBridgeOperationInputSchema as g, merchantBridgeOperationAuthoritySchema as m };
+export { type EntitlementCheckResult as E, type FunnelNodeEvaluationContext as F, type MerchantBridgeManifest as M, type FunnelLocalConfiguration as a, type MerchantBridgeCommand as b, type MerchantBridgeRequest as c, merchantBridgeCommandInputs as d, evaluateFunnelNode as e, merchantBridgeCommandOutputs as f, merchantBridgeOperationInputSchema as g, type MerchantRequirementCheckInput as h, type MerchantRequirementCheckResult as i, entitlementRequirementDigest as j, merchantBridgeOperationAuthoritySchema as m };