@happyvertical/smrt-commerce 0.57.10 → 0.57.12

package/dist/chunks/{tenant-money-barrier-CG78Xxja.js → tenant-money-barrier-DXnJWxiZ.js}

@@ -63,8 +63,8 @@ var TaxSettings = class extends SmrtObject {
 			await assertTenantMoneyCurrent(this.db, firstTenant);
 		}
 		return this.withTransaction(async () => {
-			const { TaxCodeCollection } = await import("./TaxCodeCollection-CbTBWO8z.js").then((n) => n.n);
-			const { TaxComponentCollection } = await import("./TaxComponentCollection-VZ_cGr2n.js").then((n) => n.n);
+			const { TaxCodeCollection } = await import("./TaxCodeCollection-CIC1skxr.js").then((n) => n.n);
+			const { TaxComponentCollection } = await import("./TaxComponentCollection-BHBV-_1J.js").then((n) => n.n);
 			const codes = await TaxCodeCollection.create({ db: this.db });
 			const components = await TaxComponentCollection.create({ db: this.db });
 			for (const id of [this.defaultSalesTaxCodeId, this.defaultPurchaseTaxCodeId].filter(Boolean)) {
@@ -252,4 +252,4 @@ async function withTenantMoneyCollectionRead(db, tenantId, operation) {
 //#endregion
 export { materializeTenantTaxSettings as a, TaxSettings as c, TaxSettingsCollection as i, withTenantMoneyCollectionRead as n, createOrLoadTaxSeed as o, withTenantMoneyRuntime as r, deterministicTaxId as s, lockTenantMoneyRuntime as t };
 
-//# sourceMappingURL=tenant-money-barrier-CG78Xxja.js.map
+//# sourceMappingURL=tenant-money-barrier-DXnJWxiZ.js.map

package/dist/chunks/{tenant-money-barrier-CG78Xxja.js.map → tenant-money-barrier-DXnJWxiZ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"tenant-money-barrier-CG78Xxja.js","names":[],"sources":["../../src/models/TaxSettings.ts","../../src/tax/identity.ts","../../src/collections/TaxSettingsCollection.ts","../../src/tenant-money-barrier.ts"],"sourcesContent":["import { field, foreignKey, SmrtObject, smrt } from '@happyvertical/smrt-core';\nimport {\n  getTenantId,\n  TenantScoped,\n  tenantId,\n} from '@happyvertical/smrt-tenancy';\nimport type { TaxSettingsOptions } from '../types/index.js';\n\nexport interface TaxRegistration {\n  taxComponentId: string;\n  number: string;\n  label: string;\n}\n\n/** Tenant-level defaults and registration numbers for tax determination. */\n@TenantScoped({ mode: 'required' })\n@smrt({\n  conflictColumns: ['tenant_id'],\n  api: {\n    include: ['get', 'create', 'update'],\n    writable: [\n      'defaultSalesTaxCodeId',\n      'defaultPurchaseTaxCodeId',\n      'defaultLineAmountType',\n      'taxRoundingScope',\n      'taxRegistrations',\n    ],\n  },\n  mcp: { include: ['get'] },\n  cli: { skipApiCheck: true },\n})\nexport class TaxSettings extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  @tenantId()\n  tenantId = '';\n\n  @foreignKey('TaxCode', {\n    description: 'The default tax code for sales documents.',\n  })\n  defaultSalesTaxCodeId = '';\n\n  @foreignKey('TaxCode', {\n    description: 'The default tax code for purchase documents.',\n  })\n  defaultPurchaseTaxCodeId = '';\n\n  @field({\n    description:\n      'Whether new document amounts are exclusive, inclusive or out of scope.',\n  })\n  defaultLineAmountType: 'exclusive' | 'inclusive' | 'none' = 'exclusive';\n\n  @field({ description: 'Whether components round per line or per document.' })\n  taxRoundingScope: 'line' | 'document' = 'line';\n\n  /** Stored JSON is guarded through the typed accessor below. */\n  taxRegistrationsJson = '[]';\n\n  @field({\n    sensitive: true,\n    transient: true,\n    description:\n      'Registration numbers by tax component, for issued-document snapshots.',\n  })\n  get taxRegistrations(): TaxRegistration[] {\n    try {\n      const value: unknown = JSON.parse(this.taxRegistrationsJson);\n      if (!Array.isArray(value)) return [];\n      return value.filter(\n        (entry): entry is TaxRegistration =>\n          !!entry &&\n          typeof entry === 'object' &&\n          typeof (entry as TaxRegistration).taxComponentId === 'string' &&\n          typeof (entry as TaxRegistration).number === 'string' &&\n          typeof (entry as TaxRegistration).label === 'string',\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  set taxRegistrations(value: TaxRegistration[] | string) {\n    this.taxRegistrationsJson =\n      typeof value === 'string' ? value : JSON.stringify(value);\n  }\n\n  constructor(options: TaxSettingsOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.defaultSalesTaxCodeId !== undefined)\n      this.defaultSalesTaxCodeId = options.defaultSalesTaxCodeId;\n    if (options.defaultPurchaseTaxCodeId !== undefined)\n      this.defaultPurchaseTaxCodeId = options.defaultPurchaseTaxCodeId;\n    if (options.defaultLineAmountType !== undefined)\n      this.defaultLineAmountType = options.defaultLineAmountType;\n    if (options.taxRoundingScope !== undefined)\n      this.taxRoundingScope = options.taxRoundingScope;\n    if (options.taxRegistrations !== undefined)\n      this.taxRegistrations = structuredClone(options.taxRegistrations);\n  }\n\n  override async save(): Promise<this> {\n    if (\n      !['exclusive', 'inclusive', 'none'].includes(this.defaultLineAmountType)\n    )\n      throw new Error('Tax settings defaultLineAmountType is invalid');\n    if (!['line', 'document'].includes(this.taxRoundingScope))\n      throw new Error('Tax settings taxRoundingScope is invalid');\n    const registrations = this.parsedRegistrations();\n    if (!registrations)\n      throw new Error('Tax registrations must be a valid JSON array');\n    if (\n      registrations.some(\n        (entry) =>\n          !entry.taxComponentId || !entry.number.trim() || !entry.label.trim(),\n      )\n    )\n      throw new Error('Tax registrations require component, number and label');\n    // A tenant's first settings row must not adopt documents an earlier\n    // version wrote: that tenant needs the upgrade, not fresh defaults.\n    // The tenant may still be empty here: tenancy stamps it during save.\n    const firstTenant = this.isPersisted\n      ? ''\n      : this.tenantId || getTenantId() || '';\n    if (firstTenant) {\n      const { assertTenantMoneyCurrent } = await import('../upgrade/detect.js');\n      await assertTenantMoneyCurrent(this.db, firstTenant);\n    }\n    return this.withTransaction(async () => {\n      const { TaxCodeCollection } = await import(\n        '../collections/TaxCodeCollection.js'\n      );\n      const { TaxComponentCollection } = await import(\n        '../collections/TaxComponentCollection.js'\n      );\n      const codes = await TaxCodeCollection.create({ db: this.db });\n      const components = await TaxComponentCollection.create({ db: this.db });\n      for (const id of [\n        this.defaultSalesTaxCodeId,\n        this.defaultPurchaseTaxCodeId,\n      ].filter(Boolean)) {\n        const code = await codes.get({ id }, { cache: false });\n        if (!code || code.tenantId !== this.tenantId)\n          throw new Error(\n            'Tax setting default codes must belong to its tenant',\n          );\n      }\n      for (const registration of registrations) {\n        const component = await components.get(\n          { id: registration.taxComponentId },\n          { cache: false },\n        );\n        if (!component || component.tenantId !== this.tenantId)\n          throw new Error(\n            'Tax setting registrations must belong to its tenant',\n          );\n      }\n      return (await super.save()) as this;\n    });\n  }\n\n  private parsedRegistrations(): TaxRegistration[] | null {\n    try {\n      const value: unknown = JSON.parse(this.taxRegistrationsJson);\n      if (!Array.isArray(value)) return null;\n      if (\n        value.some(\n          (entry) =>\n            !entry ||\n            typeof entry !== 'object' ||\n            typeof (entry as TaxRegistration).taxComponentId !== 'string' ||\n            typeof (entry as TaxRegistration).number !== 'string' ||\n            typeof (entry as TaxRegistration).label !== 'string',\n        )\n      )\n        return null;\n      return value as TaxRegistration[];\n    } catch {\n      return null;\n    }\n  }\n}\n","/** Stable UUID identities make tenant tax bootstrap retry and race safe. */\nexport async function deterministicTaxId(\n  tenantId: string,\n  kind: 'code' | 'component' | 'settings' | 'report',\n  key: string,\n): Promise<string> {\n  if (!tenantId.trim() || !key.trim())\n    throw new Error('Tax bootstrap identity requires tenant and key');\n  const bytes = new TextEncoder().encode(\n    JSON.stringify(['commerce-tax', tenantId, kind, key]),\n  );\n  const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));\n  const uuid = digest.slice(0, 16);\n  uuid[6] = (uuid[6] & 0x0f) | 0x50;\n  uuid[8] = (uuid[8] & 0x3f) | 0x80;\n  const hex = Array.from(uuid, (byte) => byte.toString(16).padStart(2, '0'));\n  const joined = hex.join('');\n  return `${joined.slice(0, 8)}-${joined.slice(8, 12)}-${joined.slice(12, 16)}-${joined.slice(16, 20)}-${joined.slice(20)}`;\n}\n\n/** A racing deterministic insert loses safely and reloads the committed row. */\nexport async function createOrLoadTaxSeed<T>(\n  create: () => Promise<T>,\n  load: () => Promise<T | null | undefined>,\n): Promise<T> {\n  for (let attempt = 0; attempt < 3; attempt++) {\n    try {\n      return await create();\n    } catch (error) {\n      const code = (error as { code?: unknown } | null)?.code;\n      if (code === 'RUNTIME_REVISION_CONFLICT' && attempt < 2) continue;\n      if (code !== 'VALIDATION_UNIQUE_CONSTRAINT' && code !== '23505')\n        throw error;\n      const winner = await load();\n      if (!winner) throw error;\n      return winner;\n    }\n  }\n  throw new Error('Tax seed retry exhausted');\n}\n","import {\n  isEmbeddedDatabase,\n  isPostgresDatabase,\n  SmrtCollection,\n  withEmbeddedWriteTransaction,\n} from '@happyvertical/smrt-core';\nimport type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';\nimport { lockDocumentMoneyParents } from '../document-money-internal.js';\nimport { TaxSettings } from '../models/TaxSettings.js';\nimport { MoneyValidationError } from '../money.js';\nimport { createOrLoadTaxSeed, deterministicTaxId } from '../tax/identity.js';\nimport { assertTenantMoneyCurrent } from '../upgrade/detect.js';\n\n/**\n * Serialize settings-row creation for one tenant on PostgreSQL. The lock is\n * transaction-scoped; embedded engines are already single-writer through the\n * core embedded write queue that every model transaction enters.\n */\nasync function lockTenantSettingsCreation(\n  db: DatabaseInterface,\n  tenantId: string,\n): Promise<void> {\n  if (!isPostgresDatabase(db)) return;\n  await db.query(\n    'SELECT pg_advisory_xact_lock(hashtext(CAST(? AS TEXT)))',\n    `smrt-commerce-tax-settings:${tenantId}`,\n  );\n}\n\n/**\n * @internal Create a tenant's missing settings row exactly once, with the\n * model defaults. Creation serializes on a tenant advisory lock (PostgreSQL)\n * or the embedded write queue and re-reads before inserting, so racing first\n * writers converge on one row. An existing row is never changed.\n */\nexport async function materializeTenantTaxSettings(\n  db: DatabaseInterface,\n  tenantId: string,\n): Promise<void> {\n  const id = await deterministicTaxId(tenantId, 'settings', 'default');\n  await withEmbeddedWriteTransaction(db, isEmbeddedDatabase(db), async (tx) => {\n    await lockTenantSettingsCreation(tx, tenantId);\n    const settings = await TaxSettingsCollection.create({ db: tx });\n    if (await settings.getForTenant(tenantId)) return;\n    await createOrLoadTaxSeed(\n      () => settings.create({ id, tenantId }),\n      async () =>\n        (await settings.list({ where: { tenantId }, limit: 1 }))[0] ?? null,\n    );\n  });\n}\n\nexport class TaxSettingsCollection extends SmrtCollection<TaxSettings> {\n  static readonly _itemClass = TaxSettings;\n\n  /**\n   * Load the tenant's settings row, creating it once when missing. A tenant\n   * whose stored documents predate tenant tax settings is refused with\n   * `COMMERCE_DATA_NEEDS_UPGRADE` rather than given fresh defaults.\n   */\n  async getOrCreateForTenant(tenantId: string): Promise<TaxSettings> {\n    await assertTenantMoneyCurrent(this.db, tenantId);\n    const existing = await this.getForTenant(tenantId);\n    if (existing) return existing;\n    await materializeTenantTaxSettings(this.db, tenantId);\n    const created = await this.getForTenant(tenantId);\n    if (!created)\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant tax settings could not be materialized',\n      );\n    return created;\n  }\n\n  async getForTenant(tenantId: string): Promise<TaxSettings | null> {\n    const listed = (await this.list({ where: { tenantId }, limit: 1 }))[0];\n    if (!listed?.id) return listed ?? null;\n    return (await this.get({ id: listed.id }, { cache: false })) ?? null;\n  }\n\n  /** @internal Lock and re-read the tenant's settings row on this transaction. */\n  async lockForTenant(tenantId: string): Promise<TaxSettings> {\n    const first = await this.getOrCreateForTenant(tenantId);\n    if (!first.id)\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant tax settings have no identity',\n      );\n    await lockDocumentMoneyParents([\n      { id: first.id, tenantId, collection: this },\n    ]);\n    const locked = await this.getForTenant(tenantId);\n    if (!locked || locked.id !== first.id)\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant tax settings changed while acquiring the lock',\n      );\n    return locked;\n  }\n}\n","/** Tenant serialization point for commerce money runtime work. */\n\nimport type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';\nimport { TaxSettingsCollection } from './collections/TaxSettingsCollection.js';\nimport { withDocumentMoneyTransaction } from './document-money-internal.js';\nimport type { TaxSettings } from './models/TaxSettings.js';\nimport { MoneyValidationError } from './money.js';\nimport { assertTenantMoneyCurrent } from './upgrade/detect.js';\n\ndeclare const tenantMoneyScopeBrand: unique symbol;\n\n/** Transaction-affine proof that a tenant's settings row is locked on `db`. */\nexport interface TenantMoneyRuntimeScope {\n  readonly db: DatabaseInterface;\n  readonly tenantId: string;\n  readonly settings: TaxSettings;\n  readonly phase: 'runtime';\n  readonly [tenantMoneyScopeBrand]: true;\n}\n\nfunction requiredText(value: string, label: string): string {\n  if (!value || value.trim() !== value)\n    throw new MoneyValidationError(\n      'INVALID_MONEY_INPUT',\n      `${label} must be a nonempty trimmed string`,\n    );\n  return value;\n}\n\nconst activeRuntimeScopes = new WeakMap<\n  object,\n  Map<string, TenantMoneyRuntimeScope>\n>();\n\n/**\n * Lock and re-read the tenant's tax settings row before runtime money work,\n * creating it once when missing. Old-format money data is refused first with\n * `COMMERCE_DATA_NEEDS_UPGRADE`.\n */\nexport async function lockTenantMoneyRuntime(\n  tx: DatabaseInterface,\n  tenantId: string,\n): Promise<TaxSettings> {\n  requiredText(tenantId, 'Money tenant');\n  await assertTenantMoneyCurrent(tx, tenantId);\n  return (await TaxSettingsCollection.create({ db: tx })).lockForTenant(\n    tenantId,\n  );\n}\n\n/**\n * Run tenant money work under the tenant settings lock on exactly one\n * executor.\n *\n * Supplying an existing scope proves re-entry on the same executor. Calls made\n * through the owning transaction wrapper also reuse its exact registered\n * executor. No optional adapter-property heuristic can grant this capability.\n */\nexport async function withTenantMoneyRuntime<T>(\n  db: DatabaseInterface,\n  tenantId: string,\n  operation: (scope: TenantMoneyRuntimeScope) => Promise<T>,\n  existingScope?: TenantMoneyRuntimeScope,\n): Promise<T> {\n  requiredText(tenantId, 'Money tenant');\n  if (existingScope) {\n    if (\n      existingScope.phase !== 'runtime' ||\n      existingScope.db !== db ||\n      existingScope.tenantId !== tenantId\n    )\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant money runtime scope does not match the requested executor',\n      );\n    return operation(existingScope);\n  }\n  return withDocumentMoneyTransaction(db, async (tx) => {\n    const active = activeRuntimeScopes.get(tx as object)?.get(tenantId);\n    if (active) return operation(active);\n    const settings = await lockTenantMoneyRuntime(tx, tenantId);\n    const scope = {\n      db: tx,\n      tenantId,\n      settings,\n      phase: 'runtime',\n    } as TenantMoneyRuntimeScope;\n    const scopes = activeRuntimeScopes.get(tx as object) ?? new Map();\n    scopes.set(tenantId, scope);\n    activeRuntimeScopes.set(tx as object, scopes);\n    try {\n      return await operation(scope);\n    } finally {\n      scopes.delete(tenantId);\n      if (scopes.size === 0) activeRuntimeScopes.delete(tx as object);\n    }\n  });\n}\n\n/**\n * @internal Guard a generated money-document collection read: a tenant whose\n * data predates the current money model is refused before any row is read.\n */\nexport async function withTenantMoneyCollectionRead<T>(\n  db: DatabaseInterface,\n  tenantId: string,\n  operation: (boundDb: DatabaseInterface) => Promise<T>,\n): Promise<T> {\n  await assertTenantMoneyCurrent(db, tenantId);\n  return operation(db);\n}\n"],"mappings":"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"}
+{"version":3,"file":"tenant-money-barrier-DXnJWxiZ.js","names":[],"sources":["../../src/models/TaxSettings.ts","../../src/tax/identity.ts","../../src/collections/TaxSettingsCollection.ts","../../src/tenant-money-barrier.ts"],"sourcesContent":["import { field, foreignKey, SmrtObject, smrt } from '@happyvertical/smrt-core';\nimport {\n  getTenantId,\n  TenantScoped,\n  tenantId,\n} from '@happyvertical/smrt-tenancy';\nimport type { TaxSettingsOptions } from '../types/index.js';\n\nexport interface TaxRegistration {\n  taxComponentId: string;\n  number: string;\n  label: string;\n}\n\n/** Tenant-level defaults and registration numbers for tax determination. */\n@TenantScoped({ mode: 'required' })\n@smrt({\n  conflictColumns: ['tenant_id'],\n  api: {\n    include: ['get', 'create', 'update'],\n    writable: [\n      'defaultSalesTaxCodeId',\n      'defaultPurchaseTaxCodeId',\n      'defaultLineAmountType',\n      'taxRoundingScope',\n      'taxRegistrations',\n    ],\n  },\n  mcp: { include: ['get'] },\n  cli: { skipApiCheck: true },\n})\nexport class TaxSettings extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  @tenantId()\n  tenantId = '';\n\n  @foreignKey('TaxCode', {\n    description: 'The default tax code for sales documents.',\n  })\n  defaultSalesTaxCodeId = '';\n\n  @foreignKey('TaxCode', {\n    description: 'The default tax code for purchase documents.',\n  })\n  defaultPurchaseTaxCodeId = '';\n\n  @field({\n    description:\n      'Whether new document amounts are exclusive, inclusive or out of scope.',\n  })\n  defaultLineAmountType: 'exclusive' | 'inclusive' | 'none' = 'exclusive';\n\n  @field({ description: 'Whether components round per line or per document.' })\n  taxRoundingScope: 'line' | 'document' = 'line';\n\n  /** Stored JSON is guarded through the typed accessor below. */\n  taxRegistrationsJson = '[]';\n\n  @field({\n    sensitive: true,\n    transient: true,\n    description:\n      'Registration numbers by tax component, for issued-document snapshots.',\n  })\n  get taxRegistrations(): TaxRegistration[] {\n    try {\n      const value: unknown = JSON.parse(this.taxRegistrationsJson);\n      if (!Array.isArray(value)) return [];\n      return value.filter(\n        (entry): entry is TaxRegistration =>\n          !!entry &&\n          typeof entry === 'object' &&\n          typeof (entry as TaxRegistration).taxComponentId === 'string' &&\n          typeof (entry as TaxRegistration).number === 'string' &&\n          typeof (entry as TaxRegistration).label === 'string',\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  set taxRegistrations(value: TaxRegistration[] | string) {\n    this.taxRegistrationsJson =\n      typeof value === 'string' ? value : JSON.stringify(value);\n  }\n\n  constructor(options: TaxSettingsOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.defaultSalesTaxCodeId !== undefined)\n      this.defaultSalesTaxCodeId = options.defaultSalesTaxCodeId;\n    if (options.defaultPurchaseTaxCodeId !== undefined)\n      this.defaultPurchaseTaxCodeId = options.defaultPurchaseTaxCodeId;\n    if (options.defaultLineAmountType !== undefined)\n      this.defaultLineAmountType = options.defaultLineAmountType;\n    if (options.taxRoundingScope !== undefined)\n      this.taxRoundingScope = options.taxRoundingScope;\n    if (options.taxRegistrations !== undefined)\n      this.taxRegistrations = structuredClone(options.taxRegistrations);\n  }\n\n  override async save(): Promise<this> {\n    if (\n      !['exclusive', 'inclusive', 'none'].includes(this.defaultLineAmountType)\n    )\n      throw new Error('Tax settings defaultLineAmountType is invalid');\n    if (!['line', 'document'].includes(this.taxRoundingScope))\n      throw new Error('Tax settings taxRoundingScope is invalid');\n    const registrations = this.parsedRegistrations();\n    if (!registrations)\n      throw new Error('Tax registrations must be a valid JSON array');\n    if (\n      registrations.some(\n        (entry) =>\n          !entry.taxComponentId || !entry.number.trim() || !entry.label.trim(),\n      )\n    )\n      throw new Error('Tax registrations require component, number and label');\n    // A tenant's first settings row must not adopt documents an earlier\n    // version wrote: that tenant needs the upgrade, not fresh defaults.\n    // The tenant may still be empty here: tenancy stamps it during save.\n    const firstTenant = this.isPersisted\n      ? ''\n      : this.tenantId || getTenantId() || '';\n    if (firstTenant) {\n      const { assertTenantMoneyCurrent } = await import('../upgrade/detect.js');\n      await assertTenantMoneyCurrent(this.db, firstTenant);\n    }\n    return this.withTransaction(async () => {\n      const { TaxCodeCollection } = await import(\n        '../collections/TaxCodeCollection.js'\n      );\n      const { TaxComponentCollection } = await import(\n        '../collections/TaxComponentCollection.js'\n      );\n      const codes = await TaxCodeCollection.create({ db: this.db });\n      const components = await TaxComponentCollection.create({ db: this.db });\n      for (const id of [\n        this.defaultSalesTaxCodeId,\n        this.defaultPurchaseTaxCodeId,\n      ].filter(Boolean)) {\n        const code = await codes.get({ id }, { cache: false });\n        if (!code || code.tenantId !== this.tenantId)\n          throw new Error(\n            'Tax setting default codes must belong to its tenant',\n          );\n      }\n      for (const registration of registrations) {\n        const component = await components.get(\n          { id: registration.taxComponentId },\n          { cache: false },\n        );\n        if (!component || component.tenantId !== this.tenantId)\n          throw new Error(\n            'Tax setting registrations must belong to its tenant',\n          );\n      }\n      return (await super.save()) as this;\n    });\n  }\n\n  private parsedRegistrations(): TaxRegistration[] | null {\n    try {\n      const value: unknown = JSON.parse(this.taxRegistrationsJson);\n      if (!Array.isArray(value)) return null;\n      if (\n        value.some(\n          (entry) =>\n            !entry ||\n            typeof entry !== 'object' ||\n            typeof (entry as TaxRegistration).taxComponentId !== 'string' ||\n            typeof (entry as TaxRegistration).number !== 'string' ||\n            typeof (entry as TaxRegistration).label !== 'string',\n        )\n      )\n        return null;\n      return value as TaxRegistration[];\n    } catch {\n      return null;\n    }\n  }\n}\n","/** Stable UUID identities make tenant tax bootstrap retry and race safe. */\nexport async function deterministicTaxId(\n  tenantId: string,\n  kind: 'code' | 'component' | 'settings' | 'report',\n  key: string,\n): Promise<string> {\n  if (!tenantId.trim() || !key.trim())\n    throw new Error('Tax bootstrap identity requires tenant and key');\n  const bytes = new TextEncoder().encode(\n    JSON.stringify(['commerce-tax', tenantId, kind, key]),\n  );\n  const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes));\n  const uuid = digest.slice(0, 16);\n  uuid[6] = (uuid[6] & 0x0f) | 0x50;\n  uuid[8] = (uuid[8] & 0x3f) | 0x80;\n  const hex = Array.from(uuid, (byte) => byte.toString(16).padStart(2, '0'));\n  const joined = hex.join('');\n  return `${joined.slice(0, 8)}-${joined.slice(8, 12)}-${joined.slice(12, 16)}-${joined.slice(16, 20)}-${joined.slice(20)}`;\n}\n\n/** A racing deterministic insert loses safely and reloads the committed row. */\nexport async function createOrLoadTaxSeed<T>(\n  create: () => Promise<T>,\n  load: () => Promise<T | null | undefined>,\n): Promise<T> {\n  for (let attempt = 0; attempt < 3; attempt++) {\n    try {\n      return await create();\n    } catch (error) {\n      const code = (error as { code?: unknown } | null)?.code;\n      if (code === 'RUNTIME_REVISION_CONFLICT' && attempt < 2) continue;\n      if (code !== 'VALIDATION_UNIQUE_CONSTRAINT' && code !== '23505')\n        throw error;\n      const winner = await load();\n      if (!winner) throw error;\n      return winner;\n    }\n  }\n  throw new Error('Tax seed retry exhausted');\n}\n","import {\n  isEmbeddedDatabase,\n  isPostgresDatabase,\n  SmrtCollection,\n  withEmbeddedWriteTransaction,\n} from '@happyvertical/smrt-core';\nimport type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';\nimport { lockDocumentMoneyParents } from '../document-money-internal.js';\nimport { TaxSettings } from '../models/TaxSettings.js';\nimport { MoneyValidationError } from '../money.js';\nimport { createOrLoadTaxSeed, deterministicTaxId } from '../tax/identity.js';\nimport { assertTenantMoneyCurrent } from '../upgrade/detect.js';\n\n/**\n * Serialize settings-row creation for one tenant on PostgreSQL. The lock is\n * transaction-scoped; embedded engines are already single-writer through the\n * core embedded write queue that every model transaction enters.\n */\nasync function lockTenantSettingsCreation(\n  db: DatabaseInterface,\n  tenantId: string,\n): Promise<void> {\n  if (!isPostgresDatabase(db)) return;\n  await db.query(\n    'SELECT pg_advisory_xact_lock(hashtext(CAST(? AS TEXT)))',\n    `smrt-commerce-tax-settings:${tenantId}`,\n  );\n}\n\n/**\n * @internal Create a tenant's missing settings row exactly once, with the\n * model defaults. Creation serializes on a tenant advisory lock (PostgreSQL)\n * or the embedded write queue and re-reads before inserting, so racing first\n * writers converge on one row. An existing row is never changed.\n */\nexport async function materializeTenantTaxSettings(\n  db: DatabaseInterface,\n  tenantId: string,\n): Promise<void> {\n  const id = await deterministicTaxId(tenantId, 'settings', 'default');\n  await withEmbeddedWriteTransaction(db, isEmbeddedDatabase(db), async (tx) => {\n    await lockTenantSettingsCreation(tx, tenantId);\n    const settings = await TaxSettingsCollection.create({ db: tx });\n    if (await settings.getForTenant(tenantId)) return;\n    await createOrLoadTaxSeed(\n      () => settings.create({ id, tenantId }),\n      async () =>\n        (await settings.list({ where: { tenantId }, limit: 1 }))[0] ?? null,\n    );\n  });\n}\n\nexport class TaxSettingsCollection extends SmrtCollection<TaxSettings> {\n  static readonly _itemClass = TaxSettings;\n\n  /**\n   * Load the tenant's settings row, creating it once when missing. A tenant\n   * whose stored documents predate tenant tax settings is refused with\n   * `COMMERCE_DATA_NEEDS_UPGRADE` rather than given fresh defaults.\n   */\n  async getOrCreateForTenant(tenantId: string): Promise<TaxSettings> {\n    await assertTenantMoneyCurrent(this.db, tenantId);\n    const existing = await this.getForTenant(tenantId);\n    if (existing) return existing;\n    await materializeTenantTaxSettings(this.db, tenantId);\n    const created = await this.getForTenant(tenantId);\n    if (!created)\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant tax settings could not be materialized',\n      );\n    return created;\n  }\n\n  async getForTenant(tenantId: string): Promise<TaxSettings | null> {\n    const listed = (await this.list({ where: { tenantId }, limit: 1 }))[0];\n    if (!listed?.id) return listed ?? null;\n    return (await this.get({ id: listed.id }, { cache: false })) ?? null;\n  }\n\n  /** @internal Lock and re-read the tenant's settings row on this transaction. */\n  async lockForTenant(tenantId: string): Promise<TaxSettings> {\n    const first = await this.getOrCreateForTenant(tenantId);\n    if (!first.id)\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant tax settings have no identity',\n      );\n    await lockDocumentMoneyParents([\n      { id: first.id, tenantId, collection: this },\n    ]);\n    const locked = await this.getForTenant(tenantId);\n    if (!locked || locked.id !== first.id)\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant tax settings changed while acquiring the lock',\n      );\n    return locked;\n  }\n}\n","/** Tenant serialization point for commerce money runtime work. */\n\nimport type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';\nimport { TaxSettingsCollection } from './collections/TaxSettingsCollection.js';\nimport { withDocumentMoneyTransaction } from './document-money-internal.js';\nimport type { TaxSettings } from './models/TaxSettings.js';\nimport { MoneyValidationError } from './money.js';\nimport { assertTenantMoneyCurrent } from './upgrade/detect.js';\n\ndeclare const tenantMoneyScopeBrand: unique symbol;\n\n/** Transaction-affine proof that a tenant's settings row is locked on `db`. */\nexport interface TenantMoneyRuntimeScope {\n  readonly db: DatabaseInterface;\n  readonly tenantId: string;\n  readonly settings: TaxSettings;\n  readonly phase: 'runtime';\n  readonly [tenantMoneyScopeBrand]: true;\n}\n\nfunction requiredText(value: string, label: string): string {\n  if (!value || value.trim() !== value)\n    throw new MoneyValidationError(\n      'INVALID_MONEY_INPUT',\n      `${label} must be a nonempty trimmed string`,\n    );\n  return value;\n}\n\nconst activeRuntimeScopes = new WeakMap<\n  object,\n  Map<string, TenantMoneyRuntimeScope>\n>();\n\n/**\n * Lock and re-read the tenant's tax settings row before runtime money work,\n * creating it once when missing. Old-format money data is refused first with\n * `COMMERCE_DATA_NEEDS_UPGRADE`.\n */\nexport async function lockTenantMoneyRuntime(\n  tx: DatabaseInterface,\n  tenantId: string,\n): Promise<TaxSettings> {\n  requiredText(tenantId, 'Money tenant');\n  await assertTenantMoneyCurrent(tx, tenantId);\n  return (await TaxSettingsCollection.create({ db: tx })).lockForTenant(\n    tenantId,\n  );\n}\n\n/**\n * Run tenant money work under the tenant settings lock on exactly one\n * executor.\n *\n * Supplying an existing scope proves re-entry on the same executor. Calls made\n * through the owning transaction wrapper also reuse its exact registered\n * executor. No optional adapter-property heuristic can grant this capability.\n */\nexport async function withTenantMoneyRuntime<T>(\n  db: DatabaseInterface,\n  tenantId: string,\n  operation: (scope: TenantMoneyRuntimeScope) => Promise<T>,\n  existingScope?: TenantMoneyRuntimeScope,\n): Promise<T> {\n  requiredText(tenantId, 'Money tenant');\n  if (existingScope) {\n    if (\n      existingScope.phase !== 'runtime' ||\n      existingScope.db !== db ||\n      existingScope.tenantId !== tenantId\n    )\n      throw new MoneyValidationError(\n        'INVALID_MONEY_INPUT',\n        'Tenant money runtime scope does not match the requested executor',\n      );\n    return operation(existingScope);\n  }\n  return withDocumentMoneyTransaction(db, async (tx) => {\n    const active = activeRuntimeScopes.get(tx as object)?.get(tenantId);\n    if (active) return operation(active);\n    const settings = await lockTenantMoneyRuntime(tx, tenantId);\n    const scope = {\n      db: tx,\n      tenantId,\n      settings,\n      phase: 'runtime',\n    } as TenantMoneyRuntimeScope;\n    const scopes = activeRuntimeScopes.get(tx as object) ?? new Map();\n    scopes.set(tenantId, scope);\n    activeRuntimeScopes.set(tx as object, scopes);\n    try {\n      return await operation(scope);\n    } finally {\n      scopes.delete(tenantId);\n      if (scopes.size === 0) activeRuntimeScopes.delete(tx as object);\n    }\n  });\n}\n\n/**\n * @internal Guard a generated money-document collection read: a tenant whose\n * data predates the current money model is refused before any row is read.\n */\nexport async function withTenantMoneyCollectionRead<T>(\n  db: DatabaseInterface,\n  tenantId: string,\n  operation: (boundDb: DatabaseInterface) => Promise<T>,\n): Promise<T> {\n  await assertTenantMoneyCurrent(db, tenantId);\n  return operation(db);\n}\n"],"mappings":"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"}

package/dist/chunks/types-Bbm0Xflc.js.map

@@ -1 +1 @@
-{"version":3,"file":"types-Bbm0Xflc.js","names":["CustomerStatus","CustomerType","VendorStatus","ContractType","ContractStatus","FulfillmentType","FulfillmentStatus","PaymentMethod","PaymentStatus","PaymentInstrumentStatus","PayoutStatus","PaymentIntentStatus","InvoiceStatus"],"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Commerce package type definitions\n * @packageDocumentation\n */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\n\n// ============================================================================\n// Customer/Vendor Types\n// ============================================================================\n\nexport enum CustomerStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n/**\n * Customer classification — drives channel access, pricing tier, and credit terms.\n *\n * - DTC: direct-to-consumer (end shopper). Pays via storefront checkout.\n * - WHOLESALE: B2B buyer with negotiated terms (NET-30, line sheets, etc.).\n * - RETAIL: in-store walk-in / point-of-sale customer.\n */\nexport enum CustomerType {\n  DTC = 'dtc',\n  WHOLESALE = 'wholesale',\n  RETAIL = 'retail',\n}\n\nexport enum VendorStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n// ============================================================================\n// Contract Types\n// ============================================================================\n\nexport enum ContractType {\n  ESTIMATE = 'estimate',\n  ORDER = 'order',\n  LEASE = 'lease',\n  AGREEMENT = 'agreement',\n  SUPPLIER_QUOTE = 'supplier_quote',\n  PURCHASE_ORDER = 'purchase_order',\n  WHOLESALE_ORDER = 'wholesale_order',\n  PRODUCTION_ORDER = 'production_order',\n  CART = 'cart',\n  /**\n   * Industry-neutral licensing primitive. The `LicenseSale` STI subtype\n   * carries an immutable rights snapshot, a licensee email, optional\n   * legal-entity / jurisdiction fields, and a signed-PDF reference.\n   * Any application that sells rights for a fee (stock media,\n   * music licensing, code-asset marketplace, license keys, etc.)\n   * uses this subtype.\n   */\n  LICENSE_SALE = 'license_sale',\n}\n\nexport enum ContractStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  ACCEPTED = 'accepted',\n  DECLINED = 'declined',\n  COMPLETED = 'completed',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Fulfillment Types\n// ============================================================================\n\nexport enum FulfillmentType {\n  SHIPMENT = 'shipment',\n  DELIVERY = 'delivery',\n  PICKUP = 'pickup',\n  DIGITAL = 'digital',\n  SERVICE = 'service',\n}\n\nexport enum FulfillmentStatus {\n  PENDING = 'pending',\n  PROCESSING = 'processing',\n  SHIPPED = 'shipped',\n  DELIVERED = 'delivered',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\nexport enum PaymentMethod {\n  CASH = 'cash',\n  CHECK = 'check',\n  CREDIT_CARD = 'credit_card',\n  BANK_TRANSFER = 'bank_transfer',\n  CRYPTO = 'crypto',\n  OTHER = 'other',\n}\n\nexport enum PaymentStatus {\n  PENDING = 'pending',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  REFUNDED = 'refunded',\n  CANCELLED = 'cancelled',\n}\n\nexport type PaymentKind = 'payment' | 'refund';\n\n/**\n * Lifecycle status for a saved {@link PaymentInstrument} (card on file).\n * `active` while chargeable, `expired` once the card lapses, `removed` when the\n * customer detaches it.\n */\nexport enum PaymentInstrumentStatus {\n  ACTIVE = 'active',\n  EXPIRED = 'expired',\n  REMOVED = 'removed',\n}\n\n// ============================================================================\n// Payout Types\n// ============================================================================\n\n/**\n * Status machine for {@link Payout}.\n *\n * `pending → sent → confirmed → failed`. `failed` is terminal but the\n * model exposes a dedicated `resetFromFailed()` so an operator can\n * deliberately requeue a payout after fixing the underlying problem;\n * the reset moves the row back to `pending` and clears the failure\n * metadata.\n *\n * Skipping intermediate states is rejected — a `pending` payout cannot\n * jump straight to `confirmed`, and a `sent` payout cannot regress to\n * `pending` without going through `resetFromFailed()` first.\n */\nexport enum PayoutStatus {\n  PENDING = 'pending',\n  SENT = 'sent',\n  CONFIRMED = 'confirmed',\n  FAILED = 'failed',\n}\n\n// ============================================================================\n// PaymentIntent Types\n// ============================================================================\n\n/**\n * Status machine for {@link PaymentIntent}.\n *\n * `awaiting_payment → paid → (issued | retired)`, with `expired` and\n * `cancelled` as alternate terminal states reachable from\n * `awaiting_payment`.\n *\n * - `AWAITING_PAYMENT` — open quote, accepting any of the listed\n *   payment options.\n * - `PAID` — one option was satisfied by an incoming payment. The\n *   other options are implicitly retired; later inbound funds to a\n *   retired option must be flagged for refund by the consumer.\n * - `ISSUED` — downstream rights / contract / fulfillment have been\n *   created and linked. Terminal happy-path state.\n * - `RETIRED` — paid but the satisfaction was reversed (refund,\n *   chargeback, etc.). Terminal.\n * - `EXPIRED` — the USD-price-lock window passed without payment.\n *   Terminal.\n * - `CANCELLED` — the buyer or the system explicitly cancelled the\n *   intent before it was paid. Terminal.\n */\nexport enum PaymentIntentStatus {\n  AWAITING_PAYMENT = 'awaiting_payment',\n  PAID = 'paid',\n  ISSUED = 'issued',\n  RETIRED = 'retired',\n  EXPIRED = 'expired',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * One way for a {@link PaymentIntent} to be satisfied. The intent lists\n * an array of these; satisfying any one of them transitions the intent\n * to `PAID` and implicitly retires the rest.\n *\n * Industry-neutral: a marketplace that accepts USDC-on-Base and BTC\n * lists two options; a SaaS billing flow that accepts Stripe and\n * PayPal lists two; a kiosk that accepts only one rail lists one.\n */\nexport interface PaymentOption {\n  /**\n   * Stable id of the `PaymentBackend` adapter that fulfills this\n   * option — must match a `backendId` the consumer's payment-routing\n   * layer recognises. Examples: `base-usdc`, `solana-usdc`, `btc`,\n   * `stripe`, `paypal`.\n   */\n  backendId: string;\n  /**\n   * Payout-rail-qualified currency code, e.g. `USDC-base`, `BTC`,\n   * `USD-stripe`. The same convention used by\n   * `Vendor.payoutAddresses` and `Payment.nativeCurrency`.\n   */\n  currency: string;\n  /**\n   * Optional chain identifier for blockchain-backed options (`base`,\n   * `ethereum`, `solana`, ...). Pure-fiat options leave this empty.\n   */\n  chain?: string;\n  /**\n   * Destination address / account id the buyer should send funds to\n   * for this option (EVM address, BTC address, Stripe payment-intent\n   * id, etc.).\n   */\n  payTo: string;\n  /**\n   * Amount denominated in `currency`. Stored at decimal precision —\n   * a USDC option might be `199.0`, a BTC option `0.00713`.\n   */\n  nativeAmount: number;\n  /**\n   * Optional on-chain memo / payment reference (Solana memo, BTC OP_RETURN\n   * tag, Stripe metadata key). Some backends use this to disambiguate\n   * which intent an inbound payment satisfies.\n   */\n  memo?: string;\n  /**\n   * Whether this option supports the x402 HTTP-402 payment-required\n   * flow. Consumers that build agent-driven flows use this flag to\n   * filter the offered options.\n   */\n  x402Capable?: boolean;\n  /**\n   * Optional per-option expiry — when a single rail's quote becomes\n   * stale earlier than the intent-wide price-lock window (e.g. a\n   * volatile-currency option that re-quotes more aggressively). ISO\n   * 8601 string. Empty / missing means \"inherit the intent's\n   * `priceLockExpiresAt`\".\n   */\n  expiresAt?: string;\n}\n\n// ============================================================================\n// Invoice Types\n// ============================================================================\n\nexport enum InvoiceStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  VIEWED = 'viewed',\n  PARTIAL = 'partial',\n  PAID = 'paid',\n  OVERDUE = 'overdue',\n  CANCELLED = 'cancelled',\n  WRITTEN_OFF = 'written_off',\n}\n\n// ============================================================================\n// Common Interfaces\n// ============================================================================\n\n/**\n * Address structure used for billing and shipping\n */\nexport interface Address {\n  street1?: string;\n  street2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\n/**\n * A person to reach at a customer or vendor, stored on the party row\n * (`Customer.contacts` / `Vendor.contacts`, #3501). Every field is plain\n * text; `id` is a stable random identifier assigned when the row is first\n * saved. Write rows through `savePartyContacts()`.\n */\nexport interface PartyContact {\n  id: string;\n  name: string;\n  /** Role or relationship, for example \"Accounts payable\". */\n  label: string;\n  email: string;\n  phone: string;\n  address: string;\n}\n\n/**\n * Options for recording a payment with ledger integration\n */\nexport interface RecordPaymentOptions {\n  /** Original settlement calendar date (YYYY-MM-DD); journal and paidAt use noon UTC. Omission uses the current clock for ordinary payments. Managed customer funds retain their reviewed date. */\n  effectiveOn?: string;\n  /** The ledger to record the journal entry in */\n  ledgerId: string;\n  /** Account ID for receivables (credit side) */\n  receivablesAccountId: string;\n  /** Account ID for cash/bank (debit side) */\n  cashAccountId: string;\n}\n\n/**\n * Options for recognizing revenue on an invoice\n */\nexport interface RecognizeRevenueOptions {\n  /** Account ID for accounts receivable (debit side) */\n  arAccountId: string;\n  /** Revenue account for lines that do not name their own (credit side). */\n  revenueAccountId: string;\n  /**\n   * Tax payable account for tax components without a liability account and\n   * for provider tax (credit side).\n   */\n  taxAccountId?: string;\n  /** ISO 4217 ledger book currency; must equal the invoice currency. */\n  bookCurrency: string;\n}\n\n/** Options for atomically cancelling a posted invoice. */\nexport interface CancelRevenueOptions {\n  /** ISO 4217 ledger book currency; must equal the invoice currency. */\n  bookCurrency: string;\n}\n\n// ============================================================================\n// Accounting-provider sync shapes\n// ============================================================================\n\n/**\n * A single line item in the format expected by `@happyvertical/accounting`\n * providers (QBO, Stripe, …). Mirrors the object built by\n * {@link InvoiceLineItem.toAccountingLineItem}. The SDK isn't a dependency of\n * this package, so the shape is declared locally rather than imported.\n */\nexport interface AccountingLineItemInput {\n  description: string;\n  sku?: string;\n  quantity: number;\n  unitPrice: number;\n  discount?: number;\n  taxRate?: number;\n  amount: number;\n  periodStart?: Date;\n  periodEnd?: Date;\n}\n\n/**\n * An invoice in the format expected by `@happyvertical/accounting` providers.\n * Mirrors the object built by {@link Invoice.toAccountingInput}; money is in\n * currency **major** units, as the SDK expects.\n */\nexport interface AccountingInvoiceInput {\n  id: string;\n  externalId?: string;\n  invoiceNumber: string;\n  customerId: string;\n  customerExternalId?: string;\n  issueDate: Date;\n  dueDate: Date;\n  lineItems: AccountingLineItemInput[];\n  subtotal: number;\n  taxAmount: number;\n  totalAmount: number;\n  currency: string;\n  reference?: string;\n  memo?: string;\n  idempotencyKey?: string;\n  quickbooksRequest?: {\n    readonly requestId: string;\n    readonly realmId: string;\n    readonly environment: 'sandbox' | 'production';\n    readonly payloadHash: string;\n  };\n  quickbooksMapping?: {\n    globalTaxCalculation: 'TaxExcluded' | 'NotApplicable';\n  };\n}\n\n// ============================================================================\n// Model constructor option interfaces\n//\n// Each model's `constructor(options)` accepts a partial bag of its own fields.\n// Declaring a dedicated `XxxOptions extends SmrtObjectOptions` interface keeps\n// the constructors strongly typed (no `any`) while still allowing the\n// framework's base options (db, ai, fs, _className, …) through.\n// ============================================================================\n\n/**\n * Constructor options for {@link Customer}.\n */\nexport interface CustomerOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  creditLimit?: number;\n  paymentTerms?: string;\n  taxExempt?: boolean;\n  taxId?: string;\n  defaultTaxCodeId?: string;\n  defaultShippingAddress?: Address;\n  defaultBillingAddress?: Address;\n  status?: CustomerStatus;\n  customerType?: CustomerType | null;\n  notes?: string;\n  contacts?: PartyContact[] | string | null;\n}\n\n/**\n * Constructor options for {@link Vendor}.\n */\nexport interface VendorOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  leadTimeDays?: number;\n  minimumOrderAmount?: number;\n  paymentTerms?: string;\n  currency?: string;\n  taxId?: string;\n  defaultTaxCodeId?: string;\n  defaultContactEmail?: string;\n  defaultContactPhone?: string;\n  status?: VendorStatus;\n  notes?: string;\n  payoutAddresses?: Record<string, string> | string | null;\n  contacts?: PartyContact[] | string | null;\n}\n\n/** A component reference stored in a tax code's ordered component list. */\nexport interface TaxCodePart {\n  taxComponentId: string;\n  compound: boolean;\n}\n\nexport interface TaxComponentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  name?: string;\n  percent?: string;\n  liabilityAccountId?: string;\n  recoverable?: boolean;\n  active?: boolean;\n}\n\nexport interface TaxCodeOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  code?: string;\n  name?: string;\n  kind?: 'taxable' | 'zero-rated' | 'exempt' | 'out-of-scope';\n  appliesTo?: 'sales' | 'purchases' | 'both';\n  components?: TaxCodePart[];\n  active?: boolean;\n}\n\nexport interface TaxRegistrationOptions {\n  taxComponentId: string;\n  number: string;\n  label: string;\n}\n\nexport interface TaxSettingsOptions extends SmrtObjectOptions {\n  tenantId?: string;\n  defaultSalesTaxCodeId?: string;\n  defaultPurchaseTaxCodeId?: string;\n  defaultLineAmountType?: 'exclusive' | 'inclusive' | 'none';\n  taxRoundingScope?: 'line' | 'document';\n  taxRegistrations?: TaxRegistrationOptions[];\n}\n\n/**\n * Constructor options for {@link Contract} and its STI subtypes.\n */\nexport interface ContractOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractType?: ContractType;\n  status?: ContractStatus;\n  subtotal?: number;\n  discountTotal?: number;\n  taxAmount?: number;\n  totalAmount?: number;\n  currency?: string;\n  issueDate?: Date;\n  dueDate?: Date | null;\n  expiryDate?: Date | null;\n  reference?: string;\n  notes?: string;\n  terms?: string;\n  channelId?: string;\n  lineAmountType?: 'exclusive' | 'inclusive' | 'none';\n  taxRoundingScope?: 'line' | 'document';\n  sellerTaxRegistrations?: TaxRegistrationOptions[];\n  sellerTaxRegistrationsJson?: string;\n  partyTaxId?: string;\n  moneySnapshotId?: string;\n  moneyAuthority?: 'calculated' | 'received';\n  receivedPurchaseMoneyJson?: string;\n  /** Command-owned contract schedule evidence. */\n  billingScheduleJson?: string;\n}\n\nexport interface SalesContractOptions extends ContractOptions {\n  customerId?: string | null;\n}\n\nexport interface PurchaseContractOptions extends ContractOptions {\n  vendorId?: string | null;\n}\n\n/** Purchase-order header options stored in the existing STI metadata. */\nexport interface PurchaseOrderOptions extends PurchaseContractOptions {\n  /** Expected delivery calendar date (YYYY-MM-DD); empty means unspecified. */\n  expectedDate?: string;\n  /** Delivery address/instructions snapshot. */\n  shipTo?: string;\n}\n\n/**\n * Constructor options for {@link LicenseSale} (Contract STI subtype). Extends\n * {@link ContractOptions} with the licensing-specific meta fields.\n */\nexport interface LicenseSaleOptions extends SalesContractOptions {\n  skuId?: string;\n  paymentId?: string;\n  licenseeEmail?: string;\n  licenseeLegalEntity?: string;\n  licenseeJurisdiction?: string;\n  rightsMedium?: string;\n  rightsDistributionScope?: string;\n  rightsExclusivity?: string;\n  rightsDuration?: string;\n  rightsTerritory?: string;\n  rightsSublicensing?: boolean;\n  rightsDerivatives?: boolean;\n  pdfUrl?: string;\n  pdfHash?: string;\n  onChainHashRegistryRef?: string;\n}\n\n/**\n * Constructor options for {@link ContractLineItem}.\n */\nexport interface ContractLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  description?: string;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  discountType?: 'none' | 'percent' | 'amount';\n  discountRate?: string;\n  taxRate?: number;\n  taxMode?: 'inherit' | 'override';\n  taxCodeId?: string | null;\n  taxCodeCode?: string | null;\n  taxCodeName?: string | null;\n  taxComponents?: ContractTaxComponentSnapshot[];\n  taxComponentsJson?: string | null;\n  taxAmount?: number;\n  moneySnapshotId?: string;\n  amount?: number;\n  productId?: string;\n  sku?: string;\n  startDate?: Date | null;\n  endDate?: Date | null;\n  billingPeriod?: string;\n  sortOrder?: number;\n}\n\n/** Immutable component tax allocation for one Contract line. */\nexport interface ContractTaxComponentSnapshot {\n  taxComponentId: string;\n  name: string;\n  percent: string;\n  taxMinor: number;\n  /** Missing on historical additive snapshots means false. */\n  compound?: boolean;\n  /** Actual component basis, including preceding tax when compound. */\n  taxableMinor?: number;\n}\n\n/**\n * How the provider collects an invoice (#3190): `charge_automatically`\n * charges the payer's saved card; `send_invoice` asks the payer to pay. Empty\n * for an invoice never pushed to a provider, or pushed before it was recorded.\n */\nexport type InvoiceCollectionMethod =\n  | ''\n  | 'send_invoice'\n  | 'charge_automatically';\n\nexport type InvoiceKind = 'invoice' | 'credit_note';\n\n/** Frozen source pricing plus the one authoritative credit calculation basis. */\nexport type InvoiceCreditCalculationBasis =\n  | {\n      kind: 'quantity';\n      quantity: string;\n      sourceQuantity: string;\n      sourceUnitPrice: number;\n      sourceDiscountType: 'none' | 'percent' | 'amount';\n      sourceDiscountRate: string;\n      sourceDiscountMinor: number;\n    }\n  | {\n      kind: 'net_amount';\n      netMinor: number;\n      sourceQuantity: string;\n      sourceUnitPrice: number;\n      sourceDiscountType: 'none' | 'percent' | 'amount';\n      sourceDiscountRate: string;\n      sourceDiscountMinor: number;\n    };\n\n/**\n * Constructor options for {@link Invoice}.\n */\nexport interface InvoiceOptions extends SmrtObjectOptions {\n  moneyAuthority?: 'calculated' | 'historical';\n  historicalSalesMoneyJson?: string;\n  historicalSourceKeyHash?: string | null;\n\n  kind?: InvoiceKind;\n  creditedInvoiceId?: string | null;\n  creditedAmount?: number;\n  tenantId?: string | null;\n  customerId?: string;\n  contractId?: string;\n  invoiceNumber?: string;\n  reference?: string;\n  issueDate?: Date;\n  dueDate?: Date | null;\n  paidDate?: Date | null;\n  subtotal?: number;\n  taxAmount?: number;\n  providerTaxAmount?: number;\n  totalAmount?: number;\n  amountPaid?: number;\n  currency?: string;\n  status?: InvoiceStatus;\n  arJournalId?: string;\n  arReversalJournalId?: string | null;\n  revenueJournalId?: string;\n  externalId?: string;\n  customerExternalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  collectionMethod?: InvoiceCollectionMethod;\n  sentAt?: Date | null;\n  viewedAt?: Date | null;\n  remindersSent?: number;\n  lastReminderAt?: Date | null;\n  notes?: string;\n  customerNotes?: string;\n  terms?: string;\n  lineAmountType?: 'exclusive' | 'inclusive' | 'none';\n  taxRoundingScope?: 'line' | 'document';\n  discountTotal?: number;\n  sellerTaxRegistrations?: TaxRegistrationOptions[];\n  sellerTaxRegistrationsJson?: string;\n  partyTaxId?: string;\n  moneySnapshotId?: string;\n  accountingSyncStateJson?: string;\n}\n\nexport interface InvoiceTaxComponentSnapshot {\n  taxComponentId: string;\n  name: string;\n  percent: string;\n  taxMinor: number;\n  /** Missing on historical additive snapshots means false. */\n  compound?: boolean;\n  /** Actual component basis, including preceding tax when compound. */\n  taxableMinor?: number;\n}\n\n/** Constructor options for {@link InvoiceLineItem}. */\nexport interface InvoiceLineItemOptions extends SmrtObjectOptions {\n  creditedLineId?: string | null;\n  creditCalculationBasis?: InvoiceCreditCalculationBasis | null;\n  creditCalculationBasisJson?: string;\n  tenantId?: string | null;\n  invoiceId?: string;\n  description?: string;\n  sku?: string;\n  productId?: string | null;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  discountType?: 'none' | 'percent' | 'amount';\n  discountRate?: string;\n  taxRate?: number;\n  taxMode?: 'inherit' | 'override';\n  taxCodeId?: string | null;\n  taxCodeCode?: string | null;\n  taxCodeName?: string | null;\n  taxComponents?: InvoiceTaxComponentSnapshot[];\n  taxComponentsJson?: string | null;\n  taxAmount?: number;\n  moneySnapshotId?: string;\n  amount?: number;\n  sourceType?: string;\n  sourceId?: string;\n  periodStart?: Date | null;\n  periodEnd?: Date | null;\n  revenueAccountId?: string | null;\n  sortOrder?: number;\n}\n\n/**\n * Constructor options for {@link Fulfillment}.\n */\nexport interface FulfillmentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  fulfillmentType?: FulfillmentType;\n  status?: FulfillmentStatus;\n  trackingNumber?: string;\n  carrier?: string;\n  shippingAddress?: Address;\n  shippedAt?: Date | null;\n  deliveredAt?: Date | null;\n  estimatedDelivery?: Date | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link FulfillmentLineItem}.\n */\nexport interface FulfillmentLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  fulfillmentId?: string;\n  contractLineItemId?: string;\n  quantityFulfilled?: number;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payment}.\n */\nexport interface PaymentOptions extends SmrtObjectOptions {\n  /** Internal command-owned customer funds evidence; use public commands. */\n  customerFundsJson?: string;\n  kind?: PaymentKind;\n  tenantId?: string | null;\n  contractId?: string | null;\n  customerId?: string | null;\n  amount?: number;\n  currency?: string;\n  method?: PaymentMethod;\n  status?: PaymentStatus;\n  transactionId?: string;\n  reference?: string;\n  journalId?: string;\n  paidAt?: Date | null;\n  notes?: string;\n  externalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  backendId?: string;\n  backendTxRef?: string;\n  nativeAmount?: number;\n  nativeCurrency?: string;\n  usdAtQuote?: number;\n  usdAtConfirmation?: number;\n}\n\n/**\n * Constructor options for {@link PaymentInstrument}.\n */\nexport interface PaymentInstrumentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  customerId?: string;\n  backendId?: string;\n  providerCustomerId?: string;\n  providerPaymentMethodId?: string;\n  type?: string;\n  brand?: string;\n  last4?: string;\n  expMonth?: number;\n  expYear?: number;\n  isDefault?: boolean;\n  status?: PaymentInstrumentStatus;\n}\n\n/**\n * Constructor options for {@link PaymentAllocation}.\n */\nexport interface PaymentAllocationOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  invoiceId?: string;\n  amount?: number;\n  allocatedAt?: Date;\n  allocatedBy?: string;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link PaymentIntent}.\n */\nexport interface PaymentIntentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  skuId?: string;\n  offeringRef?: string;\n  licenseeEmail?: string;\n  customerId?: string;\n  paymentOptions?: PaymentOption[] | string;\n  usdPriceLocked?: number;\n  priceLockWindowMs?: number;\n  priceLockExpiresAt?: Date | number | string | null;\n  status?: PaymentIntentStatus;\n  idempotencyKey?: string;\n  paidOptionBackendId?: string;\n  paymentId?: string;\n  paidAt?: Date | number | string | null;\n  issuedAt?: Date | number | string | null;\n  expiredAt?: Date | number | string | null;\n  cancelledAt?: Date | number | string | null;\n  retiredAt?: Date | number | string | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payout}.\n */\nexport interface PayoutOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  vendorId?: string;\n  grossAmount?: number;\n  operatorFee?: number;\n  supplierNet?: number;\n  currency?: string;\n  backendId?: string;\n  backendTxRef?: string;\n  status?: PayoutStatus;\n  sentAt?: Date | number | string | null;\n  confirmedAt?: Date | number | string | null;\n  failedAt?: Date | number | string | null;\n  failureReason?: string;\n  notes?: string;\n}\n"],"mappings":"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"}
+{"version":3,"file":"types-Bbm0Xflc.js","names":["CustomerStatus","CustomerType","VendorStatus","ContractType","ContractStatus","FulfillmentType","FulfillmentStatus","PaymentMethod","PaymentStatus","PaymentInstrumentStatus","PayoutStatus","PaymentIntentStatus","InvoiceStatus"],"sources":["../../src/types/index.ts"],"sourcesContent":["/**\n * Commerce package type definitions\n * @packageDocumentation\n */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\n\n// ============================================================================\n// Customer/Vendor Types\n// ============================================================================\n\nexport enum CustomerStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n/**\n * Customer classification — drives channel access, pricing tier, and credit terms.\n *\n * - DTC: direct-to-consumer (end shopper). Pays via storefront checkout.\n * - WHOLESALE: B2B buyer with negotiated terms (NET-30, line sheets, etc.).\n * - RETAIL: in-store walk-in / point-of-sale customer.\n */\nexport enum CustomerType {\n  DTC = 'dtc',\n  WHOLESALE = 'wholesale',\n  RETAIL = 'retail',\n}\n\nexport enum VendorStatus {\n  ACTIVE = 'active',\n  INACTIVE = 'inactive',\n  SUSPENDED = 'suspended',\n}\n\n// ============================================================================\n// Contract Types\n// ============================================================================\n\nexport enum ContractType {\n  ESTIMATE = 'estimate',\n  ORDER = 'order',\n  LEASE = 'lease',\n  AGREEMENT = 'agreement',\n  SUPPLIER_QUOTE = 'supplier_quote',\n  PURCHASE_ORDER = 'purchase_order',\n  WHOLESALE_ORDER = 'wholesale_order',\n  PRODUCTION_ORDER = 'production_order',\n  CART = 'cart',\n  /**\n   * Industry-neutral licensing primitive. The `LicenseSale` STI subtype\n   * carries an immutable rights snapshot, a licensee email, optional\n   * legal-entity / jurisdiction fields, and a signed-PDF reference.\n   * Any application that sells rights for a fee (stock media,\n   * music licensing, code-asset marketplace, license keys, etc.)\n   * uses this subtype.\n   */\n  LICENSE_SALE = 'license_sale',\n}\n\nexport enum ContractStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  ACCEPTED = 'accepted',\n  DECLINED = 'declined',\n  COMPLETED = 'completed',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Fulfillment Types\n// ============================================================================\n\nexport enum FulfillmentType {\n  SHIPMENT = 'shipment',\n  DELIVERY = 'delivery',\n  PICKUP = 'pickup',\n  DIGITAL = 'digital',\n  SERVICE = 'service',\n}\n\nexport enum FulfillmentStatus {\n  PENDING = 'pending',\n  PROCESSING = 'processing',\n  SHIPPED = 'shipped',\n  DELIVERED = 'delivered',\n  CANCELLED = 'cancelled',\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\nexport enum PaymentMethod {\n  CASH = 'cash',\n  CHECK = 'check',\n  CREDIT_CARD = 'credit_card',\n  BANK_TRANSFER = 'bank_transfer',\n  CRYPTO = 'crypto',\n  OTHER = 'other',\n}\n\nexport enum PaymentStatus {\n  PENDING = 'pending',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  REFUNDED = 'refunded',\n  CANCELLED = 'cancelled',\n}\n\nexport type PaymentKind = 'payment' | 'refund';\n\n/**\n * Lifecycle status for a saved {@link PaymentInstrument} (card on file).\n * `active` while chargeable, `expired` once the card lapses, `removed` when the\n * customer detaches it.\n */\nexport enum PaymentInstrumentStatus {\n  ACTIVE = 'active',\n  EXPIRED = 'expired',\n  REMOVED = 'removed',\n}\n\n// ============================================================================\n// Payout Types\n// ============================================================================\n\n/**\n * Status machine for {@link Payout}.\n *\n * `pending → sent → confirmed → failed`. `failed` is terminal but the\n * model exposes a dedicated `resetFromFailed()` so an operator can\n * deliberately requeue a payout after fixing the underlying problem;\n * the reset moves the row back to `pending` and clears the failure\n * metadata.\n *\n * Skipping intermediate states is rejected — a `pending` payout cannot\n * jump straight to `confirmed`, and a `sent` payout cannot regress to\n * `pending` without going through `resetFromFailed()` first.\n */\nexport enum PayoutStatus {\n  PENDING = 'pending',\n  SENT = 'sent',\n  CONFIRMED = 'confirmed',\n  FAILED = 'failed',\n}\n\n// ============================================================================\n// PaymentIntent Types\n// ============================================================================\n\n/**\n * Status machine for {@link PaymentIntent}.\n *\n * `awaiting_payment → paid → (issued | retired)`, with `expired` and\n * `cancelled` as alternate terminal states reachable from\n * `awaiting_payment`.\n *\n * - `AWAITING_PAYMENT` — open quote, accepting any of the listed\n *   payment options.\n * - `PAID` — one option was satisfied by an incoming payment. The\n *   other options are implicitly retired; later inbound funds to a\n *   retired option must be flagged for refund by the consumer.\n * - `ISSUED` — downstream rights / contract / fulfillment have been\n *   created and linked. Terminal happy-path state.\n * - `RETIRED` — paid but the satisfaction was reversed (refund,\n *   chargeback, etc.). Terminal.\n * - `EXPIRED` — the USD-price-lock window passed without payment.\n *   Terminal.\n * - `CANCELLED` — the buyer or the system explicitly cancelled the\n *   intent before it was paid. Terminal.\n */\nexport enum PaymentIntentStatus {\n  AWAITING_PAYMENT = 'awaiting_payment',\n  PAID = 'paid',\n  ISSUED = 'issued',\n  RETIRED = 'retired',\n  EXPIRED = 'expired',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * One way for a {@link PaymentIntent} to be satisfied. The intent lists\n * an array of these; satisfying any one of them transitions the intent\n * to `PAID` and implicitly retires the rest.\n *\n * Industry-neutral: a marketplace that accepts USDC-on-Base and BTC\n * lists two options; a SaaS billing flow that accepts Stripe and\n * PayPal lists two; a kiosk that accepts only one rail lists one.\n */\nexport interface PaymentOption {\n  /**\n   * Stable id of the `PaymentBackend` adapter that fulfills this\n   * option — must match a `backendId` the consumer's payment-routing\n   * layer recognises. Examples: `base-usdc`, `solana-usdc`, `btc`,\n   * `stripe`, `paypal`.\n   */\n  backendId: string;\n  /**\n   * Payout-rail-qualified currency code, e.g. `USDC-base`, `BTC`,\n   * `USD-stripe`. The same convention used by\n   * `Vendor.payoutAddresses` and `Payment.nativeCurrency`.\n   */\n  currency: string;\n  /**\n   * Optional chain identifier for blockchain-backed options (`base`,\n   * `ethereum`, `solana`, ...). Pure-fiat options leave this empty.\n   */\n  chain?: string;\n  /**\n   * Destination address / account id the buyer should send funds to\n   * for this option (EVM address, BTC address, Stripe payment-intent\n   * id, etc.).\n   */\n  payTo: string;\n  /**\n   * Amount denominated in `currency`. Stored at decimal precision —\n   * a USDC option might be `199.0`, a BTC option `0.00713`.\n   */\n  nativeAmount: number;\n  /**\n   * Optional on-chain memo / payment reference (Solana memo, BTC OP_RETURN\n   * tag, Stripe metadata key). Some backends use this to disambiguate\n   * which intent an inbound payment satisfies.\n   */\n  memo?: string;\n  /**\n   * Whether this option supports the x402 HTTP-402 payment-required\n   * flow. Consumers that build agent-driven flows use this flag to\n   * filter the offered options.\n   */\n  x402Capable?: boolean;\n  /**\n   * Optional per-option expiry — when a single rail's quote becomes\n   * stale earlier than the intent-wide price-lock window (e.g. a\n   * volatile-currency option that re-quotes more aggressively). ISO\n   * 8601 string. Empty / missing means \"inherit the intent's\n   * `priceLockExpiresAt`\".\n   */\n  expiresAt?: string;\n}\n\n// ============================================================================\n// Invoice Types\n// ============================================================================\n\nexport enum InvoiceStatus {\n  DRAFT = 'draft',\n  SENT = 'sent',\n  VIEWED = 'viewed',\n  PARTIAL = 'partial',\n  PAID = 'paid',\n  OVERDUE = 'overdue',\n  CANCELLED = 'cancelled',\n  WRITTEN_OFF = 'written_off',\n}\n\n// ============================================================================\n// Common Interfaces\n// ============================================================================\n\n/**\n * Address structure used for billing and shipping\n */\nexport interface Address {\n  street1?: string;\n  street2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\n/**\n * A person to reach at a customer or vendor, stored on the party row\n * (`Customer.contacts` / `Vendor.contacts`, #3501). Every field is plain\n * text; `id` is a stable random identifier assigned when the row is first\n * saved. Write rows through `savePartyContacts()`.\n */\nexport interface PartyContact {\n  id: string;\n  name: string;\n  /** Role or relationship, for example \"Accounts payable\". */\n  label: string;\n  email: string;\n  phone: string;\n  address: string;\n}\n\n/**\n * Options for recording a payment with ledger integration\n */\nexport interface RecordPaymentOptions {\n  /** Original settlement calendar date (YYYY-MM-DD); journal and paidAt use noon UTC. Omission uses the current clock for ordinary payments. Managed customer funds retain their reviewed date. */\n  effectiveOn?: string;\n  /** The ledger to record the journal entry in */\n  ledgerId: string;\n  /** Account ID for receivables (credit side) */\n  receivablesAccountId: string;\n  /** Account ID for cash/bank (debit side) */\n  cashAccountId: string;\n  /**\n   * Expense account for a connected charge's application fee (#3831).\n   * Required when the payment carries `applicationFeeCents`: cash is debited\n   * net of the fee and the fee is debited here.\n   */\n  applicationFeeAccountId?: string;\n}\n\n/**\n * Options for recognizing revenue on an invoice\n */\nexport interface RecognizeRevenueOptions {\n  /** Account ID for accounts receivable (debit side) */\n  arAccountId: string;\n  /** Revenue account for lines that do not name their own (credit side). */\n  revenueAccountId: string;\n  /**\n   * Tax payable account for tax components without a liability account and\n   * for provider tax (credit side).\n   */\n  taxAccountId?: string;\n  /** ISO 4217 ledger book currency; must equal the invoice currency. */\n  bookCurrency: string;\n}\n\n/** Options for atomically cancelling a posted invoice. */\nexport interface CancelRevenueOptions {\n  /** ISO 4217 ledger book currency; must equal the invoice currency. */\n  bookCurrency: string;\n}\n\n// ============================================================================\n// Accounting-provider sync shapes\n// ============================================================================\n\n/**\n * A single line item in the format expected by `@happyvertical/accounting`\n * providers (QBO, Stripe, …). Mirrors the object built by\n * {@link InvoiceLineItem.toAccountingLineItem}. The SDK isn't a dependency of\n * this package, so the shape is declared locally rather than imported.\n */\nexport interface AccountingLineItemInput {\n  description: string;\n  sku?: string;\n  quantity: number;\n  unitPrice: number;\n  discount?: number;\n  taxRate?: number;\n  amount: number;\n  periodStart?: Date;\n  periodEnd?: Date;\n}\n\n/**\n * An invoice in the format expected by `@happyvertical/accounting` providers.\n * Mirrors the object built by {@link Invoice.toAccountingInput}; money is in\n * currency **major** units, as the SDK expects.\n */\nexport interface AccountingInvoiceInput {\n  id: string;\n  externalId?: string;\n  invoiceNumber: string;\n  customerId: string;\n  customerExternalId?: string;\n  issueDate: Date;\n  dueDate: Date;\n  lineItems: AccountingLineItemInput[];\n  subtotal: number;\n  taxAmount: number;\n  totalAmount: number;\n  currency: string;\n  reference?: string;\n  memo?: string;\n  idempotencyKey?: string;\n  quickbooksRequest?: {\n    readonly requestId: string;\n    readonly realmId: string;\n    readonly environment: 'sandbox' | 'production';\n    readonly payloadHash: string;\n  };\n  quickbooksMapping?: {\n    globalTaxCalculation: 'TaxExcluded' | 'NotApplicable';\n  };\n}\n\n// ============================================================================\n// Model constructor option interfaces\n//\n// Each model's `constructor(options)` accepts a partial bag of its own fields.\n// Declaring a dedicated `XxxOptions extends SmrtObjectOptions` interface keeps\n// the constructors strongly typed (no `any`) while still allowing the\n// framework's base options (db, ai, fs, _className, …) through.\n// ============================================================================\n\n/**\n * Constructor options for {@link Customer}.\n */\nexport interface CustomerOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  creditLimit?: number;\n  paymentTerms?: string;\n  taxExempt?: boolean;\n  taxId?: string;\n  defaultTaxCodeId?: string;\n  defaultShippingAddress?: Address;\n  defaultBillingAddress?: Address;\n  status?: CustomerStatus;\n  customerType?: CustomerType | null;\n  notes?: string;\n  contacts?: PartyContact[] | string | null;\n}\n\n/**\n * Constructor options for {@link Vendor}.\n */\nexport interface VendorOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  profileId?: string;\n  leadTimeDays?: number;\n  minimumOrderAmount?: number;\n  paymentTerms?: string;\n  currency?: string;\n  taxId?: string;\n  defaultTaxCodeId?: string;\n  defaultContactEmail?: string;\n  defaultContactPhone?: string;\n  status?: VendorStatus;\n  notes?: string;\n  payoutAddresses?: Record<string, string> | string | null;\n  contacts?: PartyContact[] | string | null;\n}\n\n/** A component reference stored in a tax code's ordered component list. */\nexport interface TaxCodePart {\n  taxComponentId: string;\n  compound: boolean;\n}\n\nexport interface TaxComponentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  name?: string;\n  percent?: string;\n  liabilityAccountId?: string;\n  recoverable?: boolean;\n  active?: boolean;\n}\n\nexport interface TaxCodeOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  code?: string;\n  name?: string;\n  kind?: 'taxable' | 'zero-rated' | 'exempt' | 'out-of-scope';\n  appliesTo?: 'sales' | 'purchases' | 'both';\n  components?: TaxCodePart[];\n  active?: boolean;\n}\n\nexport interface TaxRegistrationOptions {\n  taxComponentId: string;\n  number: string;\n  label: string;\n}\n\nexport interface TaxSettingsOptions extends SmrtObjectOptions {\n  tenantId?: string;\n  defaultSalesTaxCodeId?: string;\n  defaultPurchaseTaxCodeId?: string;\n  defaultLineAmountType?: 'exclusive' | 'inclusive' | 'none';\n  taxRoundingScope?: 'line' | 'document';\n  taxRegistrations?: TaxRegistrationOptions[];\n}\n\n/**\n * Constructor options for {@link Contract} and its STI subtypes.\n */\nexport interface ContractOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractType?: ContractType;\n  status?: ContractStatus;\n  subtotal?: number;\n  discountTotal?: number;\n  taxAmount?: number;\n  totalAmount?: number;\n  currency?: string;\n  issueDate?: Date;\n  dueDate?: Date | null;\n  expiryDate?: Date | null;\n  reference?: string;\n  notes?: string;\n  terms?: string;\n  channelId?: string;\n  lineAmountType?: 'exclusive' | 'inclusive' | 'none';\n  taxRoundingScope?: 'line' | 'document';\n  sellerTaxRegistrations?: TaxRegistrationOptions[];\n  sellerTaxRegistrationsJson?: string;\n  partyTaxId?: string;\n  moneySnapshotId?: string;\n  moneyAuthority?: 'calculated' | 'received';\n  receivedPurchaseMoneyJson?: string;\n  /** Command-owned contract schedule evidence. */\n  billingScheduleJson?: string;\n}\n\nexport interface SalesContractOptions extends ContractOptions {\n  customerId?: string | null;\n}\n\nexport interface PurchaseContractOptions extends ContractOptions {\n  vendorId?: string | null;\n}\n\n/** Purchase-order header options stored in the existing STI metadata. */\nexport interface PurchaseOrderOptions extends PurchaseContractOptions {\n  /** Expected delivery calendar date (YYYY-MM-DD); empty means unspecified. */\n  expectedDate?: string;\n  /** Delivery address/instructions snapshot. */\n  shipTo?: string;\n}\n\n/**\n * Constructor options for {@link LicenseSale} (Contract STI subtype). Extends\n * {@link ContractOptions} with the licensing-specific meta fields.\n */\nexport interface LicenseSaleOptions extends SalesContractOptions {\n  skuId?: string;\n  paymentId?: string;\n  licenseeEmail?: string;\n  licenseeLegalEntity?: string;\n  licenseeJurisdiction?: string;\n  rightsMedium?: string;\n  rightsDistributionScope?: string;\n  rightsExclusivity?: string;\n  rightsDuration?: string;\n  rightsTerritory?: string;\n  rightsSublicensing?: boolean;\n  rightsDerivatives?: boolean;\n  pdfUrl?: string;\n  pdfHash?: string;\n  onChainHashRegistryRef?: string;\n}\n\n/**\n * Constructor options for {@link ContractLineItem}.\n */\nexport interface ContractLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  description?: string;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  discountType?: 'none' | 'percent' | 'amount';\n  discountRate?: string;\n  taxRate?: number;\n  taxMode?: 'inherit' | 'override';\n  taxCodeId?: string | null;\n  taxCodeCode?: string | null;\n  taxCodeName?: string | null;\n  taxComponents?: ContractTaxComponentSnapshot[];\n  taxComponentsJson?: string | null;\n  taxAmount?: number;\n  moneySnapshotId?: string;\n  amount?: number;\n  productId?: string;\n  sku?: string;\n  startDate?: Date | null;\n  endDate?: Date | null;\n  billingPeriod?: string;\n  sortOrder?: number;\n}\n\n/** Immutable component tax allocation for one Contract line. */\nexport interface ContractTaxComponentSnapshot {\n  taxComponentId: string;\n  name: string;\n  percent: string;\n  taxMinor: number;\n  /** Missing on historical additive snapshots means false. */\n  compound?: boolean;\n  /** Actual component basis, including preceding tax when compound. */\n  taxableMinor?: number;\n}\n\n/**\n * How the provider collects an invoice (#3190): `charge_automatically`\n * charges the payer's saved card; `send_invoice` asks the payer to pay. Empty\n * for an invoice never pushed to a provider, or pushed before it was recorded.\n */\nexport type InvoiceCollectionMethod =\n  | ''\n  | 'send_invoice'\n  | 'charge_automatically';\n\nexport type InvoiceKind = 'invoice' | 'credit_note';\n\n/** Frozen source pricing plus the one authoritative credit calculation basis. */\nexport type InvoiceCreditCalculationBasis =\n  | {\n      kind: 'quantity';\n      quantity: string;\n      sourceQuantity: string;\n      sourceUnitPrice: number;\n      sourceDiscountType: 'none' | 'percent' | 'amount';\n      sourceDiscountRate: string;\n      sourceDiscountMinor: number;\n    }\n  | {\n      kind: 'net_amount';\n      netMinor: number;\n      sourceQuantity: string;\n      sourceUnitPrice: number;\n      sourceDiscountType: 'none' | 'percent' | 'amount';\n      sourceDiscountRate: string;\n      sourceDiscountMinor: number;\n    };\n\n/**\n * Constructor options for {@link Invoice}.\n */\nexport interface InvoiceOptions extends SmrtObjectOptions {\n  moneyAuthority?: 'calculated' | 'historical';\n  historicalSalesMoneyJson?: string;\n  historicalSourceKeyHash?: string | null;\n\n  kind?: InvoiceKind;\n  creditedInvoiceId?: string | null;\n  creditedAmount?: number;\n  tenantId?: string | null;\n  customerId?: string;\n  contractId?: string;\n  invoiceNumber?: string;\n  reference?: string;\n  issueDate?: Date;\n  dueDate?: Date | null;\n  paidDate?: Date | null;\n  subtotal?: number;\n  taxAmount?: number;\n  providerTaxAmount?: number;\n  totalAmount?: number;\n  amountPaid?: number;\n  currency?: string;\n  status?: InvoiceStatus;\n  arJournalId?: string;\n  arReversalJournalId?: string | null;\n  revenueJournalId?: string;\n  externalId?: string;\n  customerExternalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  collectionMethod?: InvoiceCollectionMethod;\n  sentAt?: Date | null;\n  viewedAt?: Date | null;\n  remindersSent?: number;\n  lastReminderAt?: Date | null;\n  notes?: string;\n  customerNotes?: string;\n  terms?: string;\n  lineAmountType?: 'exclusive' | 'inclusive' | 'none';\n  taxRoundingScope?: 'line' | 'document';\n  discountTotal?: number;\n  sellerTaxRegistrations?: TaxRegistrationOptions[];\n  sellerTaxRegistrationsJson?: string;\n  partyTaxId?: string;\n  moneySnapshotId?: string;\n  accountingSyncStateJson?: string;\n}\n\nexport interface InvoiceTaxComponentSnapshot {\n  taxComponentId: string;\n  name: string;\n  percent: string;\n  taxMinor: number;\n  /** Missing on historical additive snapshots means false. */\n  compound?: boolean;\n  /** Actual component basis, including preceding tax when compound. */\n  taxableMinor?: number;\n}\n\n/** Constructor options for {@link InvoiceLineItem}. */\nexport interface InvoiceLineItemOptions extends SmrtObjectOptions {\n  creditedLineId?: string | null;\n  creditCalculationBasis?: InvoiceCreditCalculationBasis | null;\n  creditCalculationBasisJson?: string;\n  tenantId?: string | null;\n  invoiceId?: string;\n  description?: string;\n  sku?: string;\n  productId?: string | null;\n  quantity?: number;\n  unitPrice?: number;\n  discount?: number;\n  discountType?: 'none' | 'percent' | 'amount';\n  discountRate?: string;\n  taxRate?: number;\n  taxMode?: 'inherit' | 'override';\n  taxCodeId?: string | null;\n  taxCodeCode?: string | null;\n  taxCodeName?: string | null;\n  taxComponents?: InvoiceTaxComponentSnapshot[];\n  taxComponentsJson?: string | null;\n  taxAmount?: number;\n  moneySnapshotId?: string;\n  amount?: number;\n  sourceType?: string;\n  sourceId?: string;\n  periodStart?: Date | null;\n  periodEnd?: Date | null;\n  revenueAccountId?: string | null;\n  sortOrder?: number;\n}\n\n/**\n * Constructor options for {@link Fulfillment}.\n */\nexport interface FulfillmentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  contractId?: string;\n  fulfillmentType?: FulfillmentType;\n  status?: FulfillmentStatus;\n  trackingNumber?: string;\n  carrier?: string;\n  shippingAddress?: Address;\n  shippedAt?: Date | null;\n  deliveredAt?: Date | null;\n  estimatedDelivery?: Date | null;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link FulfillmentLineItem}.\n */\nexport interface FulfillmentLineItemOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  fulfillmentId?: string;\n  contractLineItemId?: string;\n  quantityFulfilled?: number;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link Payment}.\n */\nexport interface PaymentOptions extends SmrtObjectOptions {\n  /** Internal command-owned customer funds evidence; use public commands. */\n  customerFundsJson?: string;\n  kind?: PaymentKind;\n  tenantId?: string | null;\n  contractId?: string | null;\n  customerId?: string | null;\n  amount?: number;\n  currency?: string;\n  method?: PaymentMethod;\n  status?: PaymentStatus;\n  transactionId?: string;\n  reference?: string;\n  journalId?: string;\n  paidAt?: Date | null;\n  notes?: string;\n  externalId?: string;\n  externalProvider?: string;\n  syncedAt?: Date | null;\n  backendId?: string;\n  backendTxRef?: string;\n  nativeAmount?: number;\n  nativeCurrency?: string;\n  usdAtQuote?: number;\n  usdAtConfirmation?: number;\n  connectedAccountId?: string;\n  applicationFeeCents?: number;\n  refundOfPaymentId?: string;\n  connectedRefundState?: '' | 'requested' | 'pending' | 'succeeded' | 'failed';\n  applicationFeeRefunded?: boolean;\n}\n\n/**\n * Constructor options for {@link PaymentInstrument}.\n */\nexport interface PaymentInstrumentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  customerId?: string;\n  backendId?: string;\n  providerCustomerId?: string;\n  providerPaymentMethodId?: string;\n  type?: string;\n  brand?: string;\n  last4?: string;\n  expMonth?: number;\n  expYear?: number;\n  isDefault?: boolean;\n  status?: PaymentInstrumentStatus;\n}\n\n/**\n * Constructor options for {@link PaymentAllocation}.\n */\nexport interface PaymentAllocationOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  invoiceId?: string;\n  amount?: number;\n  allocatedAt?: Date;\n  allocatedBy?: string;\n  notes?: string;\n}\n\n/**\n * Constructor options for {@link PaymentIntent}.\n */\nexport interface PaymentIntentOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  skuId?: string;\n  offeringRef?: string;\n  licenseeEmail?: string;\n  customerId?: string;\n  paymentOptions?: PaymentOption[] | string;\n  usdPriceLocked?: number;\n  priceLockWindowMs?: number;\n  priceLockExpiresAt?: Date | number | string | null;\n  status?: PaymentIntentStatus;\n  idempotencyKey?: string;\n  paidOptionBackendId?: string;\n  paymentId?: string;\n  paidAt?: Date | number | string | null;\n  issuedAt?: Date | number | string | null;\n  expiredAt?: Date | number | string | null;\n  cancelledAt?: Date | number | string | null;\n  retiredAt?: Date | number | string | null;\n  notes?: string;\n  connectedAccountId?: string;\n  applicationFeeCents?: number;\n  connectedEnvironment?: string;\n  connectedAmount?: number;\n  connectedCurrency?: string;\n}\n\n/**\n * Constructor options for {@link Payout}.\n */\nexport interface PayoutOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  paymentId?: string;\n  vendorId?: string;\n  grossAmount?: number;\n  operatorFee?: number;\n  supplierNet?: number;\n  currency?: string;\n  backendId?: string;\n  backendTxRef?: string;\n  status?: PayoutStatus;\n  sentAt?: Date | number | string | null;\n  confirmedAt?: Date | number | string | null;\n  failedAt?: Date | number | string | null;\n  failureReason?: string;\n  notes?: string;\n}\n"],"mappings":"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"}

package/dist/collections/TenantPaymentAccountCollection.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TenantPaymentAccountCollection - collection for tenant-owned connected
+ * payment accounts (#3831). Writes go through the connected-payments
+ * commands; see `agents/connected-payments.md`.
+ * @packageDocumentation
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { TenantPaymentAccount, type TenantPaymentEnvironment } from '../models/TenantPaymentAccount.js';
+export declare class TenantPaymentAccountCollection extends SmrtCollection<TenantPaymentAccount> {
+    static readonly _itemClass: typeof TenantPaymentAccount;
+    /**
+     * @internal An unsaved account for the connected-payments commands, which
+     * own every write (`save()` refuses any other caller).
+     */
+    build(options: Parameters<SmrtCollection<TenantPaymentAccount>['create']>[0]): Promise<TenantPaymentAccount>;
+    /**
+     * The tenant's account for a backend and environment, or `null`.
+     *
+     * @param args - Tenant, backend and environment
+     * @returns The account or null
+     */
+    findForTenant(args: {
+        tenantId: string;
+        backendId: string;
+        environment: TenantPaymentEnvironment;
+    }): Promise<TenantPaymentAccount | null>;
+}
+//# sourceMappingURL=TenantPaymentAccountCollection.d.ts.map

package/dist/collections/TenantPaymentAccountCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantPaymentAccountCollection.d.ts","sourceRoot":"","sources":["../../src/collections/TenantPaymentAccountCollection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,oBAAoB,EACpB,KAAK,wBAAwB,EAC9B,MAAM,mCAAmC,CAAC;AAE3C,qBAAa,8BAA+B,SAAQ,cAAc,CAAC,oBAAoB,CAAC;IACtF,MAAM,CAAC,QAAQ,CAAC,UAAU,8BAAwB;IAElD;;;OAGG;IACG,KAAK,CACT,OAAO,EAAE,UAAU,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GACrE,OAAO,CAAC,oBAAoB,CAAC;IAIhC;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,wBAAwB,CAAC;KACvC,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;CAazC"}

package/dist/collections/index.d.ts

@@ -22,5 +22,6 @@ export { TaxCodeCollection } from './TaxCodeCollection.js';
 export { TaxComponentCollection } from './TaxComponentCollection.js';
 export { TaxSettingsCollection } from './TaxSettingsCollection.js';
 export { type RefreshTaxSummaryReportOptions, type TaxSummaryContributorDrilldown, type TaxSummaryContributorDrilldownOptions, type TaxSummaryDrilldownContributor, type TaxSummaryDrilldownPending, type TaxSummaryExpenseSource, type TaxSummaryInvoiceDrilldownOptions, type TaxSummaryLedgerDrilldownFact, type TaxSummaryLedgerDrilldownSource, type TaxSummaryLedgerSource, TaxSummaryReportCollection, type TaxSummaryReportMeasure, type TaxSummaryReportRefreshResult, } from './TaxSummaryReportCollection.js';
+export { TenantPaymentAccountCollection } from './TenantPaymentAccountCollection.js';
 export { VendorCollection } from './VendorCollection.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/collections/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,2BAA2B,EAChC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,GACnC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,2BAA2B,EAChC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,GACnC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/connected-payments-internal.d.ts

@@ -0,0 +1,5 @@
+/** @internal Run a connected-payments command write for one tenant. */
+export declare function withConnectedPaymentAuthority<T>(tenantId: string, operation: () => Promise<T>): Promise<T>;
+/** @internal Whether a connected-payments command for this tenant is running. */
+export declare function hasConnectedPaymentAuthority(tenantId: string | null | undefined): boolean;
+//# sourceMappingURL=connected-payments-internal.d.ts.map

package/dist/connected-payments-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-payments-internal.d.ts","sourceRoot":"","sources":["../src/connected-payments-internal.ts"],"names":[],"mappings":"AAUA,uEAAuE;AACvE,wBAAgB,6BAA6B,CAAC,CAAC,EAC7C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,OAAO,CAOT"}