@contractspec/example.integration-stripe 1.57.0 → 1.58.0

package/dist/browser/index.js

@@ -0,0 +1,261 @@
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var artisanStripeBlueprint = {
+  meta: {
+    key: "artisan.payments.stripe",
+    version: "1.0.0",
+    appId: "artisan",
+    title: "ArtisanOS Stripe Payments",
+    description: "Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.",
+    domain: "payments",
+    owners: [OwnersEnum.PlatformCore],
+    tags: [TagsEnum.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum.Experimental
+  },
+  capabilities: {
+    enabled: [{ key: "payments.psp", version: "1.0.0" }]
+  },
+  integrationSlots: [
+    {
+      slotId: "primary-payments",
+      requiredCategory: "payments",
+      allowedModes: ["managed", "byok"],
+      requiredCapabilities: [{ key: "payments.psp", version: "1.0.0" }],
+      required: true,
+      description: "Primary card processor slot. Bind the tenant Stripe connection here."
+    }
+  ],
+  branding: {
+    appNameKey: "artisan.payments.appName",
+    assets: [
+      { type: "logo", url: "https://cdn.artisanos.dev/branding/logo.png" },
+      {
+        type: "favicon",
+        url: "https://cdn.artisanos.dev/branding/favicon.ico"
+      }
+    ],
+    colorTokens: {
+      primary: "colors.brand.primary",
+      secondary: "colors.brand.secondary"
+    }
+  },
+  translationCatalog: {
+    key: "artisan.payments.catalog",
+    version: "1.0.0"
+  },
+  workflows: {
+    collectPayment: {
+      key: "artisan.payments.collectPayment",
+      version: "1.0.0"
+    }
+  },
+  policies: [{ key: "artisan.payments.default", version: "1.0.0" }],
+  notes: "Install this blueprint and pair it with the Stripe integration connection to enable card collection."
+};
+
+// src/connection.sample.ts
+var stripeLiveConnection = {
+  meta: {
+    id: "conn-stripe-live",
+    tenantId: "artisan-co",
+    integrationKey: "payments.stripe",
+    integrationVersion: "1",
+    label: "Stripe Production",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "managed",
+  config: {
+    accountId: "acct_xxx"
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/artisan-co/conn-stripe-live",
+  status: "connected"
+};
+
+// src/docs/integration-stripe.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.integration-stripe",
+    title: "Integration Example — Stripe Payments",
+    summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe",
+    tags: ["stripe", "payments", "integrations", "example"],
+    body: `## Included
+- App blueprint enabling \`payments.psp\` capability.
+- Workflow invoking Stripe operations (prepare → charge → confirm).
+- Tenant app config binding workflow to an IntegrationConnection.
+
+## Notes
+- Secrets live in secret providers; connection config is non-secret.
+- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+  },
+  {
+    id: "docs.examples.integration-stripe.usage",
+    title: "Stripe Integration Example — Usage",
+    summary: "How to use the blueprint, workflow, and tenant config together.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe/usage",
+    tags: ["stripe", "usage"],
+    body: `## Usage
+1) Register the blueprint + workflow + catalog in your registry.
+2) Persist an IntegrationConnection (see connection sample).
+3) Bind the tenant app config to the connection.
+
+## Guardrails
+- Never log secrets.
+- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "integration-stripe",
+    version: "1.0.0",
+    title: "Integration — Stripe Payments",
+    description: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+    kind: "integration",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["stripe", "payments", "integration", "blueprint", "workflow"]
+  },
+  docs: {
+    rootDocId: "docs.examples.integration-stripe",
+    usageDocId: "docs.examples.integration-stripe.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.integration-stripe",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+
+// src/workflow.ts
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts/ownership";
+var collectPaymentWorkflow = {
+  meta: {
+    key: "artisan.payments.collectPayment",
+    version: "1.0.0",
+    title: "Collect Card Payment",
+    description: "Charge a customer using the tenant Stripe connection and record settlement details.",
+    domain: "payments",
+    owners: [OwnersEnum2.PlatformCore],
+    tags: [TagsEnum2.Marketplace, "stripe"],
+    stability: StabilityEnum2.Experimental
+  },
+  definition: {
+    entryStepId: "prepare",
+    steps: [
+      {
+        id: "prepare",
+        type: "automation",
+        label: "Prepare charge parameters",
+        action: {
+          operation: { key: "payments.prepareCharge", version: "1.0.0" }
+        }
+      },
+      {
+        id: "charge",
+        type: "automation",
+        label: "Charge card via Stripe",
+        action: {
+          operation: { key: "payments.stripe.chargeCard", version: "1.0.0" }
+        }
+      },
+      {
+        id: "confirm",
+        type: "automation",
+        label: "Confirm settlement",
+        action: {
+          operation: { key: "payments.recordSettlement", version: "1.0.0" }
+        }
+      }
+    ],
+    transitions: [
+      { from: "prepare", to: "charge" },
+      { from: "charge", to: "confirm", condition: "output.success === true" }
+    ]
+  }
+};
+
+// src/tenant.ts
+var artisanStripeTenantConfig = {
+  meta: {
+    id: "tenant-config-artisan-stripe",
+    tenantId: "artisan-co",
+    appId: "artisan",
+    blueprintName: "artisan.payments.stripe",
+    blueprintVersion: "1.0.0",
+    environment: "production",
+    version: "1.0.0",
+    status: "published",
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString()
+  },
+  integrations: [
+    {
+      slotId: "primary-payments",
+      connectionId: "conn-stripe-live",
+      scope: {
+        workflows: ["collectPayment"],
+        operations: ["payments.stripe.chargeCard"]
+      }
+    }
+  ],
+  knowledge: [],
+  locales: {
+    defaultLocale: "en",
+    enabledLocales: ["en", "fr"]
+  },
+  translationOverrides: {
+    entries: [
+      {
+        key: "artisan.payments.appName",
+        locale: "en",
+        value: "Artisan Payments Portal"
+      }
+    ]
+  },
+  branding: {
+    appName: { en: "Artisan Payments Portal" },
+    assets: [
+      { type: "logo", url: "https://tenant.artisanos.dev/logo.png" },
+      { type: "logo-dark", url: "https://tenant.artisanos.dev/logo-dark.png" }
+    ],
+    colors: {
+      primary: "#F97316",
+      secondary: "#1F2937"
+    },
+    customDomain: "pay.artisanos.dev"
+  },
+  notes: "Stripe connection bound for production payments."
+};
+export {
+  stripeLiveConnection,
+  example_default as example,
+  collectPaymentWorkflow,
+  artisanStripeTenantConfig,
+  artisanStripeBlueprint
+};

package/dist/browser/tenant.js

@@ -0,0 +1,55 @@
+// src/tenant.ts
+var artisanStripeTenantConfig = {
+  meta: {
+    id: "tenant-config-artisan-stripe",
+    tenantId: "artisan-co",
+    appId: "artisan",
+    blueprintName: "artisan.payments.stripe",
+    blueprintVersion: "1.0.0",
+    environment: "production",
+    version: "1.0.0",
+    status: "published",
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString()
+  },
+  integrations: [
+    {
+      slotId: "primary-payments",
+      connectionId: "conn-stripe-live",
+      scope: {
+        workflows: ["collectPayment"],
+        operations: ["payments.stripe.chargeCard"]
+      }
+    }
+  ],
+  knowledge: [],
+  locales: {
+    defaultLocale: "en",
+    enabledLocales: ["en", "fr"]
+  },
+  translationOverrides: {
+    entries: [
+      {
+        key: "artisan.payments.appName",
+        locale: "en",
+        value: "Artisan Payments Portal"
+      }
+    ]
+  },
+  branding: {
+    appName: { en: "Artisan Payments Portal" },
+    assets: [
+      { type: "logo", url: "https://tenant.artisanos.dev/logo.png" },
+      { type: "logo-dark", url: "https://tenant.artisanos.dev/logo-dark.png" }
+    ],
+    colors: {
+      primary: "#F97316",
+      secondary: "#1F2937"
+    },
+    customDomain: "pay.artisanos.dev"
+  },
+  notes: "Stripe connection bound for production payments."
+};
+export {
+  artisanStripeTenantConfig
+};

package/dist/browser/workflow.js

@@ -0,0 +1,54 @@
+// src/workflow.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var collectPaymentWorkflow = {
+  meta: {
+    key: "artisan.payments.collectPayment",
+    version: "1.0.0",
+    title: "Collect Card Payment",
+    description: "Charge a customer using the tenant Stripe connection and record settlement details.",
+    domain: "payments",
+    owners: [OwnersEnum.PlatformCore],
+    tags: [TagsEnum.Marketplace, "stripe"],
+    stability: StabilityEnum.Experimental
+  },
+  definition: {
+    entryStepId: "prepare",
+    steps: [
+      {
+        id: "prepare",
+        type: "automation",
+        label: "Prepare charge parameters",
+        action: {
+          operation: { key: "payments.prepareCharge", version: "1.0.0" }
+        }
+      },
+      {
+        id: "charge",
+        type: "automation",
+        label: "Charge card via Stripe",
+        action: {
+          operation: { key: "payments.stripe.chargeCard", version: "1.0.0" }
+        }
+      },
+      {
+        id: "confirm",
+        type: "automation",
+        label: "Confirm settlement",
+        action: {
+          operation: { key: "payments.recordSettlement", version: "1.0.0" }
+        }
+      }
+    ],
+    transitions: [
+      { from: "prepare", to: "charge" },
+      { from: "charge", to: "confirm", condition: "output.success === true" }
+    ]
+  }
+};
+export {
+  collectPaymentWorkflow
+};

package/dist/connection.sample.d.ts

@@ -1,7 +1,3 @@
-import { IntegrationConnection } from "@contractspec/lib.contracts/integrations/connection";
-
-//#region src/connection.sample.d.ts
-declare const stripeLiveConnection: IntegrationConnection;
-//#endregion
-export { stripeLiveConnection };
+import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';
+export declare const stripeLiveConnection: IntegrationConnection;
 //# sourceMappingURL=connection.sample.d.ts.map

package/dist/connection.sample.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.sample.d.ts","names":[],"sources":["../src/connection.sample.ts"],"mappings":";;;cAEa,oBAAA,EAAsB,qBAAA"}
+{"version":3,"file":"connection.sample.d.ts","sourceRoot":"","sources":["../src/connection.sample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAEjG,eAAO,MAAM,oBAAoB,EAAE,qBAkBlC,CAAC"}

package/dist/connection.sample.js

@@ -1,22 +1,24 @@
-//#region src/connection.sample.ts
-const stripeLiveConnection = {
-	meta: {
-		id: "conn-stripe-live",
-		tenantId: "artisan-co",
-		integrationKey: "payments.stripe",
-		integrationVersion: "1",
-		label: "Stripe Production",
-		environment: "production",
-		createdAt: "2026-01-01T00:00:00.000Z",
-		updatedAt: "2026-01-01T00:00:00.000Z"
-	},
-	ownershipMode: "managed",
-	config: { accountId: "acct_xxx" },
-	secretProvider: "vault",
-	secretRef: "vault://integrations/artisan-co/conn-stripe-live",
-	status: "connected"
+// @bun
+// src/connection.sample.ts
+var stripeLiveConnection = {
+  meta: {
+    id: "conn-stripe-live",
+    tenantId: "artisan-co",
+    integrationKey: "payments.stripe",
+    integrationVersion: "1",
+    label: "Stripe Production",
+    environment: "production",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  ownershipMode: "managed",
+  config: {
+    accountId: "acct_xxx"
+  },
+  secretProvider: "vault",
+  secretRef: "vault://integrations/artisan-co/conn-stripe-live",
+  status: "connected"
+};
+export {
+  stripeLiveConnection
 };
-
-//#endregion
-export { stripeLiveConnection };
-//# sourceMappingURL=connection.sample.js.map

package/dist/docs/index.d.ts

@@ -1 +1,2 @@
-export { };
+import './integration-stripe.docblock';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,+BAA+B,CAAC"}

package/dist/docs/index.js

@@ -1 +1,40 @@
-import "./integration-stripe.docblock.js";
+// @bun
+// src/docs/integration-stripe.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.integration-stripe",
+    title: "Integration Example \u2014 Stripe Payments",
+    summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe",
+    tags: ["stripe", "payments", "integrations", "example"],
+    body: `## Included
+- App blueprint enabling \`payments.psp\` capability.
+- Workflow invoking Stripe operations (prepare \u2192 charge \u2192 confirm).
+- Tenant app config binding workflow to an IntegrationConnection.
+
+## Notes
+- Secrets live in secret providers; connection config is non-secret.
+- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+  },
+  {
+    id: "docs.examples.integration-stripe.usage",
+    title: "Stripe Integration Example \u2014 Usage",
+    summary: "How to use the blueprint, workflow, and tenant config together.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe/usage",
+    tags: ["stripe", "usage"],
+    body: `## Usage
+1) Register the blueprint + workflow + catalog in your registry.
+2) Persist an IntegrationConnection (see connection sample).
+3) Bind the tenant app config to the connection.
+
+## Guardrails
+- Never log secrets.
+- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/docs/integration-stripe.docblock.d.ts

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=integration-stripe.docblock.d.ts.map

package/dist/docs/integration-stripe.docblock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-stripe.docblock.d.ts","sourceRoot":"","sources":["../../src/docs/integration-stripe.docblock.ts"],"names":[],"mappings":""}

package/dist/docs/integration-stripe.docblock.js

@@ -1,30 +1,40 @@
+// @bun
+// src/docs/integration-stripe.docblock.ts
 import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.integration-stripe",
+    title: "Integration Example \u2014 Stripe Payments",
+    summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe",
+    tags: ["stripe", "payments", "integrations", "example"],
+    body: `## Included
+- App blueprint enabling \`payments.psp\` capability.
+- Workflow invoking Stripe operations (prepare \u2192 charge \u2192 confirm).
+- Tenant app config binding workflow to an IntegrationConnection.
 
-//#region src/docs/integration-stripe.docblock.ts
-registerDocBlocks([{
-	id: "docs.examples.integration-stripe",
-	title: "Integration Example — Stripe Payments",
-	summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/examples/integration-stripe",
-	tags: [
-		"stripe",
-		"payments",
-		"integrations",
-		"example"
-	],
-	body: `## Included\n- App blueprint enabling \`payments.psp\` capability.\n- Workflow invoking Stripe operations (prepare → charge → confirm).\n- Tenant app config binding workflow to an IntegrationConnection.\n\n## Notes\n- Secrets live in secret providers; connection config is non-secret.\n- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
-}, {
-	id: "docs.examples.integration-stripe.usage",
-	title: "Stripe Integration Example — Usage",
-	summary: "How to use the blueprint, workflow, and tenant config together.",
-	kind: "usage",
-	visibility: "public",
-	route: "/docs/examples/integration-stripe/usage",
-	tags: ["stripe", "usage"],
-	body: `## Usage\n1) Register the blueprint + workflow + catalog in your registry.\n2) Persist an IntegrationConnection (see connection sample).\n3) Bind the tenant app config to the connection.\n\n## Guardrails\n- Never log secrets.\n- Keep payment semantics spec-defined; gate breaking changes behind flags.`
-}]);
+## Notes
+- Secrets live in secret providers; connection config is non-secret.
+- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+  },
+  {
+    id: "docs.examples.integration-stripe.usage",
+    title: "Stripe Integration Example \u2014 Usage",
+    summary: "How to use the blueprint, workflow, and tenant config together.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/integration-stripe/usage",
+    tags: ["stripe", "usage"],
+    body: `## Usage
+1) Register the blueprint + workflow + catalog in your registry.
+2) Persist an IntegrationConnection (see connection sample).
+3) Bind the tenant app config to the connection.
 
-//#endregion
-//# sourceMappingURL=integration-stripe.docblock.js.map
+## Guardrails
+- Never log secrets.
+- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/example.d.ts

@@ -1,7 +1,3 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/example.d.ts
-declare const example: _contractspec_lib_contracts0.ExampleSpec;
-//#endregion
-export { example as default };
+declare const example: import("@contractspec/lib.contracts").ExampleSpec;
+export default example;
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,OAAO,mDA2BX,CAAC;AAEH,eAAe,OAAO,CAAC"}

package/dist/example.js

@@ -1,46 +1,34 @@
+// @bun
+// src/example.ts
 import { defineExample } from "@contractspec/lib.contracts";
-
-//#region src/example.ts
-const example = defineExample({
-	meta: {
-		key: "integration-stripe",
-		version: "1.0.0",
-		title: "Integration — Stripe Payments",
-		description: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
-		kind: "integration",
-		visibility: "public",
-		stability: "experimental",
-		owners: ["@platform.core"],
-		tags: [
-			"stripe",
-			"payments",
-			"integration",
-			"blueprint",
-			"workflow"
-		]
-	},
-	docs: {
-		rootDocId: "docs.examples.integration-stripe",
-		usageDocId: "docs.examples.integration-stripe.usage"
-	},
-	entrypoints: {
-		packageName: "@contractspec/example.integration-stripe",
-		docs: "./docs"
-	},
-	surfaces: {
-		templates: true,
-		sandbox: {
-			enabled: true,
-			modes: ["markdown", "specs"]
-		},
-		studio: {
-			enabled: true,
-			installable: true
-		},
-		mcp: { enabled: true }
-	}
+var example = defineExample({
+  meta: {
+    key: "integration-stripe",
+    version: "1.0.0",
+    title: "Integration \u2014 Stripe Payments",
+    description: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+    kind: "integration",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["stripe", "payments", "integration", "blueprint", "workflow"]
+  },
+  docs: {
+    rootDocId: "docs.examples.integration-stripe",
+    usageDocId: "docs.examples.integration-stripe.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.integration-stripe",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "specs"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
 });
-
-//#endregion
-export { example as default };
-//# sourceMappingURL=example.js.map
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { artisanStripeBlueprint } from "./blueprint.js";
-import { stripeLiveConnection } from "./connection.sample.js";
-import example from "./example.js";
-import { collectPaymentWorkflow } from "./workflow.js";
-import { artisanStripeTenantConfig } from "./tenant.js";
-export { artisanStripeBlueprint, artisanStripeTenantConfig, collectPaymentWorkflow, example, stripeLiveConnection };
+export * from './blueprint';
+export * from './workflow';
+export * from './tenant';
+export * from './connection.sample';
+export { default as example } from './example';
+import './docs';
+//# sourceMappingURL=index.d.ts.map