@contractspec/example.integration-supabase 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,40 +1,41 @@
-$ 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.
+$ 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=8
+Bundled 8 modules in 36ms
 
-✔ Build complete in 21963ms
+  ./blueprint.js                         1.92 KB  (entry point)
+  ./index.js                             8.81 KB  (entry point)
+  ./connection.sample.js                 1.45 KB  (entry point)
+  docs/index.js                          2.33 KB  (entry point)
+  docs/integration-supabase.docblock.js  2.33 KB  (entry point)
+  ./example.js                           1.0 KB   (entry point)
+  ./runtime.sample.js                    1.0 KB   (entry point)
+  ./tenant.js                            1.12 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=8
+Bundled 8 modules in 35ms
+
+  ./blueprint.js                         1.91 KB  (entry point)
+  ./index.js                             8.80 KB  (entry point)
+  ./connection.sample.js                 1.44 KB  (entry point)
+  docs/index.js                          2.32 KB  (entry point)
+  docs/integration-supabase.docblock.js  2.32 KB  (entry point)
+  ./example.js                           1.0 KB   (entry point)
+  ./runtime.sample.js                    1.0 KB   (entry point)
+  ./tenant.js                            1.12 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=8
+Bundled 8 modules in 34ms
+
+  ./blueprint.js                         1.91 KB  (entry point)
+  ./index.js                             8.80 KB  (entry point)
+  ./connection.sample.js                 1.44 KB  (entry point)
+  docs/index.js                          2.32 KB  (entry point)
+  docs/integration-supabase.docblock.js  2.32 KB  (entry point)
+  ./example.js                           1.0 KB   (entry point)
+  ./runtime.sample.js                    1.0 KB   (entry point)
+  ./tenant.js                            1.12 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @contractspec/example.integration-supabase
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/integration.providers-impls@1.58.0
+  - @contractspec/integration.runtime@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/blueprint.d.ts

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

package/dist/blueprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blueprint.d.ts","names":[],"sources":["../src/blueprint.ts"],"mappings":";;;cAOa,0BAAA,EAA4B,gBAAA"}
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../src/blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAOpF,eAAO,MAAM,0BAA0B,EAAE,gBA4DxC,CAAC"}

package/dist/blueprint.js

@@ -1,75 +1,68 @@
-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."
+// @bun
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var 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."
+};
+export {
+  supabaseKnowledgeBlueprint
 };
-
-//#endregion
-export { supabaseKnowledgeBlueprint };
-//# sourceMappingURL=blueprint.js.map

package/dist/browser/blueprint.js

@@ -0,0 +1,67 @@
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var 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."
+};
+export {
+  supabaseKnowledgeBlueprint
+};

package/dist/browser/connection.sample.js

@@ -0,0 +1,54 @@
+// src/connection.sample.ts
+var 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"
+};
+var 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"
+};
+var supabaseConnectionSamples = [
+  supabaseVectorConnection,
+  supabaseDatabaseConnection
+];
+export {
+  supabaseVectorConnection,
+  supabaseDatabaseConnection,
+  supabaseConnectionSamples
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,54 @@
+// src/docs/integration-supabase.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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.`
+  }
+];
+registerDocBlocks(blocks);

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

@@ -0,0 +1,54 @@
+// src/docs/integration-supabase.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var 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 }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};