@contractspec/example.integration-stripe 1.44.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,37 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/integration-stripe/tsdown.config.js 
+ℹ entry: src/blueprint.ts, src/connection.sample.ts, src/example.ts, src/index.ts, src/tenant.ts, src/workflow.ts, src/docs/index.ts, src/docs/integration-stripe.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 28 files
+ℹ dist/blueprint.js                             1.68 kB │ gzip: 0.73 kB
+ℹ dist/docs/integration-stripe.docblock.js      1.59 kB │ gzip: 0.74 kB
+ℹ dist/workflow.js                              1.33 kB │ gzip: 0.57 kB
+ℹ dist/tenant.js                                1.28 kB │ gzip: 0.63 kB
+ℹ dist/example.js                               0.89 kB │ gzip: 0.47 kB
+ℹ dist/connection.sample.js                     0.60 kB │ gzip: 0.35 kB
+ℹ dist/index.js                                 0.44 kB │ gzip: 0.20 kB
+ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
+ℹ dist/blueprint.js.map                         2.68 kB │ gzip: 1.10 kB
+ℹ dist/workflow.js.map                          2.22 kB │ gzip: 0.84 kB
+ℹ dist/tenant.js.map                            2.20 kB │ gzip: 0.97 kB
+ℹ dist/docs/integration-stripe.docblock.js.map  2.09 kB │ gzip: 0.93 kB
+ℹ dist/example.js.map                           1.25 kB │ gzip: 0.64 kB
+ℹ dist/connection.sample.js.map                 1.03 kB │ gzip: 0.52 kB
+ℹ dist/connection.sample.d.ts.map               0.15 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
+ℹ dist/blueprint.d.ts.map                       0.13 kB │ gzip: 0.12 kB
+ℹ dist/workflow.d.ts.map                        0.13 kB │ gzip: 0.12 kB
+ℹ dist/tenant.d.ts.map                          0.12 kB │ gzip: 0.12 kB
+ℹ dist/example.d.ts                             1.12 kB │ gzip: 0.47 kB
+ℹ dist/index.d.ts                               0.39 kB │ gzip: 0.17 kB
+ℹ dist/connection.sample.d.ts                   0.28 kB │ gzip: 0.17 kB
+ℹ dist/blueprint.d.ts                           0.25 kB │ gzip: 0.17 kB
+ℹ dist/tenant.d.ts                              0.25 kB │ gzip: 0.17 kB
+ℹ dist/workflow.d.ts                            0.24 kB │ gzip: 0.16 kB
+ℹ dist/docs/index.d.ts                          0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/integration-stripe.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 27 files, total: 22.55 kB
+✔ Build complete in 14500ms

package/.turbo/turbo-build.log

@@ -0,0 +1,38 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/integration-stripe/tsdown.config.js (unrun)
+ℹ entry: src/blueprint.ts, src/connection.sample.ts, src/example.ts, src/index.ts, src/tenant.ts, src/workflow.ts, src/docs/index.ts, src/docs/integration-stripe.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/blueprint.js                             1.68 kB │ gzip: 0.73 kB
+ℹ dist/docs/integration-stripe.docblock.js      1.59 kB │ gzip: 0.74 kB
+ℹ dist/workflow.js                              1.33 kB │ gzip: 0.57 kB
+ℹ dist/tenant.js                                1.28 kB │ gzip: 0.63 kB
+ℹ dist/example.js                               0.89 kB │ gzip: 0.47 kB
+ℹ dist/connection.sample.js                     0.60 kB │ gzip: 0.35 kB
+ℹ dist/index.js                                 0.44 kB │ gzip: 0.20 kB
+ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
+ℹ dist/blueprint.js.map                         2.68 kB │ gzip: 1.10 kB
+ℹ dist/workflow.js.map                          2.22 kB │ gzip: 0.84 kB
+ℹ dist/tenant.js.map                            2.20 kB │ gzip: 0.97 kB
+ℹ dist/docs/integration-stripe.docblock.js.map  2.09 kB │ gzip: 0.93 kB
+ℹ dist/example.js.map                           1.25 kB │ gzip: 0.64 kB
+ℹ dist/connection.sample.js.map                 1.03 kB │ gzip: 0.52 kB
+ℹ dist/connection.sample.d.ts.map               0.15 kB │ gzip: 0.13 kB
+ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
+ℹ dist/blueprint.d.ts.map                       0.13 kB │ gzip: 0.12 kB
+ℹ dist/workflow.d.ts.map                        0.13 kB │ gzip: 0.12 kB
+ℹ dist/tenant.d.ts.map                          0.12 kB │ gzip: 0.12 kB
+ℹ dist/example.d.ts                             1.12 kB │ gzip: 0.47 kB
+ℹ dist/index.d.ts                               0.39 kB │ gzip: 0.17 kB
+ℹ dist/connection.sample.d.ts                   0.28 kB │ gzip: 0.17 kB
+ℹ dist/blueprint.d.ts                           0.25 kB │ gzip: 0.17 kB
+ℹ dist/tenant.d.ts                              0.25 kB │ gzip: 0.17 kB
+ℹ dist/workflow.d.ts                            0.24 kB │ gzip: 0.16 kB
+ℹ dist/docs/index.d.ts                          0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/integration-stripe.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 27 files, total: 22.55 kB
+✔ Build complete in 16986ms

package/CHANGELOG.md

@@ -0,0 +1,161 @@
+# @contractspec/example.integration-stripe
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.schema@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.schema@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.schema@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+### Integration Example – Stripe Payments
+
+Website: https://contractspec.io/
+
+
+This example shows how to wire the `IntegrationSpec`/`TenantAppConfig` layers together to enable Stripe-backed payments for ArtisanOS.
+
+Files included:
+
+- `blueprint.ts` – declares the `AppBlueprintSpec` enabling the `payments.psp` capability and mapping the payment workflow.
+- `workflow.ts` – minimal `WorkflowSpec` that invokes Stripe operations (`payments.stripe.chargeCard`).
+- `tenant.ts` – tenant configuration binding the workflow to a concrete Stripe `IntegrationConnection`.
+- `connection.sample.ts` – sample connection payload illustrating the data saved by the integrations service.
+- `translation.catalog.json` *(optional)* – canonical strings referenced by `branding.appNameKey`.
+
+When the workflow runner executes the `charge` step, the `WorkflowRunner` now surfaces the tenant `ResolvedAppConfig` (including integrations, branding, and translations) through `OperationExecutorContext.resolvedAppConfig`. An implementation of `opExecutor` can:
+
+- Pull the connection via `context.integrations[0]` and ask a `secretProvider` for Stripe keys.
+- Resolve tenant-specific branding via `context.branding` for emails or receipts.
+- Resolve localized copy using `context.translationResolver` (if provided by the host).
+
+Recommended next steps:
+
+1. Persist the sample connection through the integration CRUD contracts (`integrations.connection.create`).
+2. Register the blueprint + workflow + translation catalog in your registry.
+3. Use `registerIntegrationContracts` and `registerAppConfigContracts` to expose the connection, branding, and translation management operations.
+4. Implement the payment contract handlers to read `ctx.integrations`, fetch secrets through `ctx.secretProvider`, and execute Stripe calls.
+5. Render receipts or notifications by combining `ctx.branding` (logos/domain) and `ctx.translation.resolve(key, locale)` for localized copy.
+

package/dist/blueprint.d.ts

@@ -0,0 +1,7 @@
+import { AppBlueprintSpec } from "@contractspec/lib.contracts/app-config/spec";
+
+//#region src/blueprint.d.ts
+declare const artisanStripeBlueprint: AppBlueprintSpec;
+//#endregion
+export { artisanStripeBlueprint };
+//# sourceMappingURL=blueprint.d.ts.map

package/dist/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","names":[],"sources":["../src/blueprint.ts"],"sourcesContent":[],"mappings":";;;cAOa,wBAAwB"}

package/dist/blueprint.js

@@ -0,0 +1,66 @@
+import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts/ownership";
+
+//#region src/blueprint.ts
+const artisanStripeBlueprint = {
+	meta: {
+		key: "artisan.payments.stripe",
+		version: 1,
+		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
+	}] },
+	integrationSlots: [{
+		slotId: "primary-payments",
+		requiredCategory: "payments",
+		allowedModes: ["managed", "byok"],
+		requiredCapabilities: [{
+			key: "payments.psp",
+			version: 1
+		}],
+		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
+	},
+	workflows: { collectPayment: {
+		key: "artisan.payments.collectPayment",
+		version: 1
+	} },
+	policies: [{
+		key: "artisan.payments.default",
+		version: 1
+	}],
+	notes: "Install this blueprint and pair it with the Stripe integration connection to enable card collection."
+};
+
+//#endregion
+export { artisanStripeBlueprint };
+//# sourceMappingURL=blueprint.js.map

package/dist/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","names":["artisanStripeBlueprint: AppBlueprintSpec"],"sources":["../src/blueprint.ts"],"sourcesContent":["import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const artisanStripeBlueprint: AppBlueprintSpec = {\n  meta: {\n    key: 'artisan.payments.stripe',\n    version: 1,\n    appId: 'artisan',\n    title: 'ArtisanOS Stripe Payments',\n    description:\n      'Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.',\n    domain: 'payments',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [TagsEnum.Marketplace, 'stripe', 'payments'],\n    stability: StabilityEnum.Experimental,\n  },\n  capabilities: {\n    enabled: [{ key: 'payments.psp', version: 1 }],\n  },\n  integrationSlots: [\n    {\n      slotId: 'primary-payments',\n      requiredCategory: 'payments',\n      allowedModes: ['managed', 'byok'],\n      requiredCapabilities: [{ key: 'payments.psp', version: 1 }],\n      required: true,\n      description:\n        'Primary card processor slot. Bind the tenant Stripe connection here.',\n    },\n  ],\n  branding: {\n    appNameKey: 'artisan.payments.appName',\n    assets: [\n      { type: 'logo', url: 'https://cdn.artisanos.dev/branding/logo.png' },\n      {\n        type: 'favicon',\n        url: 'https://cdn.artisanos.dev/branding/favicon.ico',\n      },\n    ],\n    colorTokens: {\n      primary: 'colors.brand.primary',\n      secondary: 'colors.brand.secondary',\n    },\n  },\n  translationCatalog: {\n    key: 'artisan.payments.catalog',\n    version: 1,\n  },\n  workflows: {\n    collectPayment: { key: 'artisan.payments.collectPayment', version: 1 },\n  },\n  policies: [{ key: 'artisan.payments.default', version: 1 }],\n  notes:\n    'Install this blueprint and pair it with the Stripe integration connection to enable card collection.',\n};\n"],"mappings":";;;AAOA,MAAaA,yBAA2C;CACtD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM;GAAC,SAAS;GAAa;GAAU;GAAW;EAClD,WAAW,cAAc;EAC1B;CACD,cAAc,EACZ,SAAS,CAAC;EAAE,KAAK;EAAgB,SAAS;EAAG,CAAC,EAC/C;CACD,kBAAkB,CAChB;EACE,QAAQ;EACR,kBAAkB;EAClB,cAAc,CAAC,WAAW,OAAO;EACjC,sBAAsB,CAAC;GAAE,KAAK;GAAgB,SAAS;GAAG,CAAC;EAC3D,UAAU;EACV,aACE;EACH,CACF;CACD,UAAU;EACR,YAAY;EACZ,QAAQ,CACN;GAAE,MAAM;GAAQ,KAAK;GAA+C,EACpE;GACE,MAAM;GACN,KAAK;GACN,CACF;EACD,aAAa;GACX,SAAS;GACT,WAAW;GACZ;EACF;CACD,oBAAoB;EAClB,KAAK;EACL,SAAS;EACV;CACD,WAAW,EACT,gBAAgB;EAAE,KAAK;EAAmC,SAAS;EAAG,EACvE;CACD,UAAU,CAAC;EAAE,KAAK;EAA4B,SAAS;EAAG,CAAC;CAC3D,OACE;CACH"}

package/dist/connection.sample.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.sample.d.ts","names":[],"sources":["../src/connection.sample.ts"],"sourcesContent":[],"mappings":";;;cAEa,sBAAsB"}

package/dist/connection.sample.js

@@ -0,0 +1,22 @@
+//#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"
+};
+
+//#endregion
+export { stripeLiveConnection };
+//# sourceMappingURL=connection.sample.js.map

package/dist/connection.sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.sample.js","names":["stripeLiveConnection: IntegrationConnection"],"sources":["../src/connection.sample.ts"],"sourcesContent":["import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';\n\nexport const stripeLiveConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-stripe-live',\n    tenantId: 'artisan-co',\n    integrationKey: 'payments.stripe',\n    integrationVersion: 1,\n    label: 'Stripe Production',\n    environment: 'production',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  ownershipMode: 'managed',\n  config: {\n    accountId: 'acct_xxx',\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/artisan-co/conn-stripe-live',\n  status: 'connected',\n};\n"],"mappings":";AAEA,MAAaA,uBAA8C;CACzD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ,EACN,WAAW,YACZ;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./integration-stripe.docblock.js";

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

@@ -0,0 +1 @@
+export { };

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

@@ -0,0 +1,30 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#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.`
+}]);
+
+//#endregion
+//# sourceMappingURL=integration-stripe.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-stripe.docblock.js","names":[],"sources":["../../src/docs/integration-stripe.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.integration-stripe',\n    title: 'Integration Example — Stripe Payments',\n    summary:\n      'How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/integration-stripe',\n    tags: ['stripe', 'payments', 'integrations', 'example'],\n    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.`,\n  },\n  {\n    id: 'docs.examples.integration-stripe.usage',\n    title: 'Stripe Integration Example — Usage',\n    summary: 'How to use the blueprint, workflow, and tenant config together.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/integration-stripe/usage',\n    tags: ['stripe', 'usage'],\n    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.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA2BA,kBAxB2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAU;EAAY;EAAgB;EAAU;CACvD,MAAM;CACP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,UAAU,QAAQ;CACzB,MAAM;CACP,CACF,CAEwB"}

package/dist/example.d.ts

@@ -0,0 +1,34 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "integration-stripe";
+  readonly title: "Integration — Stripe Payments";
+  readonly summary: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).";
+  readonly tags: readonly ["stripe", "payments", "integration", "blueprint", "workflow"];
+  readonly kind: "integration";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.integration-stripe";
+    readonly usageDocId: "docs.examples.integration-stripe.usage";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.integration-stripe";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["markdown", "specs"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAsBI,EAAA,oBAAA"}

package/dist/example.js

@@ -0,0 +1,40 @@
+//#region src/example.ts
+const example = {
+	id: "integration-stripe",
+	title: "Integration — Stripe Payments",
+	summary: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+	tags: [
+		"stripe",
+		"payments",
+		"integration",
+		"blueprint",
+		"workflow"
+	],
+	kind: "integration",
+	visibility: "public",
+	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;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'integration-stripe',\n  title: 'Integration — Stripe Payments',\n  summary:\n    'Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).',\n  tags: ['stripe', 'payments', 'integration', 'blueprint', 'workflow'],\n  kind: 'integration',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.integration-stripe',\n    usageDocId: 'docs.examples.integration-stripe.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.integration-stripe',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAU;EAAY;EAAe;EAAa;EAAW;CACpE,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+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 };

package/dist/index.js

@@ -0,0 +1,8 @@
+import { artisanStripeBlueprint } from "./blueprint.js";
+import { stripeLiveConnection } from "./connection.sample.js";
+import example_default from "./example.js";
+import { collectPaymentWorkflow } from "./workflow.js";
+import { artisanStripeTenantConfig } from "./tenant.js";
+import "./docs/index.js";
+
+export { artisanStripeBlueprint, artisanStripeTenantConfig, collectPaymentWorkflow, example_default as example, stripeLiveConnection };

package/dist/tenant.d.ts

@@ -0,0 +1,7 @@
+import { TenantAppConfig } from "@contractspec/lib.contracts/app-config/spec";
+
+//#region src/tenant.d.ts
+declare const artisanStripeTenantConfig: TenantAppConfig;
+//#endregion
+export { artisanStripeTenantConfig };
+//# sourceMappingURL=tenant.d.ts.map

package/dist/tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.d.ts","names":[],"sources":["../src/tenant.ts"],"sourcesContent":[],"mappings":";;;cAEa,2BAA2B"}

package/dist/tenant.js

@@ -0,0 +1,53 @@
+//#region src/tenant.ts
+const artisanStripeTenantConfig = {
+	meta: {
+		id: "tenant-config-artisan-stripe",
+		tenantId: "artisan-co",
+		appId: "artisan",
+		blueprintName: "artisan.payments.stripe",
+		blueprintVersion: 1,
+		environment: "production",
+		version: 1,
+		status: "published",
+		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		updatedAt: (/* @__PURE__ */ 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."
+};
+
+//#endregion
+export { artisanStripeTenantConfig };
+//# sourceMappingURL=tenant.js.map

package/dist/tenant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.js","names":["artisanStripeTenantConfig: TenantAppConfig"],"sources":["../src/tenant.ts"],"sourcesContent":["import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';\n\nexport const artisanStripeTenantConfig: TenantAppConfig = {\n  meta: {\n    id: 'tenant-config-artisan-stripe',\n    tenantId: 'artisan-co',\n    appId: 'artisan',\n    blueprintName: 'artisan.payments.stripe',\n    blueprintVersion: 1,\n    environment: 'production',\n    version: 1,\n    status: 'published',\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n  },\n  integrations: [\n    {\n      slotId: 'primary-payments',\n      connectionId: 'conn-stripe-live',\n      scope: {\n        workflows: ['collectPayment'],\n        operations: ['payments.stripe.chargeCard'],\n      },\n    },\n  ],\n  knowledge: [],\n  locales: {\n    defaultLocale: 'en',\n    enabledLocales: ['en', 'fr'],\n  },\n  translationOverrides: {\n    entries: [\n      {\n        key: 'artisan.payments.appName',\n        locale: 'en',\n        value: 'Artisan Payments Portal',\n      },\n    ],\n  },\n  branding: {\n    appName: { en: 'Artisan Payments Portal' },\n    assets: [\n      { type: 'logo', url: 'https://tenant.artisanos.dev/logo.png' },\n      { type: 'logo-dark', url: 'https://tenant.artisanos.dev/logo-dark.png' },\n    ],\n    colors: {\n      primary: '#F97316',\n      secondary: '#1F2937',\n    },\n    customDomain: 'pay.artisanos.dev',\n  },\n  notes: 'Stripe connection bound for production payments.',\n};\n"],"mappings":";AAEA,MAAaA,4BAA6C;CACxD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,OAAO;EACP,eAAe;EACf,kBAAkB;EAClB,aAAa;EACb,SAAS;EACT,QAAQ;EACR,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,4BAAW,IAAI,MAAM,EAAC,aAAa;EACpC;CACD,cAAc,CACZ;EACE,QAAQ;EACR,cAAc;EACd,OAAO;GACL,WAAW,CAAC,iBAAiB;GAC7B,YAAY,CAAC,6BAA6B;GAC3C;EACF,CACF;CACD,WAAW,EAAE;CACb,SAAS;EACP,eAAe;EACf,gBAAgB,CAAC,MAAM,KAAK;EAC7B;CACD,sBAAsB,EACpB,SAAS,CACP;EACE,KAAK;EACL,QAAQ;EACR,OAAO;EACR,CACF,EACF;CACD,UAAU;EACR,SAAS,EAAE,IAAI,2BAA2B;EAC1C,QAAQ,CACN;GAAE,MAAM;GAAQ,KAAK;GAAyC,EAC9D;GAAE,MAAM;GAAa,KAAK;GAA8C,CACzE;EACD,QAAQ;GACN,SAAS;GACT,WAAW;GACZ;EACD,cAAc;EACf;CACD,OAAO;CACR"}

package/dist/workflow.d.ts

@@ -0,0 +1,7 @@
+import { WorkflowSpec } from "@contractspec/lib.contracts/workflow/spec";
+
+//#region src/workflow.d.ts
+declare const collectPaymentWorkflow: WorkflowSpec;
+//#endregion
+export { collectPaymentWorkflow };
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","names":[],"sources":["../src/workflow.ts"],"sourcesContent":[],"mappings":";;;cAOa,wBAAwB"}

package/dist/workflow.js

@@ -0,0 +1,59 @@
+import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts/ownership";
+
+//#region src/workflow.ts
+const collectPaymentWorkflow = {
+	meta: {
+		key: "artisan.payments.collectPayment",
+		version: 1,
+		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
+				} }
+			},
+			{
+				id: "charge",
+				type: "automation",
+				label: "Charge card via Stripe",
+				action: { operation: {
+					key: "payments.stripe.chargeCard",
+					version: 1
+				} }
+			},
+			{
+				id: "confirm",
+				type: "automation",
+				label: "Confirm settlement",
+				action: { operation: {
+					key: "payments.recordSettlement",
+					version: 1
+				} }
+			}
+		],
+		transitions: [{
+			from: "prepare",
+			to: "charge"
+		}, {
+			from: "charge",
+			to: "confirm",
+			condition: "output.success === true"
+		}]
+	}
+};
+
+//#endregion
+export { collectPaymentWorkflow };
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":["collectPaymentWorkflow: WorkflowSpec"],"sources":["../src/workflow.ts"],"sourcesContent":["import type { WorkflowSpec } from '@contractspec/lib.contracts/workflow/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const collectPaymentWorkflow: WorkflowSpec = {\n  meta: {\n    key: 'artisan.payments.collectPayment',\n    version: 1,\n    title: 'Collect Card Payment',\n    description:\n      'Charge a customer using the tenant Stripe connection and record settlement details.',\n    domain: 'payments',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [TagsEnum.Marketplace, 'stripe'],\n    stability: StabilityEnum.Experimental,\n  },\n  definition: {\n    entryStepId: 'prepare',\n    steps: [\n      {\n        id: 'prepare',\n        type: 'automation',\n        label: 'Prepare charge parameters',\n        action: {\n          operation: { key: 'payments.prepareCharge', version: 1 },\n        },\n      },\n      {\n        id: 'charge',\n        type: 'automation',\n        label: 'Charge card via Stripe',\n        action: {\n          operation: { key: 'payments.stripe.chargeCard', version: 1 },\n        },\n      },\n      {\n        id: 'confirm',\n        type: 'automation',\n        label: 'Confirm settlement',\n        action: {\n          operation: { key: 'payments.recordSettlement', version: 1 },\n        },\n      },\n    ],\n    transitions: [\n      { from: 'prepare', to: 'charge' },\n      { from: 'charge', to: 'confirm', condition: 'output.success === true' },\n    ],\n  },\n};\n"],"mappings":";;;AAOA,MAAaA,yBAAuC;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM,CAAC,SAAS,aAAa,SAAS;EACtC,WAAW,cAAc;EAC1B;CACD,YAAY;EACV,aAAa;EACb,OAAO;GACL;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA0B,SAAS;KAAG,EACzD;IACF;GACD;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA8B,SAAS;KAAG,EAC7D;IACF;GACD;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA6B,SAAS;KAAG,EAC5D;IACF;GACF;EACD,aAAa,CACX;GAAE,MAAM;GAAW,IAAI;GAAU,EACjC;GAAE,MAAM;GAAU,IAAI;GAAW,WAAW;GAA2B,CACxE;EACF;CACF"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@contractspec/example.integration-stripe",
+  "version": "1.44.0",
+  "description": "Integration example – Stripe Payments (blueprint + workflow + tenant config).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./blueprint": "./dist/blueprint.js",
+    "./connection.sample": "./dist/connection.sample.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/integration-stripe.docblock": "./dist/docs/integration-stripe.docblock.js",
+    "./example": "./dist/example.js",
+    "./tenant": "./dist/tenant.js",
+    "./workflow": "./dist/workflow.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./blueprint": "./dist/blueprint.js",
+      "./connection.sample": "./dist/connection.sample.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/integration-stripe.docblock": "./dist/docs/integration-stripe.docblock.js",
+      "./example": "./dist/example.js",
+      "./tenant": "./dist/tenant.js",
+      "./workflow": "./dist/workflow.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "module": "./dist/index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/integration-stripe"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/blueprint.ts

@@ -0,0 +1,59 @@
+import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config/spec';
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum,
+} from '@contractspec/lib.contracts/ownership';
+
+export const artisanStripeBlueprint: AppBlueprintSpec = {
+  meta: {
+    key: 'artisan.payments.stripe',
+    version: 1,
+    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 }],
+  },
+  integrationSlots: [
+    {
+      slotId: 'primary-payments',
+      requiredCategory: 'payments',
+      allowedModes: ['managed', 'byok'],
+      requiredCapabilities: [{ key: 'payments.psp', version: 1 }],
+      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,
+  },
+  workflows: {
+    collectPayment: { key: 'artisan.payments.collectPayment', version: 1 },
+  },
+  policies: [{ key: 'artisan.payments.default', version: 1 }],
+  notes:
+    'Install this blueprint and pair it with the Stripe integration connection to enable card collection.',
+};

package/src/connection.sample.ts

@@ -0,0 +1,21 @@
+import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';
+
+export const stripeLiveConnection: IntegrationConnection = {
+  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',
+};

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './integration-stripe.docblock';

package/src/docs/integration-stripe.docblock.ts

@@ -0,0 +1,28 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    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.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/example.ts

@@ -0,0 +1,25 @@
+const example = {
+  id: 'integration-stripe',
+  title: 'Integration — Stripe Payments',
+  summary:
+    'Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).',
+  tags: ['stripe', 'payments', 'integration', 'blueprint', 'workflow'],
+  kind: 'integration',
+  visibility: 'public',
+  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 },
+  },
+} as const;
+
+export default example;

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './blueprint';
+export * from './workflow';
+export * from './tenant';
+export * from './connection.sample';
+export { default as example } from './example';
+import './docs';

package/src/tenant.ts

@@ -0,0 +1,53 @@
+import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';
+
+export const artisanStripeTenantConfig: TenantAppConfig = {
+  meta: {
+    id: 'tenant-config-artisan-stripe',
+    tenantId: 'artisan-co',
+    appId: 'artisan',
+    blueprintName: 'artisan.payments.stripe',
+    blueprintVersion: 1,
+    environment: 'production',
+    version: 1,
+    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.',
+};

package/src/workflow.ts

@@ -0,0 +1,53 @@
+import type { WorkflowSpec } from '@contractspec/lib.contracts/workflow/spec';
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum,
+} from '@contractspec/lib.contracts/ownership';
+
+export const collectPaymentWorkflow: WorkflowSpec = {
+  meta: {
+    key: 'artisan.payments.collectPayment',
+    version: 1,
+    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 },
+        },
+      },
+      {
+        id: 'charge',
+        type: 'automation',
+        label: 'Charge card via Stripe',
+        action: {
+          operation: { key: 'payments.stripe.chargeCard', version: 1 },
+        },
+      },
+      {
+        id: 'confirm',
+        type: 'automation',
+        label: 'Confirm settlement',
+        action: {
+          operation: { key: 'payments.recordSettlement', version: 1 },
+        },
+      },
+    ],
+    transitions: [
+      { from: 'prepare', to: 'charge' },
+      { from: 'charge', to: 'confirm', condition: 'output.success === true' },
+    ],
+  },
+};

package/translation.catalog.json

@@ -0,0 +1,21 @@
+{
+  "meta": {
+    "name": "artisan.payments.catalog",
+    "version": 1
+  },
+  "defaultLocale": "en",
+  "supportedLocales": ["en", "fr"],
+  "entries": [
+    {
+      "key": "artisan.payments.appName",
+      "locale": "en",
+      "value": "Artisan Payments Portal"
+    },
+    {
+      "key": "artisan.payments.appName",
+      "locale": "fr",
+      "value": "Portail de paiement Artisan"
+    }
+  ]
+}
+

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}
+
+

package/tsdown.config.js

@@ -0,0 +1,6 @@
+import { defineConfig } from 'tsdown';
+import { moduleLibrary } from '@contractspec/tool.tsdown';
+
+export default defineConfig(() => ({
+  ...moduleLibrary,
+}));