@contractspec/example.integration-supabase 1.57.0 → 1.58.0

package/dist/node/index.js

@@ -0,0 +1,278 @@
+// 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/runtime.sample.js

@@ -0,0 +1,32 @@
+// 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 {
+  runSupabaseKnowledgeRuntime
+};

package/dist/node/tenant.js

@@ -0,0 +1,42 @@
+// 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."
+};
+export {
+  supabaseKnowledgeTenantConfig
+};

package/dist/runtime.sample.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"runtime.sample.d.ts","sourceRoot":"","sources":["../src/runtime.sample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAEjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,kBAAkB,CAAC;IAClC,eAAe,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,8BAA8B,CAAC,CAoCzC"}

package/dist/runtime.sample.js

@@ -1,43 +1,33 @@
+// @bun
+// src/runtime.sample.ts
 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
-	};
+  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
+  };
 }
-
-//#endregion
-export { runSupabaseKnowledgeRuntime };
-//# sourceMappingURL=runtime.sample.js.map
+export {
+  runSupabaseKnowledgeRuntime
+};

package/dist/tenant.d.ts

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

package/dist/tenant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant.d.ts","names":[],"sources":["../src/tenant.ts"],"mappings":";;;cAEa,6BAAA,EAA+B,eAAA"}
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../src/tenant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAEnF,eAAO,MAAM,6BAA6B,EAAE,eAsC3C,CAAC"}

package/dist/tenant.js

@@ -1,40 +1,43 @@
-//#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."
+// @bun
+// 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."
+};
+export {
+  supabaseKnowledgeTenantConfig
 };
-
-//#endregion
-export { supabaseKnowledgeTenantConfig };
-//# sourceMappingURL=tenant.js.map