alepha 0.19.1 → 0.19.2

package/dist/billing/index.d.ts

@@ -0,0 +1,1048 @@
+import * as _$alepha from "alepha";
+import { Alepha, AlephaError, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
+import * as _$alepha_server0 from "alepha/server";
+import * as _$alepha_orm0 from "alepha/orm";
+import * as _$alepha_api_jobs0 from "alepha/api/jobs";
+import { DateTimeProvider } from "alepha/datetime";
+import * as _$alepha_logger0 from "alepha/logger";
+import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
+import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
+//#region ../../src/orm/core/schemas/insertSchema.d.ts
+/**
+ * Transforms a TObject schema for insert operations.
+ * All default properties at the root level are made optional.
+ * Generated columns are excluded entirely.
+ *
+ * @example
+ * Before: { name: string; age: number(default=0); fullName: generated }
+ * After:  { name: string; age?: number; }
+ */
+type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"] as T["properties"][K] extends {
+  [PG_GENERATED]: any;
+} ? never : K]: T["properties"][K] extends {
+  [PG_DEFAULT]: any;
+} | {
+  "~optional": true;
+} ? TOptional<T["properties"][K]> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/core/schemas/updateSchema.d.ts
+/**
+ * Transforms a TObject schema for update operations.
+ * All optional properties at the root level are made nullable (i.e., `T | null`).
+ * Generated columns are excluded entirely.
+ *
+ * @example
+ * Before: { name?: string; age: number; fullName: generated }
+ * After:  { name?: string | null; age: number; }
+ */
+type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"] as T["properties"][K] extends {
+  [PG_GENERATED]: any;
+} ? never : K]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/core/primitives/$entity.d.ts
+interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
+  /**
+   * The database table name that will be created for this entity.
+   * If not provided, name will be inferred from the $repository variable name.
+   */
+  name: string;
+  /**
+   * TypeBox schema defining the table structure and column types.
+   */
+  schema: T;
+  /**
+   * Database indexes to create for query optimization.
+   */
+  indexes?: (Keys | {
+    /**
+     * Single column to index.
+     */
+    column: Keys;
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
+  } | {
+    /**
+     * Multiple columns for composite index (order matters for query optimization).
+     */
+    columns: Keys[];
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
+  } | {
+    /**
+     * SQL expressions for expression-based indexes.
+     *
+     * Can include column references and SQL functions like `LOWER()`, `UPPER()`, etc.
+     * Columns and expressions can be mixed together.
+     *
+     * @example
+     * ```ts
+     * // Case-insensitive unique username per realm
+     * indexes: [{
+     *   expressions: (self) => [self.realm, sql`LOWER(${self.username})`],
+     *   unique: true,
+     *   name: "users_realm_username_lower_idx",
+     * }]
+     * ```
+     */
+    expressions: (self: Record<Keys & string, any>) => (SQL | any)[];
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
+  })[];
+  /**
+   * Foreign key constraints to maintain referential integrity.
+   */
+  foreignKeys?: Array<{
+    /**
+     * Optional name for the foreign key constraint.
+     */
+    name?: string;
+    /**
+     * Local columns that reference the foreign table.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Referenced columns in the foreign table.
+     * Must be EntityColumn references from other entities.
+     */
+    foreignColumns: Array<() => EntityColumn<any>>;
+  }>;
+  /**
+   * Additional table constraints for data validation.
+   *
+   * Constraints enforce business rules at the database level, providing
+   * an additional layer of data integrity beyond application validation.
+   *
+   * **Constraint Types**:
+   * - **Unique constraints**: Prevent duplicate values across columns
+   * - **Check constraints**: Enforce custom validation rules with SQL expressions
+   *
+   * @example
+   * ```ts
+   * constraints: [
+   *   {
+   *     name: "unique_user_email",
+   *     columns: ["email"],
+   *     unique: true
+   *   },
+   *   {
+   *     name: "valid_age_range",
+   *     columns: ["age"],
+   *     check: sql`age >= 0 AND age <= 150`
+   *   },
+   *   {
+   *     name: "unique_user_username_per_tenant",
+   *     columns: ["tenantId", "username"],
+   *     unique: true
+   *   }
+   * ]
+   * ```
+   */
+  constraints?: Array<{
+    /**
+     * Columns involved in this constraint.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Optional name for the constraint.
+     */
+    name?: string;
+    /**
+     * Whether this is a unique constraint.
+     */
+    unique?: boolean | {};
+    /**
+     * SQL expression for check constraint validation.
+     */
+    check?: SQL;
+  }>;
+  /**
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
+  config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
+}
+declare class EntityPrimitive<T extends TObject = TObject> {
+  readonly options: EntityPrimitiveOptions<T>;
+  constructor(options: EntityPrimitiveOptions<T>);
+  alias(alias: string): this;
+  get cols(): EntityColumns<T>;
+  get name(): string;
+  get schema(): T;
+  get insertSchema(): TObjectInsert<T>;
+  get updateSchema(): TObjectUpdate<T>;
+}
+/**
+ * Convert a schema to columns.
+ */
+type FromSchema<T extends TObject> = { [key in keyof T["properties"]]: PgColumnBuilderBase };
+type EntityColumn<T extends TObject> = {
+  name: string;
+  entity: EntityPrimitive<T>;
+};
+type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
+//#endregion
+//#region ../../src/orm/core/constants/PG_SYMBOLS.d.ts
+declare const PG_DEFAULT: unique symbol;
+declare const PG_PRIMARY_KEY: unique symbol;
+declare const PG_CREATED_AT: unique symbol;
+declare const PG_UPDATED_AT: unique symbol;
+declare const PG_DELETED_AT: unique symbol;
+declare const PG_VERSION: unique symbol;
+declare const PG_IDENTITY: unique symbol;
+declare const PG_ENUM: unique symbol;
+declare const PG_REF: unique symbol;
+declare const PG_GENERATED: unique symbol;
+declare const PG_ORGANIZATION: unique symbol;
+/**
+ * @deprecated Use `PG_IDENTITY` instead.
+ */
+declare const PG_SERIAL: unique symbol;
+type PgSymbols = {
+  [PG_DEFAULT]: {};
+  [PG_PRIMARY_KEY]: {};
+  [PG_CREATED_AT]: {};
+  [PG_UPDATED_AT]: {};
+  [PG_DELETED_AT]: {};
+  [PG_VERSION]: {};
+  [PG_IDENTITY]: PgIdentityOptions;
+  [PG_REF]: PgRefOptions;
+  [PG_ENUM]: PgEnumOptions;
+  [PG_GENERATED]: PgGeneratedOptions;
+  [PG_ORGANIZATION]: {};
+  /**
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
+  [PG_SERIAL]: {};
+};
+type PgSymbolKeys = keyof PgSymbols;
+type PgIdentityOptions = {
+  mode: "always" | "byDefault";
+} & PgSequenceOptions & {
+  name?: string;
+};
+interface PgEnumOptions {
+  name?: string;
+  description?: string;
+}
+interface PgGeneratedOptions {
+  /**
+   * SQL expression for the generated column.
+   */
+  expression: SQL;
+  /**
+   * Storage mode for the generated column.
+   * - `"stored"` — value is computed on write and stored on disk (default for PostgreSQL).
+   * - `"virtual"` — value is computed on read (default for SQLite).
+   */
+  mode?: "stored" | "virtual";
+}
+interface PgRefOptions {
+  ref: () => {
+    name: string;
+    entity: EntityPrimitive;
+  };
+  actions?: {
+    onUpdate?: UpdateDeleteAction;
+    onDelete?: UpdateDeleteAction;
+  };
+}
+//#endregion
+//#region ../../src/orm/core/helpers/pgAttr.d.ts
+/**
+ * Type representation.
+ */
+type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
+//#endregion
+//#region ../../src/orm/core/schemas/databaseEnvSchema.d.ts
+/**
+ * Base database environment schema.
+ *
+ * Defines the `DATABASE_URL` connection string used by all ORM providers
+ * to determine the database driver and connection target.
+ *
+ * Supported URL formats:
+ * - `sqlite://:memory:` or `sqlite://./path/to/db` — SQLite (Node.js or Bun)
+ * - `postgres://user:password@host:port/database` — PostgreSQL (Node.js or Bun)
+ * - `pglite://:memory:` or `pglite://./path` — PGlite (embedded Postgres)
+ * - `d1://BINDING_NAME` — Cloudflare D1
+ * - `hyperdrive://BINDING_NAME` — Cloudflare Hyperdrive
+ */
+declare const databaseEnvSchema: _$alepha.TObject<{
+  DATABASE_URL: _$alepha.TOptional<_$alepha.TString>;
+  /**
+   * Enable or disable push-based schema synchronization (drizzle-kit push).
+   *
+   * Defaults to `true` in development and test, `false` in production.
+   * Set to `false` in development to skip automatic schema sync
+   * (e.g. when managing migrations manually).
+   */
+  DATABASE_SYNC: _$alepha.TOptional<_$alepha.TBoolean>;
+}>;
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof databaseEnvSchema>> {}
+} //# sourceMappingURL=databaseEnvSchema.d.ts.map
+//#endregion
+//#region ../../src/billing/entities/paymentIntents.d.ts
+declare const paymentIntents: _$alepha_orm0.EntityPrimitive<_$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+  amount: _$alepha.TInteger;
+  currency: _$alepha.TString;
+  status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+  providerRef: _$alepha.TOptional<_$alepha.TString>;
+  providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+  metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+  paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+  userId: _$alepha.TOptional<_$alepha.TString>;
+}>>;
+type PaymentIntentEntity = Static<typeof paymentIntents.schema>;
+//#endregion
+//#region ../../src/billing/entities/refunds.d.ts
+declare const refunds: _$alepha_orm0.EntityPrimitive<_$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+  intentId: _$alepha.TString;
+  amount: _$alepha.TInteger;
+  currency: _$alepha.TString;
+  status: _$alepha.TUnsafe<"processing" | "failed" | "pending" | "completed">;
+  reason: _$alepha.TOptional<_$alepha.TString>;
+  providerRef: _$alepha.TOptional<_$alepha.TString>;
+}>>;
+type RefundEntity = Static<typeof refunds.schema>;
+//#endregion
+//#region ../../src/billing/providers/BillingProvider.d.ts
+interface CreateSessionResult {
+  url: string;
+  providerRef: string;
+}
+interface RefundResult {
+  providerRef: string;
+}
+interface WebhookEvent {
+  providerRef: string;
+  status: string;
+  raw: unknown;
+}
+interface CreatePaymentMethodResult {
+  providerRef: string;
+  type: string;
+  brand?: string;
+  last4?: string;
+  expMonth?: number;
+  expYear?: number;
+}
+declare abstract class BillingProvider {
+  /**
+   * Create a checkout session with the PSP.
+   * Returns a URL to redirect the user to, and the PSP's reference ID.
+   */
+  abstract createSession(intent: PaymentIntentEntity, options: {
+    returnUrl: string;
+    authorize?: boolean;
+  }): Promise<CreateSessionResult>;
+  /**
+   * Capture a previously authorized payment.
+   * Amount can differ from the original authorization (partial capture).
+   */
+  abstract capturePayment(providerRef: string, amount: number): Promise<void>;
+  /**
+   * Void/cancel a previously authorized payment before capture.
+   */
+  abstract voidPayment(providerRef: string): Promise<void>;
+  /**
+   * Refund a captured payment (partial or full).
+   */
+  abstract refundPayment(providerRef: string, amount: number): Promise<RefundResult>;
+  /**
+   * Parse an incoming PSP webhook request into a normalized event.
+   */
+  abstract parseWebhook(request: Request): Promise<WebhookEvent>;
+  /**
+   * Store a payment method token with the PSP.
+   */
+  abstract createPaymentMethod(userId: string, token: string): Promise<CreatePaymentMethodResult>;
+  /**
+   * Delete a stored payment method from the PSP.
+   */
+  abstract deletePaymentMethod(providerRef: string): Promise<void>;
+  /**
+   * Expire/cancel a checkout session on the PSP side.
+   * Called during stale session cleanup.
+   */
+  abstract expireSession(providerRef: string): Promise<void>;
+}
+//#endregion
+//#region ../../src/billing/services/BillingService.d.ts
+declare class BillingService {
+  protected readonly alepha: Alepha;
+  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly dateTime: DateTimeProvider;
+  protected readonly provider: BillingProvider;
+  protected readonly intentRepo: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+    amount: _$alepha.TInteger;
+    currency: _$alepha.TString;
+    status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+    providerRef: _$alepha.TOptional<_$alepha.TString>;
+    providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+    userId: _$alepha.TOptional<_$alepha.TString>;
+  }>>;
+  protected readonly refundRepo: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+    intentId: _$alepha.TString;
+    amount: _$alepha.TInteger;
+    currency: _$alepha.TString;
+    status: _$alepha.TUnsafe<"processing" | "failed" | "pending" | "completed">;
+    reason: _$alepha.TOptional<_$alepha.TString>;
+    providerRef: _$alepha.TOptional<_$alepha.TString>;
+  }>>;
+  /**
+   * Expires stale payment intents that have been in "processing" status
+   * for more than 30 minutes. Runs every 15 minutes.
+   */
+  protected readonly expireStaleIntents: _$alepha_api_jobs0.JobPrimitive<_$alepha.TSchema>;
+  /**
+   * Create a new payment intent in "created" status.
+   */
+  createIntent(amount: number, currency: string, metadata?: unknown, options?: {
+    paymentMethodId?: string;
+    userId?: string;
+  }): Promise<PaymentIntentEntity>;
+  /**
+   * Create a checkout session with the payment provider and
+   * transition the intent to "processing".
+   */
+  createSession(intentId: string, returnUrl: string, authorize?: boolean): Promise<{
+    url: string;
+    intentId: string;
+  }>;
+  /**
+   * Handle an incoming webhook from the payment provider.
+   */
+  handleWebhook(request: Request): Promise<void>;
+  /**
+   * Process a webhook event by updating the intent status and emitting
+   * the corresponding billing event.
+   */
+  handleWebhookEvent(intentId: string, status: string, raw?: unknown): Promise<void>;
+  /**
+   * Capture a previously authorized payment. Optionally specify a different
+   * amount for partial capture.
+   */
+  capture(intentId: string, finalAmount?: number): Promise<PaymentIntentEntity>;
+  /**
+   * Void a previously authorized payment before capture.
+   */
+  void(intentId: string): Promise<PaymentIntentEntity>;
+  /**
+   * Refund a captured payment (partial or full).
+   */
+  refund(intentId: string, amount: number, reason?: string): Promise<RefundEntity>;
+  /**
+   * Record a cash or offline payment directly as captured,
+   * bypassing the checkout flow.
+   */
+  recordCashPayment(amount: number, currency: string, metadata?: unknown): Promise<PaymentIntentEntity>;
+  /**
+   * Cancel a payment intent that has not yet entered processing.
+   */
+  cancel(intentId: string): Promise<PaymentIntentEntity>;
+  /**
+   * Get a payment intent by ID. Throws NotFoundError if not found.
+   */
+  getIntent(intentId: string): Promise<PaymentIntentEntity>;
+  /**
+   * Find payment intents with optional filters and pagination.
+   */
+  findIntents(query: {
+    status?: string;
+    userId?: string;
+    sort?: string;
+    size?: number;
+    page?: number;
+  }): Promise<_$alepha.Page<_$alepha_orm0.PgStatic<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+    amount: _$alepha.TInteger;
+    currency: _$alepha.TString;
+    status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+    providerRef: _$alepha.TOptional<_$alepha.TString>;
+    providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+    userId: _$alepha.TOptional<_$alepha.TString>;
+  }>, _$alepha_orm0.PgRelationMap<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+    amount: _$alepha.TInteger;
+    currency: _$alepha.TString;
+    status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+    providerRef: _$alepha.TOptional<_$alepha.TString>;
+    providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+    userId: _$alepha.TOptional<_$alepha.TString>;
+  }>>>>>;
+  protected assertStatus(intent: PaymentIntentEntity, expected: PaymentIntentEntity["status"], operation: string): void;
+}
+//#endregion
+//#region ../../src/billing/controllers/AdminBillingController.d.ts
+declare class AdminBillingController {
+  protected readonly url = "/admin/billing";
+  protected readonly group = "admin:billing";
+  protected readonly billing: BillingService;
+  /**
+   * List payment intents with pagination and filtering.
+   */
+  readonly listIntents: _$alepha_server0.ActionPrimitiveFn<{
+    query: _$alepha.TObject<{
+      page: _$alepha.TOptional<_$alepha.TInteger>;
+      size: _$alepha.TOptional<_$alepha.TInteger>;
+      sort: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+    response: _$alepha.TPage<_$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+      providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>>;
+  }>;
+  /**
+   * Get a payment intent by ID.
+   */
+  readonly getIntent: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+      providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+  }>;
+  /**
+   * Capture an authorized intent.
+   */
+  readonly captureIntent: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    body: _$alepha.TObject<{
+      amount: _$alepha.TOptional<_$alepha.TInteger>;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+      providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+  }>;
+  /**
+   * Void an authorized intent.
+   */
+  readonly voidIntent: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+      providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+  }>;
+  /**
+   * Refund a captured intent.
+   */
+  readonly refundIntent: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    body: _$alepha.TObject<{
+      amount: _$alepha.TInteger;
+      reason: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      intentId: _$alepha.TString;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"processing" | "failed" | "pending" | "completed">;
+      reason: _$alepha.TOptional<_$alepha.TString>;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+  }>;
+  /**
+   * Cancel a created intent.
+   */
+  readonly cancelIntent: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+      providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+  }>;
+  /**
+   * Record a cash payment.
+   */
+  readonly recordCash: _$alepha_server0.ActionPrimitiveFn<{
+    body: _$alepha.TObject<{
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      amount: _$alepha.TInteger;
+      currency: _$alepha.TString;
+      status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+      providerRef: _$alepha.TOptional<_$alepha.TString>;
+      providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+      paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+      userId: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+  }>;
+  /**
+   * PSP webhook endpoint (not under /admin, no auth — verified by provider).
+   */
+  readonly webhook: _$alepha_server0.ActionPrimitiveFn<{
+    response: _$alepha.TObject<{
+      ok: _$alepha.TBoolean;
+      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
+      count: _$alepha.TOptional<_$alepha.TNumber>;
+    }>;
+  }>;
+}
+//#endregion
+//#region ../../src/billing/entities/paymentMethods.d.ts
+declare const paymentMethods: _$alepha_orm0.EntityPrimitive<_$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+  userId: _$alepha.TString;
+  type: _$alepha.TString;
+  brand: _$alepha.TOptional<_$alepha.TString>;
+  last4: _$alepha.TOptional<_$alepha.TString>;
+  expMonth: _$alepha.TOptional<_$alepha.TInteger>;
+  expYear: _$alepha.TOptional<_$alepha.TInteger>;
+  isDefault: _$alepha.TBoolean;
+  providerRef: _$alepha.TString;
+}>>;
+type PaymentMethodEntity = Static<typeof paymentMethods.schema>;
+//#endregion
+//#region ../../src/billing/services/PaymentMethodService.d.ts
+declare class PaymentMethodService {
+  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly provider: BillingProvider;
+  protected readonly methodRepo: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+    userId: _$alepha.TString;
+    type: _$alepha.TString;
+    brand: _$alepha.TOptional<_$alepha.TString>;
+    last4: _$alepha.TOptional<_$alepha.TString>;
+    expMonth: _$alepha.TOptional<_$alepha.TInteger>;
+    expYear: _$alepha.TOptional<_$alepha.TInteger>;
+    isDefault: _$alepha.TBoolean;
+    providerRef: _$alepha.TString;
+  }>>;
+  addPaymentMethod(userId: string, organizationId: string, token: string): Promise<PaymentMethodEntity>;
+  listPaymentMethods(userId: string): Promise<PaymentMethodEntity[]>;
+  removePaymentMethod(methodId: string, userId: string): Promise<void>;
+  setDefault(methodId: string, userId: string): Promise<PaymentMethodEntity>;
+}
+//#endregion
+//#region ../../src/billing/controllers/BillingController.d.ts
+declare class BillingController {
+  protected readonly url = "/billing";
+  protected readonly group = "billing";
+  protected readonly billing: BillingService;
+  protected readonly paymentMethods: PaymentMethodService;
+  /**
+   * List the current user's saved payment methods.
+   */
+  readonly listPaymentMethods: _$alepha_server0.ActionPrimitiveFn<{
+    response: _$alepha.TArray<_$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      userId: _$alepha.TString;
+      type: _$alepha.TString;
+      brand: _$alepha.TOptional<_$alepha.TString>;
+      last4: _$alepha.TOptional<_$alepha.TString>;
+      expMonth: _$alepha.TOptional<_$alepha.TInteger>;
+      expYear: _$alepha.TOptional<_$alepha.TInteger>;
+      isDefault: _$alepha.TBoolean;
+      providerRef: _$alepha.TString;
+    }>>;
+  }>;
+  /**
+   * Add a new payment method.
+   */
+  readonly addPaymentMethod: _$alepha_server0.ActionPrimitiveFn<{
+    body: _$alepha.TObject<{
+      token: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      userId: _$alepha.TString;
+      type: _$alepha.TString;
+      brand: _$alepha.TOptional<_$alepha.TString>;
+      last4: _$alepha.TOptional<_$alepha.TString>;
+      expMonth: _$alepha.TOptional<_$alepha.TInteger>;
+      expYear: _$alepha.TOptional<_$alepha.TInteger>;
+      isDefault: _$alepha.TBoolean;
+      providerRef: _$alepha.TString;
+    }>;
+  }>;
+  /**
+   * Remove a payment method.
+   */
+  readonly removePaymentMethod: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      ok: _$alepha.TBoolean;
+      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
+      count: _$alepha.TOptional<_$alepha.TNumber>;
+    }>;
+  }>;
+  /**
+   * Set a payment method as default.
+   */
+  readonly setDefaultPaymentMethod: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+      userId: _$alepha.TString;
+      type: _$alepha.TString;
+      brand: _$alepha.TOptional<_$alepha.TString>;
+      last4: _$alepha.TOptional<_$alepha.TString>;
+      expMonth: _$alepha.TOptional<_$alepha.TInteger>;
+      expYear: _$alepha.TOptional<_$alepha.TInteger>;
+      isDefault: _$alepha.TBoolean;
+      providerRef: _$alepha.TString;
+    }>;
+  }>;
+  /**
+   * Create a checkout session.
+   */
+  readonly createCheckout: _$alepha_server0.ActionPrimitiveFn<{
+    body: _$alepha.TObject<{
+      intentId: _$alepha.TString;
+      returnUrl: _$alepha.TString;
+      authorize: _$alepha.TOptional<_$alepha.TBoolean>;
+    }>;
+    response: _$alepha.TObject<{
+      url: _$alepha.TString;
+      intentId: _$alepha.TString;
+    }>;
+  }>;
+}
+//#endregion
+//#region ../../src/billing/errors/BillingError.d.ts
+declare class BillingError extends AlephaError {
+  readonly status = 400;
+}
+//#endregion
+//#region ../../src/billing/providers/MemoryBillingProvider.d.ts
+interface MemoryCharge {
+  providerRef: string;
+  amount: number;
+  status: string;
+}
+interface MemoryRefund {
+  providerRef: string;
+  chargeRef: string;
+  amount: number;
+}
+declare class MemoryBillingProvider implements BillingProvider {
+  protected readonly charges: Map<string, MemoryCharge>;
+  protected readonly refundRecords: Map<string, MemoryRefund>;
+  protected readonly methods: Map<string, CreatePaymentMethodResult>;
+  protected readonly expiredSessions: Set<string>;
+  createSession(intent: PaymentIntentEntity, options: {
+    returnUrl: string;
+    authorize?: boolean;
+  }): Promise<CreateSessionResult>;
+  capturePayment(providerRef: string, amount: number): Promise<void>;
+  voidPayment(providerRef: string): Promise<void>;
+  refundPayment(providerRef: string, amount: number): Promise<RefundResult>;
+  parseWebhook(request: Request): Promise<WebhookEvent>;
+  createPaymentMethod(userId: string, token: string): Promise<CreatePaymentMethodResult>;
+  deletePaymentMethod(providerRef: string): Promise<void>;
+  expireSession(providerRef: string): Promise<void>;
+  wasCharged(providerRef: string): boolean;
+  wasRefunded(providerRef: string): boolean;
+  wasExpired(providerRef: string): boolean;
+  getCharges(): MemoryCharge[];
+  getRefunds(): MemoryRefund[];
+}
+//#endregion
+//#region ../../src/billing/schemas/intentSchemas.d.ts
+declare const createIntentSchema: _$alepha.TObject<{
+  amount: _$alepha.TInteger;
+  currency: _$alepha.TString;
+  metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+  paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type CreateIntent = Static<typeof createIntentSchema>;
+declare const createCheckoutSchema: _$alepha.TObject<{
+  intentId: _$alepha.TString;
+  returnUrl: _$alepha.TString;
+  authorize: _$alepha.TOptional<_$alepha.TBoolean>;
+}>;
+type CreateCheckout = Static<typeof createCheckoutSchema>;
+declare const checkoutResponseSchema: _$alepha.TObject<{
+  url: _$alepha.TString;
+  intentId: _$alepha.TString;
+}>;
+type CheckoutResponse = Static<typeof checkoutResponseSchema>;
+declare const captureIntentSchema: _$alepha.TObject<{
+  amount: _$alepha.TOptional<_$alepha.TInteger>;
+}>;
+type CaptureIntent = Static<typeof captureIntentSchema>;
+declare const refundIntentSchema: _$alepha.TObject<{
+  amount: _$alepha.TInteger;
+  reason: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type RefundIntent = Static<typeof refundIntentSchema>;
+declare const recordCashSchema: _$alepha.TObject<{
+  amount: _$alepha.TInteger;
+  currency: _$alepha.TString;
+  metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+}>;
+type RecordCash = Static<typeof recordCashSchema>;
+declare const intentQuerySchema: _$alepha.TObject<{
+  page: _$alepha.TOptional<_$alepha.TInteger>;
+  size: _$alepha.TOptional<_$alepha.TInteger>;
+  sort: _$alepha.TOptional<_$alepha.TString>;
+  status: _$alepha.TOptional<_$alepha.TString>;
+  userId: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type IntentQuery = Static<typeof intentQuerySchema>;
+declare const intentResourceSchema: _$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  version: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_VERSION>, typeof _$alepha_orm0.PG_DEFAULT>;
+  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  organizationId: _$alepha_orm0.PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof _$alepha_orm0.PG_ORGANIZATION>;
+  amount: _$alepha.TInteger;
+  currency: _$alepha.TString;
+  status: _$alepha.TUnsafe<"created" | "processing" | "authorized" | "captured" | "voided" | "failed" | "cancelled" | "refunded" | "expired">;
+  providerRef: _$alepha.TOptional<_$alepha.TString>;
+  providerRaw: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+  metadata: _$alepha.TOptional<_$alepha.TRecord<string, _$alepha.TAny>>;
+  paymentMethodId: _$alepha.TOptional<_$alepha.TString>;
+  userId: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type IntentResource = Static<typeof intentResourceSchema>;
+//#endregion
+//#region ../../src/billing/schemas/paymentMethodSchemas.d.ts
+declare const addPaymentMethodSchema: _$alepha.TObject<{
+  token: _$alepha.TString;
+}>;
+type AddPaymentMethod = Static<typeof addPaymentMethodSchema>;
+declare const paymentMethodResourceSchema: _$alepha.TObject<{
+  id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+  userId: _$alepha.TString;
+  type: _$alepha.TString;
+  brand: _$alepha.TOptional<_$alepha.TString>;
+  last4: _$alepha.TOptional<_$alepha.TString>;
+  expMonth: _$alepha.TOptional<_$alepha.TInteger>;
+  expYear: _$alepha.TOptional<_$alepha.TInteger>;
+  isDefault: _$alepha.TBoolean;
+  providerRef: _$alepha.TString;
+}>;
+type PaymentMethodResource = Static<typeof paymentMethodResourceSchema>;
+//#endregion
+//#region ../../src/billing/schemas/refundSchemas.d.ts
+declare const refundResourceSchema: _$alepha.TObject<{
+  id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  version: PgAttr<PgAttr<_$alepha.TInteger, typeof PG_VERSION>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  organizationId: PgAttr<_$alepha.TOptional<_$alepha.TString>, typeof PG_ORGANIZATION>;
+  intentId: _$alepha.TString;
+  amount: _$alepha.TInteger;
+  currency: _$alepha.TString;
+  status: _$alepha.TUnsafe<"processing" | "failed" | "pending" | "completed">;
+  reason: _$alepha.TOptional<_$alepha.TString>;
+  providerRef: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type RefundResource = Static<typeof refundResourceSchema>;
+//#endregion
+//#region ../../src/billing/index.d.ts
+declare module "alepha" {
+  interface Hooks {
+    "billing:authorized": {
+      intentId: string;
+      amount: number;
+      currency: string;
+      metadata?: unknown;
+    };
+    "billing:captured": {
+      intentId: string;
+      amount: number;
+      currency: string;
+      metadata?: unknown;
+    };
+    "billing:failed": {
+      intentId: string;
+      amount: number;
+      currency: string;
+      metadata?: unknown;
+    };
+    "billing:voided": {
+      intentId: string;
+      amount: number;
+      currency: string;
+      metadata?: unknown;
+    };
+    "billing:refunded": {
+      intentId: string;
+      refundId: string;
+      amount: number;
+      currency: string;
+      metadata?: unknown;
+    };
+  }
+}
+declare const AlephaBilling: _$alepha.Service<_$alepha.Module>;
+//#endregion
+export { AddPaymentMethod, AdminBillingController, AlephaBilling, BillingController, BillingError, BillingProvider, BillingService, CaptureIntent, CheckoutResponse, CreateCheckout, CreateIntent, CreatePaymentMethodResult, CreateSessionResult, IntentQuery, IntentResource, MemoryBillingProvider, PaymentIntentEntity, PaymentMethodEntity, PaymentMethodResource, PaymentMethodService, RecordCash, RefundEntity, RefundIntent, RefundResource, RefundResult, WebhookEvent, addPaymentMethodSchema, captureIntentSchema, checkoutResponseSchema, createCheckoutSchema, createIntentSchema, intentQuerySchema, intentResourceSchema, paymentIntents, paymentMethodResourceSchema, paymentMethods, recordCashSchema, refundIntentSchema, refundResourceSchema, refunds };
+//# sourceMappingURL=index.d.ts.map