@contractspec/example.integration-supabase 1.57.0

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

@@ -0,0 +1,42 @@
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/integration-supabase/tsdown.config.js 
+ℹ entry: src/blueprint.ts, src/connection.sample.ts, src/example.ts, src/index.ts, src/runtime.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/integration-supabase.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 28 files
+ℹ dist/docs/integration-supabase.docblock.js      2.34 kB │ gzip: 1.09 kB
+ℹ dist/blueprint.js                               1.84 kB │ gzip: 0.72 kB
+ℹ dist/connection.sample.js                       1.43 kB │ gzip: 0.50 kB
+ℹ dist/tenant.js                                  1.11 kB │ gzip: 0.53 kB
+ℹ dist/runtime.sample.js                          1.07 kB │ gzip: 0.54 kB
+ℹ dist/example.js                                 1.04 kB │ gzip: 0.54 kB
+ℹ dist/index.js                                   0.56 kB │ gzip: 0.20 kB
+ℹ dist/docs/index.js                              0.04 kB │ gzip: 0.07 kB
+ℹ dist/docs/integration-supabase.docblock.js.map  2.92 kB │ gzip: 1.30 kB
+ℹ dist/blueprint.js.map                           2.90 kB │ gzip: 1.05 kB
+ℹ dist/runtime.sample.js.map                      2.22 kB │ gzip: 0.94 kB
+ℹ dist/connection.sample.js.map                   2.19 kB │ gzip: 0.72 kB
+ℹ dist/tenant.js.map                              1.80 kB │ gzip: 0.81 kB
+ℹ dist/example.js.map                             1.51 kB │ gzip: 0.73 kB
+ℹ dist/runtime.sample.d.ts.map                    0.28 kB │ gzip: 0.19 kB
+ℹ dist/connection.sample.d.ts.map                 0.20 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                           0.13 kB │ gzip: 0.13 kB
+ℹ dist/blueprint.d.ts.map                         0.12 kB │ gzip: 0.12 kB
+ℹ dist/tenant.d.ts.map                            0.11 kB │ gzip: 0.12 kB
+ℹ dist/runtime.sample.d.ts                        0.73 kB │ gzip: 0.32 kB
+ℹ dist/index.d.ts                                 0.66 kB │ gzip: 0.21 kB
+ℹ dist/connection.sample.d.ts                     0.48 kB │ gzip: 0.21 kB
+ℹ dist/blueprint.d.ts                             0.26 kB │ gzip: 0.18 kB
+ℹ dist/tenant.d.ts                                0.26 kB │ gzip: 0.18 kB
+ℹ dist/example.d.ts                               0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/index.d.ts                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/integration-supabase.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 27 files, total: 26.47 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (65%)
+  - tsdown:external (32%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 16194ms

package/.turbo/turbo-build.log

@@ -0,0 +1,40 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/integration-supabase/tsdown.config.js 
+ℹ entry: src/blueprint.ts, src/connection.sample.ts, src/example.ts, src/index.ts, src/runtime.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/integration-supabase.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/docs/integration-supabase.docblock.js      2.34 kB │ gzip: 1.09 kB
+ℹ dist/blueprint.js                               1.84 kB │ gzip: 0.72 kB
+ℹ dist/connection.sample.js                       1.43 kB │ gzip: 0.50 kB
+ℹ dist/tenant.js                                  1.11 kB │ gzip: 0.53 kB
+ℹ dist/runtime.sample.js                          1.07 kB │ gzip: 0.54 kB
+ℹ dist/example.js                                 1.04 kB │ gzip: 0.54 kB
+ℹ dist/index.js                                   0.56 kB │ gzip: 0.20 kB
+ℹ dist/docs/index.js                              0.04 kB │ gzip: 0.07 kB
+ℹ dist/docs/integration-supabase.docblock.js.map  2.92 kB │ gzip: 1.30 kB
+ℹ dist/blueprint.js.map                           2.90 kB │ gzip: 1.05 kB
+ℹ dist/runtime.sample.js.map                      2.22 kB │ gzip: 0.94 kB
+ℹ dist/connection.sample.js.map                   2.19 kB │ gzip: 0.72 kB
+ℹ dist/tenant.js.map                              1.80 kB │ gzip: 0.81 kB
+ℹ dist/example.js.map                             1.51 kB │ gzip: 0.73 kB
+ℹ dist/runtime.sample.d.ts.map                    0.28 kB │ gzip: 0.19 kB
+ℹ dist/connection.sample.d.ts.map                 0.20 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                           0.13 kB │ gzip: 0.13 kB
+ℹ dist/blueprint.d.ts.map                         0.12 kB │ gzip: 0.12 kB
+ℹ dist/tenant.d.ts.map                            0.11 kB │ gzip: 0.12 kB
+ℹ dist/runtime.sample.d.ts                        0.73 kB │ gzip: 0.32 kB
+ℹ dist/index.d.ts                                 0.66 kB │ gzip: 0.21 kB
+ℹ dist/connection.sample.d.ts                     0.48 kB │ gzip: 0.21 kB
+ℹ dist/blueprint.d.ts                             0.26 kB │ gzip: 0.18 kB
+ℹ dist/tenant.d.ts                                0.26 kB │ gzip: 0.18 kB
+ℹ dist/example.d.ts                               0.25 kB │ gzip: 0.17 kB
+ℹ dist/docs/index.d.ts                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/integration-supabase.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 27 files, total: 26.47 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 21963ms

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# @contractspec/example.integration-supabase
+
+## 1.57.0
+
+### Minor Changes
+
+- 4651e06: Add Supabase and voice provider integrations with new runnable examples, and expose these providers across contracts, workspace tooling, and provider factory wiring.
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/integration.providers-impls@1.57.0
+  - @contractspec/integration.runtime@1.57.0
+
+## 1.56.1
+
+### Minor Changes
+
+- Add Supabase integration example package with blueprint, tenant bindings, connection samples, and runtime usage.

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,38 @@
+### Integration Example - Supabase Vector + Postgres
+
+Website: https://contractspec.io/
+
+This example shows how to wire two Supabase integrations together:
+
+- `vectordb.supabase` for embedding storage and similarity search.
+- `database.supabase` for SQL reads/writes and transactional workloads.
+
+Included files:
+
+- `blueprint.ts` - App blueprint with two integration slots (`primary-vector-db`, `primary-database`).
+- `tenant.ts` - Tenant config binding both slots to concrete connections.
+- `connection.sample.ts` - Sample `IntegrationConnection` records for both Supabase providers.
+- `runtime.sample.ts` - Runtime sample using `IntegrationProviderFactory` to create and execute both providers.
+
+## Quick start
+
+1. Register integration specs (includes `vectordb.supabase` and `database.supabase`) from `createDefaultIntegrationSpecRegistry()`.
+2. Persist the sample connections from `connection.sample.ts` via the integrations CRUD flow.
+3. Publish the tenant config from `tenant.ts` and ensure slot bindings match your connection IDs.
+4. Use the runtime sample to upsert/search vectors and run SQL queries with the same Supabase project.
+
+## Secret payload format
+
+Both connections expect a `databaseUrl` secret value.
+
+```json
+{
+  "databaseUrl": "postgresql://postgres.<project-ref>:<password>@aws-0-<region>.pooler.supabase.com:6543/postgres"
+}
+```
+
+## Notes
+
+- Vector provider auto-creates pgvector extension/table/indexes when `createTableIfMissing=true`.
+- Keep non-secret settings in `config`; store credentials only in `secretRef`.
+- The runtime sample is intentionally framework-neutral so it can be reused in API apps, jobs, or workers.

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 supabaseKnowledgeBlueprint: AppBlueprintSpec;
+//#endregion
+export { supabaseKnowledgeBlueprint };
+//# 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"],"mappings":";;;cAOa,0BAAA,EAA4B,gBAAA"}

package/dist/blueprint.js

@@ -0,0 +1,75 @@
+import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts/ownership";
+
+//#region src/blueprint.ts
+const supabaseKnowledgeBlueprint = {
+	meta: {
+		key: "knowledge.supabase.dual-store",
+		version: "1.0.0",
+		appId: "knowledge-assistant",
+		title: "Knowledge Assistant - Supabase Dual Store",
+		description: "Blueprint that uses Supabase for both vector retrieval and SQL-backed analytics.",
+		domain: "knowledge",
+		owners: [OwnersEnum.PlatformCore],
+		tags: [
+			TagsEnum.Automation,
+			"knowledge",
+			"supabase",
+			"vector-db",
+			"database"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	capabilities: { enabled: [
+		{
+			key: "vector-db.search",
+			version: "1.0.0"
+		},
+		{
+			key: "vector-db.storage",
+			version: "1.0.0"
+		},
+		{
+			key: "database.sql",
+			version: "1.0.0"
+		}
+	] },
+	integrationSlots: [{
+		slotId: "primary-vector-db",
+		requiredCategory: "vector-db",
+		allowedModes: ["managed", "byok"],
+		requiredCapabilities: [{
+			key: "vector-db.search",
+			version: "1.0.0"
+		}, {
+			key: "vector-db.storage",
+			version: "1.0.0"
+		}],
+		required: true,
+		description: "Primary semantic retrieval store for knowledge chunks."
+	}, {
+		slotId: "primary-database",
+		requiredCategory: "database",
+		allowedModes: ["managed", "byok"],
+		requiredCapabilities: [{
+			key: "database.sql",
+			version: "1.0.0"
+		}],
+		required: true,
+		description: "Primary SQL database for analytics and transactional reads."
+	}],
+	workflows: {
+		ingestKnowledge: {
+			key: "knowledge.ingest.supabase",
+			version: "1.0.0"
+		},
+		refreshMetrics: {
+			key: "knowledge.metrics.supabase",
+			version: "1.0.0"
+		}
+	},
+	notes: "Bind both slots to Supabase connections when you want shared infra for embeddings and SQL operations."
+};
+
+//#endregion
+export { supabaseKnowledgeBlueprint };
+//# sourceMappingURL=blueprint.js.map

package/dist/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","names":[],"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 supabaseKnowledgeBlueprint: AppBlueprintSpec = {\n  meta: {\n    key: 'knowledge.supabase.dual-store',\n    version: '1.0.0',\n    appId: 'knowledge-assistant',\n    title: 'Knowledge Assistant - Supabase Dual Store',\n    description:\n      'Blueprint that uses Supabase for both vector retrieval and SQL-backed analytics.',\n    domain: 'knowledge',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [\n      TagsEnum.Automation,\n      'knowledge',\n      'supabase',\n      'vector-db',\n      'database',\n    ],\n    stability: StabilityEnum.Experimental,\n  },\n  capabilities: {\n    enabled: [\n      { key: 'vector-db.search', version: '1.0.0' },\n      { key: 'vector-db.storage', version: '1.0.0' },\n      { key: 'database.sql', version: '1.0.0' },\n    ],\n  },\n  integrationSlots: [\n    {\n      slotId: 'primary-vector-db',\n      requiredCategory: 'vector-db',\n      allowedModes: ['managed', 'byok'],\n      requiredCapabilities: [\n        { key: 'vector-db.search', version: '1.0.0' },\n        { key: 'vector-db.storage', version: '1.0.0' },\n      ],\n      required: true,\n      description: 'Primary semantic retrieval store for knowledge chunks.',\n    },\n    {\n      slotId: 'primary-database',\n      requiredCategory: 'database',\n      allowedModes: ['managed', 'byok'],\n      requiredCapabilities: [{ key: 'database.sql', version: '1.0.0' }],\n      required: true,\n      description:\n        'Primary SQL database for analytics and transactional reads.',\n    },\n  ],\n  workflows: {\n    ingestKnowledge: {\n      key: 'knowledge.ingest.supabase',\n      version: '1.0.0',\n    },\n    refreshMetrics: {\n      key: 'knowledge.metrics.supabase',\n      version: '1.0.0',\n    },\n  },\n  notes:\n    'Bind both slots to Supabase connections when you want shared infra for embeddings and SQL operations.',\n};\n"],"mappings":";;;AAOA,MAAa,6BAA+C;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM;GACJ,SAAS;GACT;GACA;GACA;GACA;GACD;EACD,WAAW,cAAc;EAC1B;CACD,cAAc,EACZ,SAAS;EACP;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC7C;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC9C;GAAE,KAAK;GAAgB,SAAS;GAAS;EAC1C,EACF;CACD,kBAAkB,CAChB;EACE,QAAQ;EACR,kBAAkB;EAClB,cAAc,CAAC,WAAW,OAAO;EACjC,sBAAsB,CACpB;GAAE,KAAK;GAAoB,SAAS;GAAS,EAC7C;GAAE,KAAK;GAAqB,SAAS;GAAS,CAC/C;EACD,UAAU;EACV,aAAa;EACd,EACD;EACE,QAAQ;EACR,kBAAkB;EAClB,cAAc,CAAC,WAAW,OAAO;EACjC,sBAAsB,CAAC;GAAE,KAAK;GAAgB,SAAS;GAAS,CAAC;EACjE,UAAU;EACV,aACE;EACH,CACF;CACD,WAAW;EACT,iBAAiB;GACf,KAAK;GACL,SAAS;GACV;EACD,gBAAgB;GACd,KAAK;GACL,SAAS;GACV;EACF;CACD,OACE;CACH"}

package/dist/connection.sample.d.ts

@@ -0,0 +1,9 @@
+import { IntegrationConnection } from "@contractspec/lib.contracts/integrations/connection";
+
+//#region src/connection.sample.d.ts
+declare const supabaseVectorConnection: IntegrationConnection;
+declare const supabaseDatabaseConnection: IntegrationConnection;
+declare const supabaseConnectionSamples: IntegrationConnection[];
+//#endregion
+export { supabaseConnectionSamples, supabaseDatabaseConnection, supabaseVectorConnection };
+//# 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"],"mappings":";;;cAEa,wBAAA,EAA0B,qBAAA;AAAA,cAyB1B,0BAAA,EAA4B,qBAAA;AAAA,cAqB5B,yBAAA,EAA2B,qBAAA"}

package/dist/connection.sample.js

@@ -0,0 +1,50 @@
+//#region src/connection.sample.ts
+const supabaseVectorConnection = {
+	meta: {
+		id: "conn-supabase-vector",
+		tenantId: "acme-knowledge",
+		integrationKey: "vectordb.supabase",
+		integrationVersion: "1.0.0",
+		label: "Supabase Vector Store",
+		environment: "production",
+		createdAt: "2026-02-06T00:00:00.000Z",
+		updatedAt: "2026-02-06T00:00:00.000Z"
+	},
+	ownershipMode: "managed",
+	config: {
+		schema: "public",
+		table: "contractspec_vectors",
+		createTableIfMissing: true,
+		distanceMetric: "cosine",
+		maxConnections: 5,
+		sslMode: "require"
+	},
+	secretProvider: "vault",
+	secretRef: "vault://integrations/acme-knowledge/conn-supabase-vector",
+	status: "connected"
+};
+const supabaseDatabaseConnection = {
+	meta: {
+		id: "conn-supabase-db",
+		tenantId: "acme-knowledge",
+		integrationKey: "database.supabase",
+		integrationVersion: "1.0.0",
+		label: "Supabase Postgres",
+		environment: "production",
+		createdAt: "2026-02-06T00:00:00.000Z",
+		updatedAt: "2026-02-06T00:00:00.000Z"
+	},
+	ownershipMode: "managed",
+	config: {
+		maxConnections: 10,
+		sslMode: "require"
+	},
+	secretProvider: "vault",
+	secretRef: "vault://integrations/acme-knowledge/conn-supabase-db",
+	status: "connected"
+};
+const supabaseConnectionSamples = [supabaseVectorConnection, supabaseDatabaseConnection];
+
+//#endregion
+export { supabaseConnectionSamples, supabaseDatabaseConnection, supabaseVectorConnection };
+//# sourceMappingURL=connection.sample.js.map

package/dist/connection.sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.sample.js","names":[],"sources":["../src/connection.sample.ts"],"sourcesContent":["import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';\n\nexport const supabaseVectorConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-supabase-vector',\n    tenantId: 'acme-knowledge',\n    integrationKey: 'vectordb.supabase',\n    integrationVersion: '1.0.0',\n    label: 'Supabase Vector Store',\n    environment: 'production',\n    createdAt: '2026-02-06T00:00:00.000Z',\n    updatedAt: '2026-02-06T00:00:00.000Z',\n  },\n  ownershipMode: 'managed',\n  config: {\n    schema: 'public',\n    table: 'contractspec_vectors',\n    createTableIfMissing: true,\n    distanceMetric: 'cosine',\n    maxConnections: 5,\n    sslMode: 'require',\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/acme-knowledge/conn-supabase-vector',\n  status: 'connected',\n};\n\nexport const supabaseDatabaseConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-supabase-db',\n    tenantId: 'acme-knowledge',\n    integrationKey: 'database.supabase',\n    integrationVersion: '1.0.0',\n    label: 'Supabase Postgres',\n    environment: 'production',\n    createdAt: '2026-02-06T00:00:00.000Z',\n    updatedAt: '2026-02-06T00:00:00.000Z',\n  },\n  ownershipMode: 'managed',\n  config: {\n    maxConnections: 10,\n    sslMode: 'require',\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/acme-knowledge/conn-supabase-db',\n  status: 'connected',\n};\n\nexport const supabaseConnectionSamples: IntegrationConnection[] = [\n  supabaseVectorConnection,\n  supabaseDatabaseConnection,\n];\n"],"mappings":";AAEA,MAAa,2BAAkD;CAC7D,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ;EACN,QAAQ;EACR,OAAO;EACP,sBAAsB;EACtB,gBAAgB;EAChB,gBAAgB;EAChB,SAAS;EACV;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT;AAED,MAAa,6BAAoD;CAC/D,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ;EACN,gBAAgB;EAChB,SAAS;EACV;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT;AAED,MAAa,4BAAqD,CAChE,0BACA,2BACD"}

package/dist/docs/index.d.ts

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

package/dist/docs/index.js

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

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

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

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

@@ -0,0 +1,60 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/integration-supabase.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.integration-supabase",
+	title: "Integration Example - Supabase Vector + Postgres",
+	summary: "Reference example wiring Supabase vector and SQL integrations in one tenant configuration.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/integration-supabase",
+	tags: [
+		"supabase",
+		"vector-db",
+		"database",
+		"integration",
+		"example"
+	],
+	body: `## What this example includes
+- A blueprint declaring two required integration slots:
+  - \`primary-vector-db\` bound to \`vectordb.supabase\`
+  - \`primary-database\` bound to \`database.supabase\`
+- A tenant config binding both slots.
+- Connection samples with clear \`config\` vs \`secretRef\` separation.
+- A runtime sample that upserts/searches vectors and executes SQL queries.
+
+## Why this pattern
+- Keeps integration concerns explicit and auditable in app-config.
+- Enables shared Supabase infrastructure for retrieval + analytics.
+- Preserves secret management boundaries (no credentials in config/spec).`
+}, {
+	id: "docs.examples.integration-supabase.usage",
+	title: "Supabase Integration Example - Usage",
+	summary: "Step-by-step usage of the Supabase dual-store integration example.",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/examples/integration-supabase/usage",
+	tags: ["supabase", "usage"],
+	body: `## Usage
+1) Register integration specs from \`createDefaultIntegrationSpecRegistry()\`.
+2) Persist both sample connections from \`connection.sample.ts\`.
+3) Publish the tenant config from \`tenant.ts\` with matching \`connectionId\` values.
+4) Use \`runSupabaseKnowledgeRuntime(...)\` to execute vector and SQL calls through \`IntegrationProviderFactory\`.
+
+## Secret payload
+Store the following payload in your secret provider target for each connection:
+
+\`\`\`json
+{
+  "databaseUrl": "postgresql://postgres.<project-ref>:<password>@aws-0-<region>.pooler.supabase.com:6543/postgres"
+}
+\`\`\`
+
+## Guardrails
+- Never place credentials in \`config\` or source control.
+- Keep operational SQL behind explicit workflows/operations.
+- Restrict DB credentials to least-privilege roles whenever possible.`
+}]);
+
+//#endregion
+//# sourceMappingURL=integration-supabase.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-supabase.docblock.js","names":[],"sources":["../../src/docs/integration-supabase.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-supabase',\n    title: 'Integration Example - Supabase Vector + Postgres',\n    summary:\n      'Reference example wiring Supabase vector and SQL integrations in one tenant configuration.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/integration-supabase',\n    tags: ['supabase', 'vector-db', 'database', 'integration', 'example'],\n    body: `## What this example includes\n- A blueprint declaring two required integration slots:\n  - \\`primary-vector-db\\` bound to \\`vectordb.supabase\\`\n  - \\`primary-database\\` bound to \\`database.supabase\\`\n- A tenant config binding both slots.\n- Connection samples with clear \\`config\\` vs \\`secretRef\\` separation.\n- A runtime sample that upserts/searches vectors and executes SQL queries.\n\n## Why this pattern\n- Keeps integration concerns explicit and auditable in app-config.\n- Enables shared Supabase infrastructure for retrieval + analytics.\n- Preserves secret management boundaries (no credentials in config/spec).`,\n  },\n  {\n    id: 'docs.examples.integration-supabase.usage',\n    title: 'Supabase Integration Example - Usage',\n    summary:\n      'Step-by-step usage of the Supabase dual-store integration example.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/integration-supabase/usage',\n    tags: ['supabase', 'usage'],\n    body: `## Usage\n1) Register integration specs from \\`createDefaultIntegrationSpecRegistry()\\`.\n2) Persist both sample connections from \\`connection.sample.ts\\`.\n3) Publish the tenant config from \\`tenant.ts\\` with matching \\`connectionId\\` values.\n4) Use \\`runSupabaseKnowledgeRuntime(...)\\` to execute vector and SQL calls through \\`IntegrationProviderFactory\\`.\n\n## Secret payload\nStore the following payload in your secret provider target for each connection:\n\n\\`\\`\\`json\n{\n  \"databaseUrl\": \"postgresql://postgres.<project-ref>:<password>@aws-0-<region>.pooler.supabase.com:6543/postgres\"\n}\n\\`\\`\\`\n\n## Guardrails\n- Never place credentials in \\`config\\` or source control.\n- Keep operational SQL behind explicit workflows/operations.\n- Restrict DB credentials to least-privilege roles whenever possible.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AAyDA,kBAtD2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAa;EAAY;EAAe;EAAU;CACrE,MAAM;;;;;;;;;;;;CAYP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,YAAY,QAAQ;CAC3B,MAAM;;;;;;;;;;;;;;;;;;;CAmBP,CACF,CAEwB"}

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+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 };
+//# 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"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}

package/dist/example.js

@@ -0,0 +1,46 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "integration-supabase",
+		version: "1.0.0",
+		title: "Integration - Supabase Vector + Postgres",
+		description: "Wire AppBlueprint and TenantAppConfig to use Supabase for both vector retrieval and SQL workloads.",
+		kind: "integration",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.core"],
+		tags: [
+			"supabase",
+			"pgvector",
+			"postgres",
+			"integration",
+			"knowledge"
+		]
+	},
+	docs: {
+		rootDocId: "docs.examples.integration-supabase",
+		usageDocId: "docs.examples.integration-supabase.usage"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.integration-supabase",
+		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

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'integration-supabase',\n    version: '1.0.0',\n    title: 'Integration - Supabase Vector + Postgres',\n    description:\n      'Wire AppBlueprint and TenantAppConfig to use Supabase for both vector retrieval and SQL workloads.',\n    kind: 'integration',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['supabase', 'pgvector', 'postgres', 'integration', 'knowledge'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.integration-supabase',\n    usageDocId: 'docs.examples.integration-supabase.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.integration-supabase',\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});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAY;GAAY;GAAY;GAAe;GAAY;EACvE;CACD,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,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { supabaseKnowledgeBlueprint } from "./blueprint.js";
+import { supabaseConnectionSamples, supabaseDatabaseConnection, supabaseVectorConnection } from "./connection.sample.js";
+import example from "./example.js";
+import { supabaseKnowledgeTenantConfig } from "./tenant.js";
+import { SupabaseKnowledgeRuntimeParams, SupabaseKnowledgeRuntimeResult, runSupabaseKnowledgeRuntime } from "./runtime.sample.js";
+export { SupabaseKnowledgeRuntimeParams, SupabaseKnowledgeRuntimeResult, example, runSupabaseKnowledgeRuntime, supabaseConnectionSamples, supabaseDatabaseConnection, supabaseKnowledgeBlueprint, supabaseKnowledgeTenantConfig, supabaseVectorConnection };

package/dist/index.js

@@ -0,0 +1,8 @@
+import { supabaseKnowledgeBlueprint } from "./blueprint.js";
+import { supabaseConnectionSamples, supabaseDatabaseConnection, supabaseVectorConnection } from "./connection.sample.js";
+import example from "./example.js";
+import { supabaseKnowledgeTenantConfig } from "./tenant.js";
+import { runSupabaseKnowledgeRuntime } from "./runtime.sample.js";
+import "./docs/index.js";
+
+export { example, runSupabaseKnowledgeRuntime, supabaseConnectionSamples, supabaseDatabaseConnection, supabaseKnowledgeBlueprint, supabaseKnowledgeTenantConfig, supabaseVectorConnection };

package/dist/runtime.sample.d.ts

@@ -0,0 +1,16 @@
+import { VectorSearchResult } from "@contractspec/integration.providers-impls/vector-store";
+import { IntegrationContext } from "@contractspec/integration.runtime/runtime";
+
+//#region src/runtime.sample.d.ts
+interface SupabaseKnowledgeRuntimeParams {
+  vectorContext: IntegrationContext;
+  databaseContext: IntegrationContext;
+}
+interface SupabaseKnowledgeRuntimeResult {
+  matches: VectorSearchResult[];
+  indexedDocumentCount: number;
+}
+declare function runSupabaseKnowledgeRuntime(params: SupabaseKnowledgeRuntimeParams): Promise<SupabaseKnowledgeRuntimeResult>;
+//#endregion
+export { SupabaseKnowledgeRuntimeParams, SupabaseKnowledgeRuntimeResult, runSupabaseKnowledgeRuntime };
+//# sourceMappingURL=runtime.sample.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.sample.d.ts","names":[],"sources":["../src/runtime.sample.ts"],"mappings":";;;;UAIiB,8BAAA;EACf,aAAA,EAAe,kBAAA;EACf,eAAA,EAAiB,kBAAA;AAAA;AAAA,UAGF,8BAAA;EACf,OAAA,EAAS,kBAAA;EACT,oBAAA;AAAA;AAAA,iBAGoB,2BAAA,CACpB,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,8BAAA"}

package/dist/runtime.sample.js

@@ -0,0 +1,43 @@
+import { IntegrationProviderFactory } from "@contractspec/integration.providers-impls/impls/provider-factory";
+
+//#region src/runtime.sample.ts
+async function runSupabaseKnowledgeRuntime(params) {
+	const factory = new IntegrationProviderFactory();
+	const vectorStore = await factory.createVectorStoreProvider(params.vectorContext);
+	const database = await factory.createDatabaseProvider(params.databaseContext);
+	await vectorStore.upsert({
+		collection: "knowledge_chunks",
+		documents: [{
+			id: "chunk-1",
+			vector: [
+				.11,
+				.23,
+				.45
+			],
+			payload: {
+				source: "faq",
+				locale: "en"
+			}
+		}]
+	});
+	const matches = await vectorStore.search({
+		collection: "knowledge_chunks",
+		vector: [
+			.12,
+			.22,
+			.44
+		],
+		topK: 5,
+		filter: { source: "faq" }
+	});
+	const count = await database.query("SELECT COUNT(*)::int AS total FROM knowledge_chunks;");
+	await database.close();
+	return {
+		matches,
+		indexedDocumentCount: count.rows[0]?.total ?? 0
+	};
+}
+
+//#endregion
+export { runSupabaseKnowledgeRuntime };
+//# sourceMappingURL=runtime.sample.js.map

package/dist/runtime.sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.sample.js","names":[],"sources":["../src/runtime.sample.ts"],"sourcesContent":["import type { VectorSearchResult } from '@contractspec/integration.providers-impls/vector-store';\nimport { IntegrationProviderFactory } from '@contractspec/integration.providers-impls/impls/provider-factory';\nimport type { IntegrationContext } from '@contractspec/integration.runtime/runtime';\n\nexport interface SupabaseKnowledgeRuntimeParams {\n  vectorContext: IntegrationContext;\n  databaseContext: IntegrationContext;\n}\n\nexport interface SupabaseKnowledgeRuntimeResult {\n  matches: VectorSearchResult[];\n  indexedDocumentCount: number;\n}\n\nexport async function runSupabaseKnowledgeRuntime(\n  params: SupabaseKnowledgeRuntimeParams\n): Promise<SupabaseKnowledgeRuntimeResult> {\n  const factory = new IntegrationProviderFactory();\n\n  const vectorStore = await factory.createVectorStoreProvider(\n    params.vectorContext\n  );\n  const database = await factory.createDatabaseProvider(params.databaseContext);\n\n  await vectorStore.upsert({\n    collection: 'knowledge_chunks',\n    documents: [\n      {\n        id: 'chunk-1',\n        vector: [0.11, 0.23, 0.45],\n        payload: { source: 'faq', locale: 'en' },\n      },\n    ],\n  });\n\n  const matches = await vectorStore.search({\n    collection: 'knowledge_chunks',\n    vector: [0.12, 0.22, 0.44],\n    topK: 5,\n    filter: { source: 'faq' },\n  });\n\n  const count = await database.query<{ total: number }>(\n    'SELECT COUNT(*)::int AS total FROM knowledge_chunks;'\n  );\n\n  await database.close();\n\n  return {\n    matches,\n    indexedDocumentCount: count.rows[0]?.total ?? 0,\n  };\n}\n"],"mappings":";;;AAcA,eAAsB,4BACpB,QACyC;CACzC,MAAM,UAAU,IAAI,4BAA4B;CAEhD,MAAM,cAAc,MAAM,QAAQ,0BAChC,OAAO,cACR;CACD,MAAM,WAAW,MAAM,QAAQ,uBAAuB,OAAO,gBAAgB;AAE7E,OAAM,YAAY,OAAO;EACvB,YAAY;EACZ,WAAW,CACT;GACE,IAAI;GACJ,QAAQ;IAAC;IAAM;IAAM;IAAK;GAC1B,SAAS;IAAE,QAAQ;IAAO,QAAQ;IAAM;GACzC,CACF;EACF,CAAC;CAEF,MAAM,UAAU,MAAM,YAAY,OAAO;EACvC,YAAY;EACZ,QAAQ;GAAC;GAAM;GAAM;GAAK;EAC1B,MAAM;EACN,QAAQ,EAAE,QAAQ,OAAO;EAC1B,CAAC;CAEF,MAAM,QAAQ,MAAM,SAAS,MAC3B,uDACD;AAED,OAAM,SAAS,OAAO;AAEtB,QAAO;EACL;EACA,sBAAsB,MAAM,KAAK,IAAI,SAAS;EAC/C"}

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 supabaseKnowledgeTenantConfig: TenantAppConfig;
+//#endregion
+export { supabaseKnowledgeTenantConfig };
+//# 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"],"mappings":";;;cAEa,6BAAA,EAA+B,eAAA"}

package/dist/tenant.js

@@ -0,0 +1,40 @@
+//#region src/tenant.ts
+const supabaseKnowledgeTenantConfig = {
+	meta: {
+		id: "tenant-config-knowledge-supabase",
+		tenantId: "acme-knowledge",
+		appId: "knowledge-assistant",
+		blueprintName: "knowledge.supabase.dual-store",
+		blueprintVersion: "1.0.0",
+		environment: "production",
+		version: "1.0.0",
+		status: "published",
+		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	},
+	integrations: [{
+		slotId: "primary-vector-db",
+		connectionId: "conn-supabase-vector",
+		scope: {
+			workflows: ["ingestKnowledge"],
+			operations: ["knowledge.indexChunks", "knowledge.semanticSearch"]
+		}
+	}, {
+		slotId: "primary-database",
+		connectionId: "conn-supabase-db",
+		scope: {
+			workflows: ["refreshMetrics"],
+			operations: ["knowledge.metrics.refresh", "knowledge.metrics.query"]
+		}
+	}],
+	knowledge: [],
+	locales: {
+		defaultLocale: "en",
+		enabledLocales: ["en"]
+	},
+	notes: "Supabase vector + SQL connections bound for production knowledge flows."
+};
+
+//#endregion
+export { supabaseKnowledgeTenantConfig };
+//# sourceMappingURL=tenant.js.map

package/dist/tenant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.js","names":[],"sources":["../src/tenant.ts"],"sourcesContent":["import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';\n\nexport const supabaseKnowledgeTenantConfig: TenantAppConfig = {\n  meta: {\n    id: 'tenant-config-knowledge-supabase',\n    tenantId: 'acme-knowledge',\n    appId: 'knowledge-assistant',\n    blueprintName: 'knowledge.supabase.dual-store',\n    blueprintVersion: '1.0.0',\n    environment: 'production',\n    version: '1.0.0',\n    status: 'published',\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n  },\n  integrations: [\n    {\n      slotId: 'primary-vector-db',\n      connectionId: 'conn-supabase-vector',\n      scope: {\n        workflows: ['ingestKnowledge'],\n        operations: ['knowledge.indexChunks', 'knowledge.semanticSearch'],\n      },\n    },\n    {\n      slotId: 'primary-database',\n      connectionId: 'conn-supabase-db',\n      scope: {\n        workflows: ['refreshMetrics'],\n        operations: ['knowledge.metrics.refresh', 'knowledge.metrics.query'],\n      },\n    },\n  ],\n  knowledge: [],\n  locales: {\n    defaultLocale: 'en',\n    enabledLocales: ['en'],\n  },\n  notes:\n    'Supabase vector + SQL connections bound for production knowledge flows.',\n};\n"],"mappings":";AAEA,MAAa,gCAAiD;CAC5D,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,kBAAkB;GAC9B,YAAY,CAAC,yBAAyB,2BAA2B;GAClE;EACF,EACD;EACE,QAAQ;EACR,cAAc;EACd,OAAO;GACL,WAAW,CAAC,iBAAiB;GAC7B,YAAY,CAAC,6BAA6B,0BAA0B;GACrE;EACF,CACF;CACD,WAAW,EAAE;CACb,SAAS;EACP,eAAe;EACf,gBAAgB,CAAC,KAAK;EACvB;CACD,OACE;CACH"}