@contractspec/example.integration-supabase 1.57.0 → 1.58.0

package/dist/example.js

@@ -1,46 +1,34 @@
+// @bun
+// src/example.ts
 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 }
-	}
+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 }
+  }
 });
-
-//#endregion
-export { example as default };
-//# sourceMappingURL=example.js.map
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-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 };
+export * from './blueprint';
+export * from './tenant';
+export * from './connection.sample';
+export * from './runtime.sample';
+export { default as example } from './example';
+import './docs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,QAAQ,CAAC"}

package/dist/index.js

@@ -1,8 +1,279 @@
-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 };
+// @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."
+};
+
+// 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
+];
+
+// 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);
+// 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;
+
+// src/tenant.ts
+var 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: new Date().toISOString(),
+    updatedAt: 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."
+};
+
+// src/runtime.sample.ts
+import { IntegrationProviderFactory } from "@contractspec/integration.providers-impls/impls/provider-factory";
+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: [0.11, 0.23, 0.45],
+        payload: { source: "faq", locale: "en" }
+      }
+    ]
+  });
+  const matches = await vectorStore.search({
+    collection: "knowledge_chunks",
+    vector: [0.12, 0.22, 0.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
+  };
+}
+export {
+  supabaseVectorConnection,
+  supabaseKnowledgeTenantConfig,
+  supabaseKnowledgeBlueprint,
+  supabaseDatabaseConnection,
+  supabaseConnectionSamples,
+  runSupabaseKnowledgeRuntime,
+  example_default as example
+};

package/dist/node/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/node/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/node/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/node/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/node/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
+};