@shdan/submesh 0.1.0

package/dist/services/subject-resolution.js

@@ -0,0 +1,48 @@
+import { ConflictError, NotFoundError, ValidationError } from "../errors.js";
+import { getExternalSubjectId } from "../utils/canonical.js";
+function toIdentityInput(subjectId, input, externalSubjectId) {
+    return {
+        subjectId,
+        provider: input.pluginKey,
+        externalId: externalSubjectId,
+        metadata: {
+            sourceType: input.sourceType,
+        },
+    };
+}
+export async function resolveSubjectForRecord(repositories, input) {
+    const externalSubjectId = getExternalSubjectId(input);
+    if (input.subjectId) {
+        const subject = await repositories.subjects.upsert({
+            id: input.subjectId,
+            email: input.subject?.email,
+            name: input.subject?.name,
+            externalRef: input.subject?.externalRef,
+            metadata: input.subject?.metadata,
+        });
+        if (!externalSubjectId) {
+            return subject;
+        }
+        const existingIdentity = await repositories.subjects.findIdentity(input.pluginKey, externalSubjectId);
+        if (existingIdentity && existingIdentity.subjectId !== subject.id) {
+            throw new ConflictError(`Provider identity ${input.pluginKey}:${externalSubjectId} is already linked to another subject.`);
+        }
+        if (!existingIdentity) {
+            await repositories.subjects.upsertIdentity(toIdentityInput(subject.id, input, externalSubjectId));
+        }
+        return subject;
+    }
+    if (!externalSubjectId) {
+        throw new ValidationError("Canonical subscription input must include subjectId or an external subject identity.");
+    }
+    const identity = await repositories.subjects.findIdentity(input.pluginKey, externalSubjectId);
+    if (!identity) {
+        throw new NotFoundError(`No linked subject found for ${input.pluginKey}:${externalSubjectId}.`);
+    }
+    const subject = await repositories.subjects.getById(identity.subjectId);
+    if (!subject) {
+        throw new NotFoundError(`Linked subject ${identity.subjectId} was not found.`);
+    }
+    return subject;
+}
+//# sourceMappingURL=subject-resolution.js.map

package/dist/services/subject-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-resolution.js","sourceRoot":"","sources":["../../src/services/subject-resolution.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,SAAS,eAAe,CACtB,SAAiB,EACjB,KAAiC,EACjC,iBAAyB;IAEzB,OAAO;QACL,SAAS;QACT,QAAQ,EAAE,KAAK,CAAC,SAAS;QACzB,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE;YACR,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAA2B,EAC3B,KAAiC;IAEjC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEtD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;YACjD,EAAE,EAAE,KAAK,CAAC,SAAS;YACnB,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK;YAC3B,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI;YACzB,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW;YACvC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,gBAAgB,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,CAC/D,KAAK,CAAC,SAAS,EACf,iBAAiB,CAClB,CAAC;QAEF,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;YAClE,MAAM,IAAI,aAAa,CACrB,qBAAqB,KAAK,CAAC,SAAS,IAAI,iBAAiB,wCAAwC,CAClG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,YAAY,CAAC,QAAQ,CAAC,cAAc,CACxC,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,CAAC,CACtD,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CACvB,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,CACvD,KAAK,CAAC,SAAS,EACf,iBAAiB,CAClB,CAAC;IAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,aAAa,CACrB,+BAA+B,KAAK,CAAC,SAAS,IAAI,iBAAiB,GAAG,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CAAC,kBAAkB,QAAQ,CAAC,SAAS,iBAAiB,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/services/webhook-ingestion-service.d.ts

@@ -0,0 +1,14 @@
+import type { IngestWebhookOptions, IngestWebhookResult } from "../contracts.js";
+import type { PluginRegistry } from "../plugins/plugin-registry.js";
+import type { SubmeshRepositories } from "../repositories/index.js";
+import type { SubmeshLogger } from "../logger.js";
+import type { SubmeshHooks } from "../hooks.js";
+interface WebhookIngestionOptions {
+    repositories: SubmeshRepositories;
+    pluginRegistry: PluginRegistry;
+    logger: SubmeshLogger;
+    hooks: SubmeshHooks;
+}
+export declare function ingestWebhookEvent(options: WebhookIngestionOptions, pluginKey: string, body: unknown, headers: Record<string, string | string[] | undefined>, ingestOptions?: IngestWebhookOptions): Promise<IngestWebhookResult>;
+export {};
+//# sourceMappingURL=webhook-ingestion-service.d.ts.map

package/dist/services/webhook-ingestion-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-ingestion-service.d.ts","sourceRoot":"","sources":["../../src/services/webhook-ingestion-service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,uBAAuB;IAC/B,YAAY,EAAE,mBAAmB,CAAC;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB;AAyFD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,aAAa,GAAE,oBAAyB,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAuG9B"}

package/dist/services/webhook-ingestion-service.js

@@ -0,0 +1,149 @@
+import { ValidationError } from "../errors.js";
+import { ingestCanonicalSubscription } from "./canonical-subscription-service.js";
+const MAX_STORED_PAYLOAD_BYTES = 128 * 1024;
+const PAYLOAD_PREVIEW_BYTES = 4096;
+const MAX_STORED_ERROR_MESSAGE_LENGTH = 2048;
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength)}...[truncated]`;
+}
+function toPersistedPayload(body) {
+    const payload = body && typeof body === "object" && !Array.isArray(body)
+        ? body
+        : { value: body };
+    try {
+        const serialized = JSON.stringify(payload);
+        if (!serialized) {
+            return payload;
+        }
+        const size = Buffer.byteLength(serialized, "utf8");
+        if (size <= MAX_STORED_PAYLOAD_BYTES) {
+            return payload;
+        }
+        return {
+            _truncated: true,
+            _originalSizeBytes: size,
+            preview: truncate(serialized, PAYLOAD_PREVIEW_BYTES),
+        };
+    }
+    catch {
+        return {
+            _unserializable: true,
+            valueType: typeof body,
+        };
+    }
+}
+function toStoredErrorMessage(error) {
+    const message = error instanceof Error ? error.message : "Unknown webhook ingestion error.";
+    return truncate(message, MAX_STORED_ERROR_MESSAGE_LENGTH);
+}
+async function processParsedEvent(options, event, records) {
+    const transitions = [];
+    const subscriptions = await options.repositories.transaction(async (tx) => {
+        const created = [];
+        for (const record of records) {
+            const existing = await tx.subscriptions.getBySource(record.pluginKey, record.sourceRef);
+            const previousStatus = existing?.status ?? null;
+            const sub = await ingestCanonicalSubscription(tx, record);
+            created.push(sub);
+            if (previousStatus !== sub.status) {
+                transitions.push({ sub, previous: previousStatus });
+            }
+        }
+        return created;
+    });
+    await options.repositories.inboundEvents.markProcessed(event.id, subscriptions.length);
+    for (const t of transitions) {
+        if (options.hooks.onSubscriptionChanged) {
+            await Promise.resolve(options.hooks.onSubscriptionChanged(t.sub, t.previous)).catch((e) => options.logger.error("Error in onSubscriptionChanged hook", { error: e }));
+        }
+    }
+    return subscriptions;
+}
+export async function ingestWebhookEvent(options, pluginKey, body, headers, ingestOptions = {}) {
+    const plugin = options.pluginRegistry.get(pluginKey);
+    if (!plugin) {
+        throw new ValidationError(`Plugin ${pluginKey} is not registered.`);
+    }
+    const installations = await options.repositories.pluginInstallations.list();
+    const installation = installations.find((item) => item.pluginKey === pluginKey);
+    if (pluginKey !== "manual" && !installation?.enabled) {
+        throw new ValidationError(`Plugin ${pluginKey} is not installed or not enabled.`);
+    }
+    if (!plugin.parseWebhook) {
+        throw new ValidationError(`Plugin ${pluginKey} does not support webhook ingestion.`);
+    }
+    const receivedAt = new Date().toISOString();
+    const config = installation?.config ?? {};
+    const envelope = {
+        body,
+        headers,
+        receivedAt,
+        rawBody: ingestOptions.rawBody,
+    };
+    if (plugin.verifyWebhook) {
+        const verification = await plugin.verifyWebhook(envelope, { config });
+        if (!verification.verified) {
+            throw new ValidationError(`Webhook verification failed for ${pluginKey}.`);
+        }
+    }
+    const parsed = await plugin.parseWebhook({
+        ...envelope,
+    });
+    const events = Array.isArray(parsed) ? parsed : [parsed];
+    const subscriptions = [];
+    let processedEvents = 0;
+    let duplicateEvents = 0;
+    for (const event of events) {
+        const received = await options.repositories.inboundEvents.markReceived({
+            pluginKey,
+            eventKey: event.eventKey,
+            eventType: event.eventType,
+            sourceRef: event.sourceRef,
+            payload: toPersistedPayload(body),
+        });
+        if (!received.claimed) {
+            duplicateEvents += 1;
+            continue;
+        }
+        const inboundEvent = received.event;
+        if (event.records.length === 0) {
+            await options.repositories.inboundEvents.markIgnored(inboundEvent.id);
+            continue;
+        }
+        try {
+            const created = await processParsedEvent(options, inboundEvent, event.records);
+            subscriptions.push(...created);
+            processedEvents += 1;
+        }
+        catch (error) {
+            const message = toStoredErrorMessage(error);
+            await options.repositories.inboundEvents.markFailed(inboundEvent.id, message);
+            options.logger.error("Webhook ingestion failed for event", {
+                eventId: inboundEvent.id,
+                error,
+            });
+            if (options.hooks.onWebhookFailed) {
+                await Promise.resolve(options.hooks.onWebhookFailed(pluginKey, inboundEvent, error)).catch((e) => options.logger.error("Error in onWebhookFailed hook", { error: e }));
+            }
+            throw error;
+        }
+    }
+    const result = {
+        processedEvents,
+        duplicateEvents,
+        subscriptions,
+    };
+    options.logger.info("Webhook ingestion completed", {
+        pluginKey,
+        processedEvents,
+        duplicateEvents,
+    });
+    if (options.hooks.onWebhookProcessed) {
+        await Promise.resolve(options.hooks.onWebhookProcessed(pluginKey, result)).catch((e) => options.logger.error("Error in onWebhookProcessed hook", { error: e }));
+    }
+    return result;
+}
+//# sourceMappingURL=webhook-ingestion-service.js.map

package/dist/services/webhook-ingestion-service.js.map

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

package/dist/submesh.d.ts

@@ -0,0 +1,265 @@
+import { EntitlementEvaluationOptions, SubscriptionPlugin, type AccessDecision, type CanonicalSubscriptionInput, type CatalogMapping, type DashboardSummary, type InboundEvent, type Plan, type PluginInstallation, type Subject, type Subscription, type SubscriptionWithPlan } from "@shdan/submesh-core";
+import type { CreateManagedSubscriptionInput, CreatePlanInput, IngestWebhookOptions, IngestWebhookResult, InstallPluginInput, LinkProviderIdentityInput, PluginListItem, SyncAppleAppStoreSubscriptionInput, SyncGooglePlaySubscriptionInput, SubmeshOptions, SyncedProviderSubscription, UpsertCatalogMappingInput, UpsertSubjectInput, VerifyAppleAppStoreSubscriptionInput, VerifyGooglePlaySubscriptionInput, UpdatePlanInput, UpdateSubscriptionInput, CancelSubscriptionOptions, VerifiedProviderSubscription } from "./contracts.js";
+/**
+ * Main Submesh SDK client.
+ *
+ * Create one instance, then use it to manage subjects, plans, subscriptions,
+ * plugins, and provider sync flows.
+ */
+export declare class Submesh {
+    private readonly repositories;
+    private readonly pluginRegistry;
+    private readonly ready;
+    private readyError;
+    private readonly logger;
+    private readonly hooks;
+    private ensureReady;
+    private getPluginConfig;
+    /**
+     * Creates a Submesh client.
+     *
+     * You can provide repositories directly, Drizzle options, or a Postgres
+     * connection string. Built-in plugins are registered by default.
+     *
+     * @param options Configuration for repositories, migrations, and plugins.
+     */
+    constructor(options?: SubmeshOptions);
+    /**
+     * Registers a plugin in memory so it can be installed and used.
+     *
+     * @param plugin Plugin definition to register.
+     */
+    registerPlugin(plugin: SubscriptionPlugin): void;
+    /**
+     * Saves plugin configuration and marks the plugin as installed.
+     *
+     * @param input Plugin key and installation config payload.
+     * @returns The stored plugin installation record.
+     */
+    installPlugin<K extends string>(input: InstallPluginInput<K>): Promise<PluginInstallation>;
+    /**
+     * Returns registered plugins with their current installation state.
+     *
+     * @returns Registered plugins enriched with installation status.
+     */
+    listPlugins(): Promise<PluginListItem[]>;
+    /**
+     * Disables an installed plugin.
+     *
+     * @param pluginKey The key of the plugin to disable.
+     */
+    disablePlugin(pluginKey: string): Promise<void>;
+    /**
+     * Returns all subjects.
+     *
+     * @returns All known subjects.
+     */
+    listSubjects(): Promise<Subject[]>;
+    /**
+     * Creates or updates a subject.
+     *
+     * @param input Subject payload to insert or update.
+     * @returns The created or updated subject.
+     */
+    upsertSubject(input: UpsertSubjectInput): Promise<Subject>;
+    /**
+     * Returns a subject by their ID.
+     *
+     * @param id The subject identifier.
+     * @returns The subject or undefined if not found.
+     */
+    getSubject(id: string): Promise<Subject | undefined>;
+    /**
+     * Links an external provider identity to a subject.
+     *
+     * @param input Provider identity details and target subject.
+     * @returns Resolves when the identity link is persisted.
+     */
+    linkProviderIdentity(input: LinkProviderIdentityInput): Promise<void>;
+    /**
+     * Returns all plans.
+     *
+     * @returns All plans in the catalog.
+     */
+    listPlans(): Promise<Plan[]>;
+    /**
+     * Creates a plan and runs plugin provisioning hooks.
+     *
+     * @param input Plan definition and entitlement data.
+     * @returns The newly created plan.
+     */
+    createPlan(input: CreatePlanInput): Promise<Plan>;
+    /**
+     * Updates a plan's details.
+     *
+     * @param code The unique code of the plan to update.
+     * @param input Data to update on the plan.
+     * @returns The updated plan.
+     */
+    updatePlan(code: string, input: UpdatePlanInput): Promise<Plan>;
+    /**
+     * Deletes a plan from the catalog.
+     *
+     * @param code The plan code to delete.
+     */
+    deletePlan(code: string): Promise<void>;
+    /**
+     * Returns catalog mappings from provider products to internal plan codes.
+     *
+     * @returns All configured catalog mappings.
+     */
+    listCatalogMappings(): Promise<CatalogMapping[]>;
+    /**
+     * Creates or updates a catalog mapping after validating the target plan.
+     *
+     * @param input Provider catalog identifier mapped to a plan code.
+     * @returns The created or updated mapping.
+     */
+    upsertCatalogMapping(input: UpsertCatalogMappingInput): Promise<CatalogMapping>;
+    /**
+     * Removes a catalog mapping.
+     *
+     * @param pluginKey Plugin key (e.g. google-play).
+     * @param externalProductId Product ID at the provider.
+     */
+    deleteCatalogMapping(pluginKey: string, externalProductId: string): Promise<void>;
+    /**
+     * Returns subscriptions with resolved plan details.
+     *
+     * @returns All subscriptions joined with plan details.
+     */
+    listSubscriptions(): Promise<SubscriptionWithPlan[]>;
+    /**
+     * Returns a subscription by its ID.
+     *
+     * @param id The subscription identifier.
+     */
+    getSubscription(id: string): Promise<SubscriptionWithPlan | undefined>;
+    /**
+     * Returns subscriptions for a specific subject.
+     *
+     * @param subjectId The subject identifier.
+     */
+    listSubscriptionsBySubject(subjectId: string): Promise<SubscriptionWithPlan[]>;
+    /**
+     * Creates a managed subscription.
+     *
+     * @param input Subscription payload for a subject and plan.
+     * @returns The created subscription.
+     */
+    createSubscription(input: CreateManagedSubscriptionInput): Promise<Subscription>;
+    /**
+     * Updates an existing subscription directly.
+     *
+     * @param id The subscription ID.
+     * @param input Data to update.
+     */
+    updateSubscription(id: string, input: UpdateSubscriptionInput): Promise<Subscription>;
+    /**
+     * Cancels a subscription. For manual subscriptions, updates local state.
+     *
+     * @param id Subscription ID.
+     * @param options Cancellation options.
+     */
+    cancelSubscription(id: string, options?: CancelSubscriptionOptions): Promise<Subscription>;
+    /**
+     * Checks whether a subject has access to an entitlement.
+     *
+     * @param subjectId Subject identifier to evaluate.
+     * @param entitlement Entitlement key to check.
+     * @returns Access decision with reason and optional matched subscription.
+     */
+    hasAccess(subjectId: string, entitlement: string, options?: EntitlementEvaluationOptions): Promise<AccessDecision>;
+    /**
+     * Returns all active entitlements for a subject.
+     *
+     * @param subjectId Subject identifier.
+     * @param options Execution options.
+     */
+    listEntitlements(subjectId: string, options?: EntitlementEvaluationOptions): Promise<string[]>;
+    /**
+     * Returns dashboard summary metrics.
+     *
+     * @returns Aggregate counts and metrics for dashboard views.
+     */
+    getSummary(): Promise<DashboardSummary>;
+    /**
+     * Returns recently ingested inbound events.
+     *
+     * @param limit Maximum number of events to return.
+     * @returns Most recent inbound events up to the requested limit.
+     */
+    listEvents(limit?: number): Promise<InboundEvent[]>;
+    /**
+     * Returns failed inbound events.
+     *
+     * @param limit Maximum number of events.
+     */
+    listFailedEvents(limit?: number): Promise<InboundEvent[]>;
+    /**
+     * Retry processing a failed event.
+     *
+     * @param eventId The event identifier.
+     */
+    retryEvent(eventId: string): Promise<IngestWebhookResult>;
+    /**
+     * Ingests a canonical subscription event.
+     *
+     * @param input Canonical subscription event payload.
+     * @returns The resulting subscription after ingestion.
+     */
+    ingestCanonicalEvent(input: CanonicalSubscriptionInput): Promise<Subscription>;
+    /**
+     * Ingests a plugin webhook payload and applies subscription updates.
+     *
+     * @param pluginKey Registered plugin key handling this webhook.
+     * @param body Raw webhook request body.
+     * @param headers Request headers used for verification and parsing.
+     * @param options Additional ingestion behavior options.
+     * @returns Ingestion result including dedupe and subscription update outcome.
+     */
+    ingestWebhook(pluginKey: string, body: unknown, headers?: Record<string, string | string[] | undefined>, options?: IngestWebhookOptions): Promise<IngestWebhookResult>;
+    /**
+     * Creates a Web API standard request handler for webhooks.
+     * Compatible with Next.js App Router, Cloudflare Workers, and standard Node >= 18.
+     *
+     * @param pluginKey The plugin to route webhooks to.
+     * @returns A function `(req: Request) => Promise<Response>`
+     */
+    createWebhookHandler(pluginKey: string): (req: Request) => Promise<Response>;
+    /**
+     * Verifies a Google Play purchase and returns canonical subscription data.
+     *
+     * @param input Google Play verification payload.
+     * @returns Verified provider response with canonical subscription data.
+     */
+    verifyGooglePlaySubscription(input: VerifyGooglePlaySubscriptionInput): Promise<VerifiedProviderSubscription>;
+    /**
+     * Verifies and syncs a Google Play subscription.
+     *
+     * @param input Google Play verification payload plus target subject.
+     * @returns Verified data plus the synchronized subscription record.
+     */
+    syncGooglePlaySubscription(input: SyncGooglePlaySubscriptionInput): Promise<SyncedProviderSubscription>;
+    /**
+     * Verifies an Apple App Store transaction and returns canonical data.
+     *
+     * @param input Apple App Store verification payload.
+     * @returns Verified provider response with canonical subscription data.
+     */
+    verifyAppleAppStoreSubscription(input: VerifyAppleAppStoreSubscriptionInput): Promise<VerifiedProviderSubscription>;
+    /**
+     * Verifies and syncs an Apple App Store subscription.
+     *
+     * @param input Apple verification payload plus target subject.
+     * @returns Verified data plus the synchronized subscription record.
+     */
+    syncAppleAppStoreSubscription(input: SyncAppleAppStoreSubscriptionInput): Promise<SyncedProviderSubscription>;
+    /**
+     * Closes underlying repository connections.
+     *
+     * @returns Resolves when repository connections are closed.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=submesh.d.ts.map

package/dist/submesh.d.ts.map

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