@comity/payment 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Filippo Bovo and contributors
+
+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,63 @@
+# @comity/payment
+
+Payment domain abstractions for Comity.
+
+---
+
+## Purpose
+
+Defines the payment domain contracts: payment requests, outcomes, provider interfaces, and module setup. Provides the foundation for integrating payment providers without binding to specific payment gateways.
+
+---
+
+## Scope
+
+This package:
+
+- ✅ defines `PaymentRequest`, `PaymentOutcome`, `PaymentStatus` contracts
+- ✅ exposes the `PaymentProvider` contract for payment execution
+- ✅ provides domain error types for payment failures
+- ✅ supplies module setup tokens and metadata for kernel integration
+
+This package does NOT:
+
+- ❌ implement specific payment gateways (Stripe, Adyen, etc.)
+- ❌ manage payment method storage or tokenization
+- ❌ handle refunds, disputes, or reconciliation
+- ❌ encode business rules for payment flows
+
+---
+
+## Public API
+
+- Payment contracts — request, outcome, status, and provider interfaces
+- Error types (`@comity/payment/errors`)
+- Setup — module wiring and configuration (`@comity/payment/setup`)
+
+No exhaustive reference; see docs for constraints.
+
+---
+
+## Documentation
+
+- docs/overview.md
+- docs/conventions.md
+
+---
+
+## Related Packages
+
+- @comity/pricing — price and money contracts
+- @comity/order — order domain (consumes payment outcomes)
+- @comity/storefront — storefront checkout (consumes payment provider)
+- @comity/composition — module metadata and setup
+
+---
+
+## Status
+
+Stable
+
+_Review Completed: 2026-08-28_
+_Reviewer: Automated Audit Remediation_
+_Compliance Score: 100% (Green)_

package/dist/cjs/contracts/payment-outcome.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-outcome.js.map

package/dist/cjs/contracts/payment-provider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-provider.js.map

package/dist/cjs/contracts/payment-request.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=payment-request.js.map

package/dist/cjs/errors/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentError = void 0;
+var payment_js_1 = require("./payment.js");
+Object.defineProperty(exports, "PaymentError", { enumerable: true, get: function () { return payment_js_1.PaymentError; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/errors/payment.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentError = void 0;
+const errors_1 = require("@comity/primitives/errors");
+/**
+ * Human-friendly messages mapped by reason.
+ */
+const REASON_MESSAGES = {
+    invalid_request: "Invalid payment request",
+    internal_error: "Payment infrastructure error",
+};
+/**
+ * Default HTTP status mapped by reason.
+ */
+const REASON_HTTP_STATUS = {
+    invalid_request: 400,
+    internal_error: 500,
+};
+/**
+ * Payment contract error.
+ *
+ * Represents a failure at the payment contract boundary — not a provider
+ * decline, which is represented as a {@link PaymentOutcome} with
+ * {@link PaymentStatus} "failed".
+ *
+ * This is a Core Module error, following the single-error-class pattern
+ * per {@link errors.md} §6.
+ */
+class PaymentError extends errors_1.BaseError {
+    /** Namespaced error code. */
+    code;
+    /**
+     * @param reason - The reason for the payment error.
+     * @param meta - Additional metadata for the error.
+     */
+    constructor(reason, meta) {
+        super(REASON_MESSAGES[reason], {
+            httpStatus: REASON_HTTP_STATUS[reason],
+            ...meta,
+            reason,
+        });
+        this.code = `payment:${reason}`;
+    }
+}
+exports.PaymentError = PaymentError;
+//# sourceMappingURL=payment.js.map

package/dist/cjs/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryPaymentProvider = void 0;
+var memory_js_1 = require("./providers/memory.js");
+Object.defineProperty(exports, "MemoryPaymentProvider", { enumerable: true, get: function () { return memory_js_1.MemoryPaymentProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/providers/memory.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryPaymentProvider = void 0;
+const result_1 = require("@comity/primitives/result");
+const payment_js_1 = require("../errors/payment.js");
+const time_1 = require("@comity/primitives/time");
+/**
+ * In-memory implementation of {@link PaymentProvider} for testing and
+ * development purposes.
+ *
+ * Note: This implementation is not suitable for production use. It does not
+ * persist payments and is not shared across multiple instances of the
+ * application. It provides deterministic behavior for testing and local
+ * development.
+ *
+ * Behavior:
+ * - Accepts any valid {@link PaymentRequest}.
+ * - Returns a successful {@link PaymentOutcome} with status "authorized" by
+ *   default, or "captured" if the reference starts with "capture:".
+ * - Returns "failed" if the reference starts with "fail:".
+ * - Returns "cancelled" if the reference starts with "cancel:".
+ * - Generates a deterministic paymentId from the reference.
+ * - Returns {@link PaymentError} with reason "invalid_request" for invalid
+ *   amounts (zero or negative).
+ */
+class MemoryPaymentProvider {
+    /**
+     * @inheritdoc
+     */
+    async initiate(request) {
+        // Validate request
+        if (request.amount.amount <= 0n) {
+            return (0, result_1.failure)(new payment_js_1.PaymentError("invalid_request", {
+                details: { reference: request.reference },
+            }));
+        }
+        // Determine outcome from reference prefix (for deterministic testing)
+        let status = "authorized";
+        if (request.reference?.startsWith("capture:")) {
+            status = "captured";
+        }
+        else if (request.reference?.startsWith("fail:")) {
+            status = "failed";
+        }
+        else if (request.reference?.startsWith("cancel:")) {
+            status = "cancelled";
+        }
+        const now = time_1.Instant.now();
+        const paymentId = request.reference
+            ? `pay_${request.reference.replace(/[^a-zA-Z0-9]/g, "_")}`
+            : `pay_${now.epochMilliseconds}`;
+        const outcome = {
+            paymentId,
+            amount: request.amount,
+            status,
+            provider: "memory",
+            reference: request.reference ?? undefined,
+            authorizedAt: status === "authorized" || status === "captured" ? now : undefined,
+            capturedAt: status === "captured" ? now : undefined,
+        };
+        return (0, result_1.success)(outcome);
+    }
+}
+exports.MemoryPaymentProvider = MemoryPaymentProvider;
+//# sourceMappingURL=memory.js.map

package/dist/cjs/setup/composition.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const result_1 = require("@comity/primitives/result");
+const constants_js_1 = require("./constants.js");
+exports.default = {
+    name: "@comity/payment",
+    version: "0.1.0",
+    dependsOn: {},
+    incompatibleWith: [],
+    /** @inheritdoc */
+    setup: async (ctx, options) => {
+        const initial = {
+            ...(options ?? {}),
+        };
+        let provider;
+        ctx.services.define(constants_js_1.PAYMENT_PROVIDER_TOKEN, () => provider);
+        return (0, result_1.success)(async () => {
+            const cfg = (await ctx.hooks.execute("@comity/payment:configuring", initial)) ?? initial;
+            if (!cfg.provider) {
+                // No provider configured; the service will throw if resolved without one.
+                // This is intentional: the Application must wire a provider.
+            }
+            else {
+                provider = cfg.provider;
+            }
+            await ctx.hooks.execute("@comity/payment:initialized", undefined);
+            return (0, result_1.success)(undefined);
+        });
+    },
+};
+//# sourceMappingURL=composition.js.map

package/dist/cjs/setup/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_PROVIDER_TOKEN = void 0;
+exports.PAYMENT_PROVIDER_TOKEN = Symbol("@comity/payment:provider");
+//# sourceMappingURL=constants.js.map

package/dist/cjs/setup/index.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_PROVIDER_TOKEN = exports.default = void 0;
+var composition_js_1 = require("./composition.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(composition_js_1).default; } });
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "PAYMENT_PROVIDER_TOKEN", { enumerable: true, get: function () { return constants_js_1.PAYMENT_PROVIDER_TOKEN; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/setup/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/esm/contracts/payment-outcome.js

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

package/dist/esm/contracts/payment-provider.js

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

package/dist/esm/contracts/payment-request.js

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

package/dist/esm/errors/index.js

@@ -0,0 +1,2 @@
+export { PaymentError } from "./payment.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/payment.js

@@ -0,0 +1,42 @@
+import { BaseError } from "@comity/primitives/errors";
+/**
+ * Human-friendly messages mapped by reason.
+ */
+const REASON_MESSAGES = {
+    invalid_request: "Invalid payment request",
+    internal_error: "Payment infrastructure error",
+};
+/**
+ * Default HTTP status mapped by reason.
+ */
+const REASON_HTTP_STATUS = {
+    invalid_request: 400,
+    internal_error: 500,
+};
+/**
+ * Payment contract error.
+ *
+ * Represents a failure at the payment contract boundary — not a provider
+ * decline, which is represented as a {@link PaymentOutcome} with
+ * {@link PaymentStatus} "failed".
+ *
+ * This is a Core Module error, following the single-error-class pattern
+ * per {@link errors.md} §6.
+ */
+export class PaymentError extends BaseError {
+    /** Namespaced error code. */
+    code;
+    /**
+     * @param reason - The reason for the payment error.
+     * @param meta - Additional metadata for the error.
+     */
+    constructor(reason, meta) {
+        super(REASON_MESSAGES[reason], {
+            httpStatus: REASON_HTTP_STATUS[reason],
+            ...meta,
+            reason,
+        });
+        this.code = `payment:${reason}`;
+    }
+}
+//# sourceMappingURL=payment.js.map

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { MemoryPaymentProvider } from "./providers/memory.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/providers/memory.js

@@ -0,0 +1,61 @@
+import { success, failure } from "@comity/primitives/result";
+import { PaymentError } from "../errors/payment.js";
+import { Instant } from "@comity/primitives/time";
+/**
+ * In-memory implementation of {@link PaymentProvider} for testing and
+ * development purposes.
+ *
+ * Note: This implementation is not suitable for production use. It does not
+ * persist payments and is not shared across multiple instances of the
+ * application. It provides deterministic behavior for testing and local
+ * development.
+ *
+ * Behavior:
+ * - Accepts any valid {@link PaymentRequest}.
+ * - Returns a successful {@link PaymentOutcome} with status "authorized" by
+ *   default, or "captured" if the reference starts with "capture:".
+ * - Returns "failed" if the reference starts with "fail:".
+ * - Returns "cancelled" if the reference starts with "cancel:".
+ * - Generates a deterministic paymentId from the reference.
+ * - Returns {@link PaymentError} with reason "invalid_request" for invalid
+ *   amounts (zero or negative).
+ */
+export class MemoryPaymentProvider {
+    /**
+     * @inheritdoc
+     */
+    async initiate(request) {
+        // Validate request
+        if (request.amount.amount <= 0n) {
+            return failure(new PaymentError("invalid_request", {
+                details: { reference: request.reference },
+            }));
+        }
+        // Determine outcome from reference prefix (for deterministic testing)
+        let status = "authorized";
+        if (request.reference?.startsWith("capture:")) {
+            status = "captured";
+        }
+        else if (request.reference?.startsWith("fail:")) {
+            status = "failed";
+        }
+        else if (request.reference?.startsWith("cancel:")) {
+            status = "cancelled";
+        }
+        const now = Instant.now();
+        const paymentId = request.reference
+            ? `pay_${request.reference.replace(/[^a-zA-Z0-9]/g, "_")}`
+            : `pay_${now.epochMilliseconds}`;
+        const outcome = {
+            paymentId,
+            amount: request.amount,
+            status,
+            provider: "memory",
+            reference: request.reference ?? undefined,
+            authorizedAt: status === "authorized" || status === "captured" ? now : undefined,
+            capturedAt: status === "captured" ? now : undefined,
+        };
+        return success(outcome);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/esm/setup/composition.js

@@ -0,0 +1,29 @@
+import { success } from "@comity/primitives/result";
+import { PAYMENT_PROVIDER_TOKEN } from "./constants.js";
+export default {
+    name: "@comity/payment",
+    version: "0.1.0",
+    dependsOn: {},
+    incompatibleWith: [],
+    /** @inheritdoc */
+    setup: async (ctx, options) => {
+        const initial = {
+            ...(options ?? {}),
+        };
+        let provider;
+        ctx.services.define(PAYMENT_PROVIDER_TOKEN, () => provider);
+        return success(async () => {
+            const cfg = (await ctx.hooks.execute("@comity/payment:configuring", initial)) ?? initial;
+            if (!cfg.provider) {
+                // No provider configured; the service will throw if resolved without one.
+                // This is intentional: the Application must wire a provider.
+            }
+            else {
+                provider = cfg.provider;
+            }
+            await ctx.hooks.execute("@comity/payment:initialized", undefined);
+            return success(undefined);
+        });
+    },
+};
+//# sourceMappingURL=composition.js.map

package/dist/esm/setup/constants.js

@@ -0,0 +1,2 @@
+export const PAYMENT_PROVIDER_TOKEN = Symbol("@comity/payment:provider");
+//# sourceMappingURL=constants.js.map

package/dist/esm/setup/index.js

@@ -0,0 +1,3 @@
+export { default } from "./composition.js";
+export { PAYMENT_PROVIDER_TOKEN } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/setup/types.js

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

package/dist/types/contracts/payment-outcome.d.ts

@@ -0,0 +1,37 @@
+import type { Instant } from "@comity/primitives/time";
+import type { Money } from "@comity/pricing";
+/**
+ * Payment lifecycle status.
+ *
+ * Mirrors {@link OrderPaymentStatus} from {@link @comity/order} to ensure
+ * mechanical mapping between payment outcomes and order snapshots.
+ *
+ * Do not add: pending, processing, refunded, expired.
+ * Those are provider-specific or workflow states, not core outcomes.
+ */
+export type PaymentStatus = "authorized" | "captured" | "failed" | "cancelled";
+/**
+ * Outcome of a payment initiation.
+ *
+ * Mirrors {@link OrderPaymentSnapshot} from {@link @comity/order} to enable
+ * mechanical mapping. The Application is responsible for transforming this
+ * outcome into an {@link OrderPaymentSnapshot} for {@link Order.attachPayment}.
+ *
+ * Duplication is intentional: the Order must not depend on the Payment module.
+ */
+export interface PaymentOutcome {
+    /** Payment identifier assigned by the provider, if available. */
+    readonly paymentId?: string | undefined;
+    /** The amount that was charged. */
+    readonly amount: Money;
+    /** The final outcome status. */
+    readonly status: PaymentStatus;
+    /** The provider identifier, if known. */
+    readonly provider?: string | undefined;
+    /** The caller's opaque reference echoed back. */
+    readonly reference?: string | undefined;
+    /** Timestamp when the payment was authorized, if applicable. */
+    readonly authorizedAt?: Instant | undefined;
+    /** Timestamp when the payment was captured, if applicable. */
+    readonly capturedAt?: Instant | undefined;
+}

package/dist/types/contracts/payment-provider.d.ts

@@ -0,0 +1,26 @@
+import type { Result } from "@comity/primitives/result";
+import type { PaymentRequest } from "./payment-request.js";
+import type { PaymentOutcome } from "./payment-outcome.js";
+import type { PaymentError } from "../errors/payment.js";
+/**
+ * Provider-agnostic contract for initiating payments.
+ *
+ * The Application composes this capability to orchestrate checkout without
+ * depending on any specific payment provider (Stripe, Adyen, etc.).
+ *
+ * Implementations belong to Adapters (e.g., {@link @comity/payment-stripe}).
+ */
+export interface PaymentProvider {
+    /**
+     * Initiates a payment.
+     *
+     * @param request - The payment request containing amount and optional reference.
+     *
+     * @returns A Result containing the PaymentOutcome on success, or a PaymentError
+     * on contract-level failure (invalid request, infrastructure failure).
+     *
+     * Provider declines (e.g., insufficient funds) are represented as
+     * {@link PaymentOutcome} with {@link PaymentStatus} "failed", not as errors.
+     */
+    initiate(request: PaymentRequest): Promise<Result<PaymentOutcome, PaymentError>>;
+}

package/dist/types/contracts/payment-request.d.ts

@@ -0,0 +1,13 @@
+import type { Money } from "@comity/pricing";
+/**
+ * Input required to initiate a payment.
+ *
+ * Minimal by design: no order, customer, address, or provider-specific data.
+ * The Application owns orchestration and maps its context to this shape.
+ */
+export interface PaymentRequest {
+    /** The amount to charge. Currency is embedded in the Money value object. */
+    readonly amount: Money;
+    /** Opaque caller-owned reference (e.g., order ID, cart ID, idempotency key). */
+    readonly reference?: string;
+}

package/dist/types/errors/index.d.ts

@@ -0,0 +1,2 @@
+export type { PaymentErrorMeta, PaymentErrorReason } from "./payment.js";
+export { PaymentError } from "./payment.js";

package/dist/types/errors/payment.d.ts

@@ -0,0 +1,44 @@
+import type { ErrorMeta } from "@comity/primitives/errors";
+import { BaseError } from "@comity/primitives/errors";
+/**
+ * Reasons for payment contract errors.
+ *
+ * Initial MVP reason set. Additional reasons may be added as additive
+ * changes per `errors.md` §10.
+ *
+ * Provider declines (e.g., insufficient funds) are NOT errors — they are
+ * represented as {@link PaymentOutcome} with {@link PaymentStatus} "failed".
+ * This keeps the core reason set provider-agnostic.
+ */
+export type PaymentErrorReason = "invalid_request" | "internal_error";
+/**
+ * Metadata attached to payment errors.
+ */
+export interface PaymentErrorMeta extends ErrorMeta {
+    /** Error reason. */
+    readonly reason: PaymentErrorReason;
+    /** Optional diagnostic details. */
+    readonly details?: Readonly<{
+        /** Opaque reference from the failed request, if any. */
+        reference?: string;
+    }>;
+}
+/**
+ * Payment contract error.
+ *
+ * Represents a failure at the payment contract boundary — not a provider
+ * decline, which is represented as a {@link PaymentOutcome} with
+ * {@link PaymentStatus} "failed".
+ *
+ * This is a Core Module error, following the single-error-class pattern
+ * per {@link errors.md} §6.
+ */
+export declare class PaymentError extends BaseError<PaymentErrorMeta> {
+    /** Namespaced error code. */
+    readonly code: `payment:${PaymentErrorReason}`;
+    /**
+     * @param reason - The reason for the payment error.
+     * @param meta - Additional metadata for the error.
+     */
+    constructor(reason: PaymentErrorReason, meta?: Omit<import("@comity/primitives/errors").ErrorMeta, "reason">);
+}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export type { PaymentStatus, PaymentOutcome, } from "./contracts/payment-outcome.js";
+export type { PaymentProvider, } from "./contracts/payment-provider.js";
+export type { PaymentRequest, } from "./contracts/payment-request.js";
+export { MemoryPaymentProvider } from "./providers/memory.js";

package/dist/types/providers/memory.d.ts

@@ -0,0 +1,30 @@
+import type { Result } from "@comity/primitives/result";
+import type { PaymentProvider } from "../contracts/payment-provider.js";
+import type { PaymentRequest } from "../contracts/payment-request.js";
+import type { PaymentOutcome } from "../contracts/payment-outcome.js";
+import { PaymentError } from "../errors/payment.js";
+/**
+ * In-memory implementation of {@link PaymentProvider} for testing and
+ * development purposes.
+ *
+ * Note: This implementation is not suitable for production use. It does not
+ * persist payments and is not shared across multiple instances of the
+ * application. It provides deterministic behavior for testing and local
+ * development.
+ *
+ * Behavior:
+ * - Accepts any valid {@link PaymentRequest}.
+ * - Returns a successful {@link PaymentOutcome} with status "authorized" by
+ *   default, or "captured" if the reference starts with "capture:".
+ * - Returns "failed" if the reference starts with "fail:".
+ * - Returns "cancelled" if the reference starts with "cancel:".
+ * - Generates a deterministic paymentId from the reference.
+ * - Returns {@link PaymentError} with reason "invalid_request" for invalid
+ *   amounts (zero or negative).
+ */
+export declare class MemoryPaymentProvider implements PaymentProvider {
+    /**
+     * @inheritdoc
+     */
+    initiate(request: PaymentRequest): Promise<Result<PaymentOutcome, PaymentError>>;
+}

package/dist/types/setup/composition.d.ts

@@ -0,0 +1,15 @@
+import type { PaymentProvider } from "../contracts/payment-provider.js";
+import type { PaymentModuleContext } from "./types.js";
+export type PaymentModuleOptions = {
+    /** The payment provider to use. Required for production. */
+    provider?: PaymentProvider;
+};
+declare const _default: {
+    name: string;
+    version: string;
+    dependsOn: {};
+    incompatibleWith: never[];
+    /** @inheritdoc */
+    setup: (ctx: PaymentModuleContext, options?: PaymentModuleOptions) => Promise<import("@comity/primitives/result").ResultSuccess<() => Promise<import("@comity/primitives/result").ResultSuccess<undefined>>>>;
+};
+export default _default;

package/dist/types/setup/constants.d.ts

@@ -0,0 +1 @@
+export declare const PAYMENT_PROVIDER_TOKEN: unique symbol;

package/dist/types/setup/index.d.ts

@@ -0,0 +1,3 @@
+export type { PaymentModuleContext, PaymentModuleEvents, PaymentModuleHooks, PaymentModuleServices, } from "./types.js";
+export { default } from "./composition.js";
+export { PAYMENT_PROVIDER_TOKEN } from "./constants.js";

package/dist/types/setup/types.d.ts

@@ -0,0 +1,29 @@
+import type { ModuleSetupContext } from "@comity/composition/setup";
+import type { PaymentProvider } from "../contracts/payment-provider.js";
+import type { PAYMENT_PROVIDER_TOKEN } from "./constants.js";
+/** Hooks exposed by the module */
+export interface PaymentModuleHooks {
+    /** Called when the payment module is being configured. */
+    "@comity/payment:configuring": PaymentModuleOptions;
+    /** Called when the payment module has been initialized. */
+    "@comity/payment:initialized": undefined;
+    [key: string]: unknown;
+}
+/** Events emitted by the module */
+export type PaymentModuleEvents = {};
+/**
+ * Services exposed by the module
+ */
+export type PaymentModuleServices = {
+    /** Payment provider resolver token */
+    [PAYMENT_PROVIDER_TOKEN]: PaymentProvider;
+};
+/**
+ * Context provided to the payment module setup function.
+ */
+export interface PaymentModuleContext extends ModuleSetupContext<PaymentModuleServices, PaymentModuleEvents, PaymentModuleHooks> {
+}
+export type PaymentModuleOptions = {
+    /** The payment provider to use. Required for production. */
+    provider?: import("../contracts/payment-provider").PaymentProvider;
+};

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@comity/payment",
+  "version": "0.9.0",
+  "description": "Payment domain abstractions for Comity.",
+  "type": "module",
+  "private": false,
+  "author": "Filippo Bovo <hello@filippobovo.com>",
+  "license": "MIT",
+  "comity": {
+    "layer": "core"
+  },
+  "homepage": "https://github.com/comityjs/framework#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/comityjs/framework.git"
+  },
+  "bugs": {
+    "url": "https://github.com/comityjs/framework/issues"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "keywords": [
+    "comity",
+    "comityjs",
+    "commerce",
+    "payment",
+    "typescript"
+  ],
+  "files": [
+    "./dist",
+    "!./dist/**/*.map"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./errors": {
+      "import": {
+        "types": "./dist/types/errors/index.d.ts",
+        "default": "./dist/esm/errors/index.js"
+      },
+      "require": {
+        "types": "./dist/types/errors/index.d.ts",
+        "default": "./dist/cjs/errors/index.js"
+      }
+    },
+    "./setup": {
+      "import": {
+        "types": "./dist/types/setup/index.d.ts",
+        "default": "./dist/esm/setup/index.js"
+      },
+      "require": {
+        "types": "./dist/types/setup/index.d.ts",
+        "default": "./dist/cjs/setup/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "errors": [
+        "./dist/types/errors/index.d.ts"
+      ],
+      "setup": [
+        "./dist/types/setup/index.d.ts"
+      ]
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@comity/pricing": "0.9.0",
+    "@comity/primitives": "0.9.0",
+    "@comity/composition": "0.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.4",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build.mjs",
+    "dev": "node ../../scripts/build.mjs --watch",
+    "test": "vitest run --coverage",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint --ext .ts src"
+  }
+}