@contractspec/example.integration-stripe 3.7.7 → 3.7.12

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 13ms
+[contractspec-bun-build] transpile target=bun root=src entries=10 noBundle=false
+Bundled 10 modules in 15ms
 
-  ./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.20 KB  (entry point)
+  ./tenant.js                           1.34 KB   (entry point)
+  ./connection.sample.js                2.93 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.73 KB   (entry point)
+  ./workflow.js                         1.51 KB   (entry point)
+  ./integration.js                      2.35 KB   (entry point)
 
-[contractspec-bun-build] transpile target=node root=src entries=9 noBundle=false
-Bundled 9 modules in 24ms
+[contractspec-bun-build] transpile target=node root=src entries=10 noBundle=false
+Bundled 10 modules in 28ms
 
-  ./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.18 KB  (entry point)
+  ./tenant.js                           1.33 KB   (entry point)
+  ./connection.sample.js                2.92 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.73 KB   (entry point)
+  ./workflow.js                         1.51 KB   (entry point)
+  ./integration.js                      2.34 KB   (entry point)
 
-[contractspec-bun-build] transpile target=browser root=src entries=9 noBundle=false
-Bundled 9 modules in 24ms
+[contractspec-bun-build] transpile target=browser root=src entries=10 noBundle=false
+Bundled 10 modules in 27ms
 
-  ./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.18 KB  (entry point)
+  ./tenant.js                           1.33 KB   (entry point)
+  ./connection.sample.js                2.92 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.73 KB   (entry point)
+  ./workflow.js                         1.51 KB   (entry point)
+  ./integration.js                      2.34 KB   (entry point)
 
 $ contractspec-bun-build types

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @contractspec/example.integration-stripe
 
+## 3.7.12
+
+### Patch Changes
+
+- Updated dependencies [81256ea]
+- Updated dependencies [2619dd8]
+- Updated dependencies [6de2f1c]
+- Updated dependencies [81256ea]
+- Updated dependencies [a4489bb]
+- Updated dependencies [9cb304e]
+  - @contractspec/lib.contracts-spec@5.0.0
+  - @contractspec/lib.contracts-integrations@3.8.4
+  - @contractspec/lib.schema@3.7.10
+
+## 3.7.11
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-integrations@3.8.3
+  - @contractspec/lib.contracts-spec@4.1.3
+  - @contractspec/lib.schema@3.7.9
+
+## 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 +459,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 +794,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

@@ -6,12 +6,12 @@ Website: https://contractspec.io
 
 ## What This Demonstrates
 
-- Integration blueprint definition for Stripe.
-- Payment workflow with typed steps.
+- 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.
-- `src/docs/` contains docblocks and documentation-facing exports.
 
 ## Running Locally
 
@@ -31,6 +31,7 @@ Use `@contractspec/example.integration-stripe` as a reference implementation, or
 - `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.
@@ -43,9 +44,11 @@ Use `@contractspec/example.integration-stripe` as a reference implementation, or
 - 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
 

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").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-integrations";
+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",