@shdan/submesh-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Submesh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @shdan/submesh-core
+
+Core domain model and policy utilities for Submesh.
+
+Use this package when you want:
+
+- shared Submesh types
+- plugin contracts
+- access policy evaluation without the full SDK client
+
+## Install
+
+```bash
+npm install @shdan/submesh-core
+```
+
+## Evaluate access directly
+
+```ts
+import { evaluateEntitlementAccess } from "@shdan/submesh-core";
+
+const decision = evaluateEntitlementAccess(subscriptionsWithPlan, "feature:export");
+console.log(decision.allowed, decision.reason);
+```
+
+`AccessDecision.reason` values:
+
+- `subscription_found`
+- `no_entitlement_match`
+- `no_active_subscription`
+- `subject_not_found`
+
+## Package purpose
+
+Most apps should use `@shdan/submesh` directly.
+
+Use `@shdan/submesh-core` when you need low-level contracts and policy behavior in custom pipelines.

package/dist/domain/access.d.ts

@@ -0,0 +1,8 @@
+export interface AccessDecision {
+    allowed: boolean;
+    reason: "subscription_found" | "no_entitlement_match" | "no_active_subscription" | "subject_not_found";
+    subscriptionId?: string;
+    planCode?: string;
+    matchedEntitlement?: string;
+}
+//# sourceMappingURL=access.d.ts.map

package/dist/domain/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/domain/access.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EACF,oBAAoB,GACpB,sBAAsB,GACtB,wBAAwB,GACxB,mBAAmB,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/domain/access.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=access.js.map

package/dist/domain/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/domain/access.ts"],"names":[],"mappings":""}

package/dist/domain/event.d.ts

@@ -0,0 +1,34 @@
+export interface PluginInstallation {
+    id: string;
+    pluginKey: string;
+    displayName: string;
+    enabled: boolean;
+    config: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export type InboundEventStatus = "received" | "processed" | "ignored" | "failed";
+export interface InboundEvent {
+    id: string;
+    pluginKey: string;
+    eventKey: string;
+    eventType: string;
+    sourceRef?: string | null;
+    payload: Record<string, unknown>;
+    status: InboundEventStatus;
+    processedCount: number;
+    errorMessage?: string | null;
+    processedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DashboardSummary {
+    subjects: number;
+    plans: number;
+    subscriptions: number;
+    activeSubscriptions: number;
+    pluginsInstalled: number;
+    catalogMappings: number;
+    processedEvents: number;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/domain/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/domain/event.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/domain/event.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event.js.map

package/dist/domain/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/domain/event.ts"],"names":[],"mappings":""}

package/dist/domain/plan.d.ts

@@ -0,0 +1,24 @@
+export type PlanInterval = "day" | "week" | "month" | "year" | "custom";
+export interface Plan {
+    id: string;
+    code: string;
+    name: string;
+    description?: string | null;
+    interval: PlanInterval;
+    priceAmount: number;
+    currency: string;
+    entitlements: string[];
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CatalogMapping {
+    id: string;
+    pluginKey: string;
+    externalProductId: string;
+    planCode: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=plan.d.ts.map

package/dist/domain/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/domain/plan.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/domain/plan.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan.js.map

package/dist/domain/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/domain/plan.ts"],"names":[],"mappings":""}

package/dist/domain/plugin.d.ts

@@ -0,0 +1,19 @@
+import type { CanonicalSubscriptionInput } from "./subscription.js";
+export interface PluginWebhookEnvelope {
+    body: unknown;
+    headers: Record<string, string | string[] | undefined>;
+    receivedAt: string;
+    rawBody?: string | Uint8Array;
+}
+export interface ParsedWebhookEvent {
+    eventKey: string;
+    eventType: string;
+    sourceRef?: string | null;
+    records: CanonicalSubscriptionInput[];
+}
+export interface PluginWebhookVerification {
+    verified: boolean;
+    strategy: "none" | "relay-hmac" | "custom";
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/domain/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/domain/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/domain/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/domain/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/domain/plugin.ts"],"names":[],"mappings":""}

package/dist/domain/subject.d.ts

@@ -0,0 +1,22 @@
+export interface Subject {
+    id: string;
+    email?: string | null;
+    name?: string | null;
+    externalRef?: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SubjectIdentity {
+    id: string;
+    subjectId: string;
+    provider: string;
+    externalId: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+/** Alias for {@link Subject}. Use when your domain prefers the term "customer". */
+export type Customer = Subject;
+/** Alias for {@link SubjectIdentity}. Use when your domain prefers the term "customer". */
+export type CustomerIdentity = SubjectIdentity;
+//# sourceMappingURL=subject.d.ts.map

package/dist/domain/subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../src/domain/subject.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAC/B,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC"}

package/dist/domain/subject.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subject.js.map

package/dist/domain/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../src/domain/subject.ts"],"names":[],"mappings":""}

package/dist/domain/subscription.d.ts

@@ -0,0 +1,44 @@
+import type { Plan } from "./plan.js";
+export type SubscriptionStatus = "trialing" | "active" | "grace_period" | "billing_issue" | "paused" | "canceled" | "expired" | "refunded" | "revoked";
+export interface Subscription {
+    id: string;
+    subjectId: string;
+    planId: string;
+    pluginKey: string;
+    sourceType: string;
+    sourceRef: string;
+    status: SubscriptionStatus;
+    currentPeriodStart?: string | null;
+    currentPeriodEnd?: string | null;
+    trialEndAt?: string | null;
+    cancelAt?: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SubscriptionWithPlan extends Subscription {
+    plan: Plan;
+}
+export interface CanonicalSubscriptionInput {
+    pluginKey: string;
+    sourceType: string;
+    sourceRef: string;
+    status: SubscriptionStatus;
+    subjectId?: string;
+    externalSubjectId?: string;
+    externalCustomerId?: string;
+    planCode?: string;
+    externalProductId?: string;
+    subject?: {
+        email?: string | null;
+        name?: string | null;
+        externalRef?: string | null;
+        metadata?: Record<string, unknown>;
+    };
+    currentPeriodStart?: string | null;
+    currentPeriodEnd?: string | null;
+    trialEndAt?: string | null;
+    cancelAt?: string | null;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/domain/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/domain/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,QAAQ,GACR,cAAc,GACd,eAAe,GACf,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/domain/subscription.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subscription.js.map

package/dist/domain/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/domain/subscription.ts"],"names":[],"mappings":""}

package/dist/evaluate-entitlement-access.d.ts

@@ -0,0 +1,21 @@
+import type { AccessDecision } from "./domain/access.js";
+import type { SubscriptionWithPlan } from "./domain/subscription.js";
+export interface EntitlementEvaluationOptions {
+    /**
+     * When true, subscriptions whose `currentPeriodEnd` is in the past are
+     * treated as expired regardless of their `status` field. Useful as a
+     * safety net for missed provider webhooks.
+     *
+     * @default false
+     */
+    checkPeriodEnd?: boolean;
+}
+/**
+ * Evaluates whether any active subscription grants the requested entitlement.
+ */
+export declare function evaluateEntitlementAccess(subscriptions: SubscriptionWithPlan[], entitlement: string, options?: EntitlementEvaluationOptions): AccessDecision;
+/**
+ * Returns all entitlements granted by active subscriptions for a subject.
+ */
+export declare function collectGrantedEntitlements(subscriptions: SubscriptionWithPlan[], options?: EntitlementEvaluationOptions): string[];
+//# sourceMappingURL=evaluate-entitlement-access.d.ts.map

package/dist/evaluate-entitlement-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-entitlement-access.d.ts","sourceRoot":"","sources":["../src/evaluate-entitlement-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAqBD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,oBAAoB,EAAE,EACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,4BAAiC,GACzC,cAAc,CA0BhB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,oBAAoB,EAAE,EACrC,OAAO,GAAE,4BAAiC,GACzC,MAAM,EAAE,CAYV"}

package/dist/evaluate-entitlement-access.js

@@ -0,0 +1,50 @@
+const ACCESSIBLE_STATUSES = new Set(["trialing", "active", "grace_period"]);
+function isStatusAccessible(subscription, options) {
+    if (!ACCESSIBLE_STATUSES.has(subscription.status)) {
+        return false;
+    }
+    if (options.checkPeriodEnd &&
+        subscription.currentPeriodEnd &&
+        Date.parse(subscription.currentPeriodEnd) < Date.now()) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Evaluates whether any active subscription grants the requested entitlement.
+ */
+export function evaluateEntitlementAccess(subscriptions, entitlement, options = {}) {
+    const match = subscriptions.find((subscription) => {
+        return (isStatusAccessible(subscription, options) &&
+            subscription.plan.entitlements.includes(entitlement));
+    });
+    if (match) {
+        return {
+            allowed: true,
+            reason: "subscription_found",
+            subscriptionId: match.id,
+            planCode: match.plan.code,
+            matchedEntitlement: entitlement,
+        };
+    }
+    const hasActiveSubscription = subscriptions.some((subscription) => isStatusAccessible(subscription, options));
+    return {
+        allowed: false,
+        reason: hasActiveSubscription ? "no_entitlement_match" : "no_active_subscription",
+    };
+}
+/**
+ * Returns all entitlements granted by active subscriptions for a subject.
+ */
+export function collectGrantedEntitlements(subscriptions, options = {}) {
+    const entitlements = new Set();
+    for (const subscription of subscriptions) {
+        if (isStatusAccessible(subscription, options)) {
+            for (const entitlement of subscription.plan.entitlements) {
+                entitlements.add(entitlement);
+            }
+        }
+    }
+    return [...entitlements];
+}
+//# sourceMappingURL=evaluate-entitlement-access.js.map

package/dist/evaluate-entitlement-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-entitlement-access.js","sourceRoot":"","sources":["../src/evaluate-entitlement-access.ts"],"names":[],"mappings":"AAGA,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;AAa5E,SAAS,kBAAkB,CACzB,YAAkC,EAClC,OAAqC;IAErC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,OAAO,CAAC,cAAc;QACtB,YAAY,CAAC,gBAAgB;QAC7B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,EACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAAqC,EACrC,WAAmB,EACnB,UAAwC,EAAE;IAE1C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE;QAChD,OAAO,CACL,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC;YACzC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,oBAAoB;YAC5B,cAAc,EAAE,KAAK,CAAC,EAAE;YACxB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;YACzB,kBAAkB,EAAE,WAAW;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,qBAAqB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAChE,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAC1C,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,wBAAwB;KAClF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,aAAqC,EACrC,UAAwC,EAAE;IAE1C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,IAAI,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC;YAC9C,KAAK,MAAM,WAAW,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACzD,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./domain/access.js";
+export * from "./domain/event.js";
+export * from "./domain/plan.js";
+export * from "./domain/plugin.js";
+export * from "./domain/subject.js";
+export * from "./domain/subscription.js";
+export * from "./evaluate-entitlement-access.js";
+export * from "./plugins.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./domain/access.js";
+export * from "./domain/event.js";
+export * from "./domain/plan.js";
+export * from "./domain/plugin.js";
+export * from "./domain/subject.js";
+export * from "./domain/subscription.js";
+export * from "./evaluate-entitlement-access.js";
+export * from "./plugins.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,cAAc,CAAC"}

package/dist/plugins.d.ts

@@ -0,0 +1,45 @@
+import type { PluginInstallation } from "./domain/event.js";
+import type { PlanInterval } from "./domain/plan.js";
+import type { PluginWebhookVerification, ParsedWebhookEvent, PluginWebhookEnvelope } from "./domain/plugin.js";
+export interface SubscriptionPlugin<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    key: string;
+    displayName: string;
+    description: string;
+    capabilities: string[];
+    defaultConfig?: TConfig;
+    parseWebhook?: (envelope: PluginWebhookEnvelope) => ParsedWebhookEvent | ParsedWebhookEvent[] | Promise<ParsedWebhookEvent | ParsedWebhookEvent[]>;
+    verifyWebhook?: (envelope: PluginWebhookEnvelope, context: {
+        config: TConfig;
+    }) => PluginWebhookVerification | Promise<PluginWebhookVerification>;
+    install?: (config: TConfig) => TConfig | Promise<TConfig>;
+    provisionPlan?: (input: PlanProvisioningInput, context: {
+        config: TConfig;
+    }) => PluginPlanProvisionResult | Promise<PluginPlanProvisionResult>;
+    deprovisionPlan?: (input: PlanProvisioningInput, context: {
+        config: TConfig;
+        result: PluginPlanProvisionResult;
+    }) => void | Promise<void>;
+}
+export interface PluginRegistryRecord {
+    plugin: SubscriptionPlugin;
+    installation?: PluginInstallation;
+}
+export interface PlanProvisioningInput {
+    code: string;
+    name: string;
+    description?: string | null;
+    interval?: PlanInterval;
+    priceAmount?: number;
+    currency?: string;
+    entitlements?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface PluginPlanProvisionMapping {
+    externalProductId: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PluginPlanProvisionResult {
+    mappings: PluginPlanProvisionMapping[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,kBAAkB,CACjC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,CACb,QAAQ,EAAE,qBAAqB,KAE7B,kBAAkB,GAClB,kBAAkB,EAAE,GACpB,OAAO,CAAC,kBAAkB,GAAG,kBAAkB,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,CACd,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;KACjB,KACE,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;KACjB,KACE,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACpE,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,yBAAyB,CAAC;KACnC,KACE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/plugins.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@shdan/submesh-core",
+  "version": "0.1.0",
+  "description": "Core domain model and plugin contracts for Submesh.",
+  "license": "MIT",
+  "author": "Shdan <hello@shdan.in> (https://shdan.in)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shdan-in/submesh.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://submesh.shdan.in",
+  "bugs": {
+    "url": "https://github.com/shdan-in/submesh/issues"
+  },
+  "keywords": [
+    "subscription",
+    "entitlement",
+    "billing",
+    "saas",
+    "sdk"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}