@contractspec/example.integration-stripe 3.7.6 → 3.7.10

package/.turbo/turbo-build.log

@@ -2,43 +2,46 @@ $ contractspec-bun-build prebuild
 $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
-[contractspec-bun-build] transpile target=bun root=src entries=9 noBundle=false
-Bundled 9 modules in 32ms
+[contractspec-bun-build] transpile target=bun root=src entries=10 noBundle=false
+Bundled 10 modules in 33ms
 
-  ./blueprint.js                        1.77 KB  (entry point)
-  ./index.js                            8.59 KB  (entry point)
-  ./workflow.js                         1.42 KB  (entry point)
-  ./connection.sample.js                0.58 KB  (entry point)
-  docs/index.js                         1.59 KB  (entry point)
-  docs/integration-stripe.docblock.js   1.59 KB  (entry point)
-  ./example.js                          1.0 KB   (entry point)
-  ./integration-stripe.feature.js       0.90 KB  (entry point)
-  ./tenant.js                           1.34 KB  (entry point)
+  ./blueprint.js                        3.35 KB   (entry point)
+  ./index.js                            11.21 KB  (entry point)
+  ./tenant.js                           1.34 KB   (entry point)
+  ./connection.sample.js                2.94 KB   (entry point)
+  docs/index.js                         1.59 KB   (entry point)
+  docs/integration-stripe.docblock.js   1.59 KB   (entry point)
+  ./example.js                          1.0 KB    (entry point)
+  ./integration-stripe.feature.js       4.74 KB   (entry point)
+  ./workflow.js                         1.51 KB   (entry point)
+  ./integration.js                      2.36 KB   (entry point)
 
-[contractspec-bun-build] transpile target=node root=src entries=9 noBundle=false
-Bundled 9 modules in 18ms
+[contractspec-bun-build] transpile target=node root=src entries=10 noBundle=false
+Bundled 10 modules in 24ms
 
-  ./blueprint.js                        1.77 KB  (entry point)
-  ./index.js                            8.57 KB  (entry point)
-  ./workflow.js                         1.41 KB  (entry point)
-  ./connection.sample.js                0.57 KB  (entry point)
-  docs/index.js                         1.57 KB  (entry point)
-  docs/integration-stripe.docblock.js   1.57 KB  (entry point)
-  ./example.js                          1.0 KB   (entry point)
-  ./integration-stripe.feature.js       0.89 KB  (entry point)
-  ./tenant.js                           1.33 KB  (entry point)
+  ./blueprint.js                        3.34 KB   (entry point)
+  ./index.js                            11.19 KB  (entry point)
+  ./tenant.js                           1.33 KB   (entry point)
+  ./connection.sample.js                2.93 KB   (entry point)
+  docs/index.js                         1.57 KB   (entry point)
+  docs/integration-stripe.docblock.js   1.57 KB   (entry point)
+  ./example.js                          1.0 KB    (entry point)
+  ./integration-stripe.feature.js       4.74 KB   (entry point)
+  ./workflow.js                         1.51 KB   (entry point)
+  ./integration.js                      2.35 KB   (entry point)
 
-[contractspec-bun-build] transpile target=browser root=src entries=9 noBundle=false
-Bundled 9 modules in 38ms
+[contractspec-bun-build] transpile target=browser root=src entries=10 noBundle=false
+Bundled 10 modules in 21ms
 
-  ./blueprint.js                        1.77 KB  (entry point)
-  ./index.js                            8.57 KB  (entry point)
-  ./workflow.js                         1.41 KB  (entry point)
-  ./connection.sample.js                0.57 KB  (entry point)
-  docs/index.js                         1.57 KB  (entry point)
-  docs/integration-stripe.docblock.js   1.57 KB  (entry point)
-  ./example.js                          1.0 KB   (entry point)
-  ./integration-stripe.feature.js       0.89 KB  (entry point)
-  ./tenant.js                           1.33 KB  (entry point)
+  ./blueprint.js                        3.34 KB   (entry point)
+  ./index.js                            11.19 KB  (entry point)
+  ./tenant.js                           1.33 KB   (entry point)
+  ./connection.sample.js                2.93 KB   (entry point)
+  docs/index.js                         1.57 KB   (entry point)
+  docs/integration-stripe.docblock.js   1.57 KB   (entry point)
+  ./example.js                          1.0 KB    (entry point)
+  ./integration-stripe.feature.js       4.74 KB   (entry point)
+  ./workflow.js                         1.51 KB   (entry point)
+  ./integration.js                      2.35 KB   (entry point)
 
 $ contractspec-bun-build types

package/AGENTS.md

@@ -1,34 +1,57 @@
-# AI Agent Guide -- `@contractspec/example.integration-stripe`
+# AI Agent Guide — `@contractspec/example.integration-stripe`
 
 Scope: `packages/examples/integration-stripe/*`
 
-Demonstrates Stripe Payments integration with blueprint, workflow, and tenant configuration patterns.
+Integration example – Stripe Payments (blueprint + workflow + tenant config).
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.schema`, `lib.contracts-spec`, `lib.contracts-integrations`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
-## What This Demonstrates
+## Architecture
 
-- Integration blueprint definition for Stripe
-- Payment workflow with typed steps
-- Multi-tenant configuration pattern
-- Connection sample for credential wiring
+- `src/blueprint.ts` is part of the package's public or composition surface.
+- `src/connection.sample.ts` is part of the package's public or composition surface.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/integration-stripe.feature.ts` defines a feature entrypoint.
+- `src/tenant.ts` is part of the package's public or composition surface.
 
-## Public Exports
+## Public Surface
 
-- `.` -- root barrel
-- `./blueprint` -- Stripe integration blueprint
-- `./connection.sample` -- sample connection config
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry point
-- `./tenant` -- tenant configuration
-- `./workflow` -- payment workflow definition
+- Export `.` resolves through `./src/index.ts`.
+- Export `./blueprint` resolves through `./src/blueprint.ts`.
+- Export `./connection.sample` resolves through `./src/connection.sample.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/integration-stripe.docblock` resolves through `./src/docs/integration-stripe.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./integration-stripe.feature` resolves through `./src/integration-stripe.feature.ts`.
+- Export `./tenant` resolves through `./src/tenant.ts`.
+- Export `./workflow` resolves through `./src/workflow.ts`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @contractspec/example.integration-stripe
 
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/lib.contracts-integrations@3.8.2
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.schema@3.7.8
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-integrations@3.8.1
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.schema@3.7.7
+
 ## 3.7.6
 
 ### Patch Changes
@@ -415,6 +435,7 @@
 - 7f3203a: fix: make workspace test runs resilient when packages have no tests
 
   Updates package test scripts to pass cleanly when no matching test files exist:
+
   - Uses `bun test --pass-with-no-tests` in Bun-based packages that currently ship without test files.
   - Uses `jest --passWithNoTests` for the UI kit web package.
   - Adds `.vscode-test.mjs` for `vscode-contractspec` so VS Code extension test runs have an explicit config and stop failing on missing default configuration.
@@ -749,14 +770,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -1,29 +1,76 @@
-### Integration Example – Stripe Payments
+# @contractspec/example.integration-stripe
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Integration example – Stripe Payments (blueprint + workflow + tenant config).**
 
-This example shows how to wire the `IntegrationSpec`/`TenantAppConfig` layers together to enable Stripe-backed payments for ArtisanOS.
+## What This Demonstrates
 
-Files included:
+- Canonical `integration` export via `StripePaymentsIntegrationSpec`.
+- Integration-oriented `app-config` example via `defineAppConfig(...)`.
+- Canonical `workflow` export via `defineWorkflow(...)`.
+- Multi-tenant configuration pattern.
+- Connection sample for credential wiring.
+- `src/docs/` contains docblocks and documentation-facing exports.
 
-- `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`.
+## Running Locally
 
-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:
+From `packages/examples/integration-stripe`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
-- 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).
+## Usage
 
-Recommended next steps:
+Use `@contractspec/example.integration-stripe` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
-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.
+## Architecture
 
+- `src/blueprint.ts` is part of the package's public or composition surface.
+- `src/connection.sample.ts` is part of the package's public or composition surface.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/integration.ts` defines the exported integration spec.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/integration-stripe.feature.ts` defines a feature entrypoint.
+- `src/tenant.ts` is part of the package's public or composition surface.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./blueprint` resolves through `./src/blueprint.ts`.
+- Export `./connection.sample` resolves through `./src/connection.sample.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/integration-stripe.docblock` resolves through `./src/docs/integration-stripe.docblock.ts`.
+- Export `./example` resolves through `./src/example.ts`.
+- Export `./integration` resolves through `./src/integration.ts`.
+- Export `./integration-stripe.feature` resolves through `./src/integration-stripe.feature.ts`.
+- Export `./tenant` resolves through `./src/tenant.ts`.
+- Export `./workflow` resolves through `./src/workflow.ts`.
+- The package publishes 9 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.

package/dist/blueprint.d.ts

@@ -1,2 +1 @@
-import type { AppBlueprintSpec } from '@contractspec/lib.contracts-spec/app-config/spec';
-export declare const artisanStripeBlueprint: AppBlueprintSpec;
+export declare const artisanStripeBlueprint: import("@contractspec/lib.contracts-spec/app-config/spec").AppBlueprintSpec;

package/dist/blueprint.js

@@ -1,11 +1,65 @@
 // @bun
-// src/blueprint.ts
+// src/workflow.ts
 import {
   OwnersEnum,
   StabilityEnum,
   TagsEnum
 } from "@contractspec/lib.contracts-spec/ownership";
-var artisanStripeBlueprint = {
+import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+var collectPaymentWorkflow = defineWorkflow({
+  meta: {
+    key: "integration-stripe.workflow.payment",
+    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" }
+    ]
+  }
+});
+
+// src/blueprint.ts
+import { defineAppConfig } from "@contractspec/lib.contracts-spec/app-config/spec";
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts-spec/ownership";
+var artisanStripeBlueprint = defineAppConfig({
   meta: {
     key: "artisan.payments.stripe",
     version: "1.0.0",
@@ -13,9 +67,9 @@ var artisanStripeBlueprint = {
     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
+    owners: [OwnersEnum2.PlatformCore],
+    tags: [TagsEnum2.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum2.Experimental
   },
   capabilities: {
     enabled: [{ key: "payments.psp", version: "1.0.0" }]
@@ -50,13 +104,12 @@ var artisanStripeBlueprint = {
   },
   workflows: {
     collectPayment: {
-      key: "artisan.payments.collectPayment",
-      version: "1.0.0"
+      key: collectPaymentWorkflow.meta.key,
+      version: collectPaymentWorkflow.meta.version
     }
   },
-  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."
-};
+});
 export {
   artisanStripeBlueprint
 };

package/dist/browser/blueprint.js

@@ -1,10 +1,64 @@
-// src/blueprint.ts
+// src/workflow.ts
 import {
   OwnersEnum,
   StabilityEnum,
   TagsEnum
 } from "@contractspec/lib.contracts-spec/ownership";
-var artisanStripeBlueprint = {
+import { defineWorkflow } from "@contractspec/lib.contracts-spec/workflow";
+var collectPaymentWorkflow = defineWorkflow({
+  meta: {
+    key: "integration-stripe.workflow.payment",
+    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" }
+    ]
+  }
+});
+
+// src/blueprint.ts
+import { defineAppConfig } from "@contractspec/lib.contracts-spec/app-config/spec";
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts-spec/ownership";
+var artisanStripeBlueprint = defineAppConfig({
   meta: {
     key: "artisan.payments.stripe",
     version: "1.0.0",
@@ -12,9 +66,9 @@ var artisanStripeBlueprint = {
     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
+    owners: [OwnersEnum2.PlatformCore],
+    tags: [TagsEnum2.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum2.Experimental
   },
   capabilities: {
     enabled: [{ key: "payments.psp", version: "1.0.0" }]
@@ -49,13 +103,12 @@ var artisanStripeBlueprint = {
   },
   workflows: {
     collectPayment: {
-      key: "artisan.payments.collectPayment",
-      version: "1.0.0"
+      key: collectPaymentWorkflow.meta.key,
+      version: collectPaymentWorkflow.meta.version
     }
   },
-  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."
-};
+});
 export {
   artisanStripeBlueprint
 };

package/dist/browser/connection.sample.js

@@ -1,10 +1,86 @@
+// src/integration.ts
+import { defineIntegration } from "@contractspec/lib.contracts-spec/integrations/spec";
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var StripeConfigModel = defineSchemaModel({
+  name: "StripePaymentsIntegrationConfig",
+  description: "Managed configuration required to connect a Stripe account.",
+  fields: {
+    accountId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    webhookEndpoint: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    }
+  }
+});
+var StripeSecretModel = defineSchemaModel({
+  name: "StripePaymentsIntegrationSecret",
+  description: "Secret material stored out-of-band for the Stripe provider.",
+  fields: {
+    apiKey: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    webhookSecret: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    }
+  }
+});
+var StripePaymentsIntegrationSpec = defineIntegration({
+  meta: {
+    key: "integration-stripe.integration.psp",
+    version: "1.0.0",
+    title: "Stripe Payments Integration",
+    description: "Integration contract for managed or BYOK Stripe card processing.",
+    domain: "payments",
+    category: "payments",
+    owners: [OwnersEnum.PlatformCore],
+    tags: [TagsEnum.Marketplace, "stripe", "payments"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["managed", "byok"],
+  capabilities: {
+    provides: [{ key: "payments.psp", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: StripeConfigModel,
+    example: {
+      accountId: "acct_demo_artisan",
+      webhookEndpoint: "https://pay.artisanos.dev/webhooks/stripe"
+    }
+  },
+  secretSchema: {
+    schema: StripeSecretModel,
+    example: {
+      apiKey: "sk_live_redacted",
+      webhookSecret: "whsec_redacted"
+    }
+  },
+  healthCheck: {
+    method: "ping",
+    timeoutMs: 5000
+  },
+  docsUrl: "https://docs.stripe.com",
+  constraints: {
+    rateLimit: {
+      rpm: 1000
+    }
+  },
+  byokSetup: {
+    setupInstructions: "Create a restricted API key and webhook endpoint, then bind the secret reference to the tenant connection.",
+    requiredScopes: ["charges:write", "customers:read", "webhooks:write"]
+  }
+});
+
 // src/connection.sample.ts
 var stripeLiveConnection = {
   meta: {
     id: "conn-stripe-live",
     tenantId: "artisan-co",
-    integrationKey: "payments.stripe",
-    integrationVersion: "1",
+    integrationKey: StripePaymentsIntegrationSpec.meta.key,
+    integrationVersion: StripePaymentsIntegrationSpec.meta.version,
     label: "Stripe Production",
     environment: "production",
     createdAt: "2026-01-01T00:00:00.000Z",