@contractspec/lib.contracts 1.62.0 → 1.64.0

package/dist/install.d.ts

@@ -1,76 +0,0 @@
-import * as z from 'zod';
-import type { AnyOperationSpec, EmitDecl, OperationSpec } from './operations/';
-import type { ResourceRefDescriptor } from './resources';
-import type { HandlerCtx } from './types';
-import { OperationSpecRegistry } from './operations/registry';
-import type { EventSpec } from './events';
-import type { AnySchemaModel, ZodSchemaModel } from '@contractspec/lib.schema';
-/** Infer input/output types from a OperationSpec */
-export type OperationSpecInput<Spec extends AnyOperationSpec> = Spec['io']['input'];
-export type ZodOperationSpecInput<Spec extends AnyOperationSpec> = ZodSchemaModel<OperationSpecInput<Spec> extends null ? AnySchemaModel : NonNullable<OperationSpecInput<Spec>>>;
-export type OperationSpecOutput<Spec extends AnyOperationSpec> = Spec['io']['output'];
-type ResourceItem<O extends ResourceRefDescriptor<boolean>> = Record<O['varName'] extends string ? O['varName'] : 'id', string | number>;
-type ResourceRefOut<O> = O extends ResourceRefDescriptor<boolean> ? O['many'] extends true ? ResourceItem<O>[] : ResourceItem<O> : never;
-export type RuntimeSpecOutput<Spec extends AnyOperationSpec> = OperationSpecOutput<Spec> extends AnySchemaModel ? ZodSchemaModel<OperationSpecOutput<Spec>> : ResourceRefOut<OperationSpecOutput<Spec>>;
-/** Handler signature derived from the Spec */
-export type HandlerForOperationSpec<Spec extends AnyOperationSpec> = (args: ZodOperationSpecInput<Spec>, ctx: HandlerCtx) => Promise<RuntimeSpecOutput<Spec>>;
-/** Typed event param from Spec.sideEffects.emits */
-export type EventParam<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S extends {
-    sideEffects?: {
-        emits?: readonly (infer E)[];
-    };
-} ? E extends {
-    key: string;
-    version: string;
-    payload: AnySchemaModel;
-} ? {
-    key: E['key'];
-    version: E['version'];
-    payload: z.infer<ReturnType<E['payload']['getZod']>>;
-} : never : never;
-/** Build a type union of allowed events for a spec */
-type AllowedEventUnion<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S['sideEffects'] extends {
-    emits: readonly EmitDecl[];
-} ? {
-    [K in keyof S['sideEffects']['emits']]: S['sideEffects']['emits'][K] extends {
-        ref: EventSpec<infer P>;
-    } ? {
-        key: S['sideEffects']['emits'][K]['ref']['meta']['key'];
-        version: S['sideEffects']['emits'][K]['ref']['meta']['version'];
-        payload: z.infer<ReturnType<P['getZod']>>;
-    } : S['sideEffects']['emits'][K] extends {
-        key: infer N extends string;
-        version: infer V extends string;
-        payload: infer Q extends AnySchemaModel;
-    } ? {
-        key: N;
-        version: V;
-        payload: z.infer<ReturnType<Q['getZod']>>;
-    } : never;
-}[number] : never;
-/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
-export declare function makeEmit<S extends AnyOperationSpec>(_spec: S, ctx: HandlerCtx): {
-    /** Le plus sûr : typé via EventSpec (pas besoin de tuple dans le spec) */
-    ref: <T extends AnySchemaModel>(ev: EventSpec<T>, payload: ZodSchemaModel<T>) => Promise<void>;
-    /** Nom/version explicites (runtime-checked par la guard) */
-    key: (key: string, version: string, payload: unknown) => Promise<void>;
-    /** Compat : objet (bénéficie du typing si votre spec a un tuple `as const`) */
-    object: (evt: AllowedEventUnion<S>) => Promise<void>;
-};
-/**
- * Register the Spec and bind the handler in one call, with full type inference.
- * Returns the registry for chaining.
- */
-export declare function installOp<S extends AnyOperationSpec>(reg: OperationSpecRegistry, spec: S, handler: HandlerForOperationSpec<S>): OperationSpecRegistry;
-/**
- * Curried variant if you prefer building a module installer.
- *   const install = op(BeginSignupSpec, handler);
- *   install(reg);
- */
-export declare function op<S extends AnyOperationSpec>(spec: S, handler: HandlerForOperationSpec<AnyOperationSpec>): {
-    spec: S;
-    handler: HandlerForOperationSpec<AnyOperationSpec>;
-    install: (reg: OperationSpecRegistry) => OperationSpecRegistry;
-};
-export {};
-//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/install.js

@@ -1,60 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/install.ts
-function makeEmit(_spec, ctx) {
-  return {
-    ref: async (ev, payload) => {
-      await ctx.__emitGuard__?.(ev.meta.key, ev.meta.version, payload);
-    },
-    key: async (key, version, payload) => {
-      await ctx.__emitGuard__?.(key, version, payload);
-    },
-    object: async (evt) => {
-      await ctx.__emitGuard__?.(evt.key, evt.version, evt.payload);
-    }
-  };
-}
-function installOp(reg, spec, handler) {
-  return reg.register(spec).bind(spec, handler);
-}
-function op(spec, handler) {
-  return {
-    spec,
-    handler,
-    install: (reg) => installOp(reg, spec, handler)
-  };
-}
-export {
-  op,
-  makeEmit,
-  installOp
-};

package/dist/integrations/binding.d.ts

@@ -1,15 +0,0 @@
-export interface AppIntegrationBinding {
-    /** Which slot this binding satisfies. */
-    slotId: string;
-    /** Which IntegrationConnection to use. */
-    connectionId: string;
-    /** Optional: scope to specific workflows/features. */
-    scope?: {
-        workflows?: string[];
-        features?: string[];
-        operations?: string[];
-    };
-    /** Priority when multiple connections provide same capability. */
-    priority?: number;
-}
-//# sourceMappingURL=binding.d.ts.map

package/dist/integrations/binding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/integrations/binding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/integrations/binding.js

@@ -1 +0,0 @@
-// @bun

package/dist/integrations/connection.d.ts

@@ -1,48 +0,0 @@
-import type { IntegrationOwnershipMode } from './spec';
-export type ConnectionStatus = 'connected' | 'disconnected' | 'error' | 'unknown';
-export interface IntegrationConnectionHealth {
-    status: ConnectionStatus;
-    checkedAt?: Date;
-    latencyMs?: number;
-    errorCode?: string;
-    errorMessage?: string;
-}
-export interface IntegrationUsageMetrics {
-    requestCount?: number;
-    successCount?: number;
-    errorCount?: number;
-    lastUsed?: Date;
-    lastSuccessAt?: Date;
-    lastErrorAt?: Date;
-    lastErrorCode?: string;
-}
-export interface IntegrationConnectionMeta {
-    id: string;
-    tenantId: string;
-    /** Reference to IntegrationSpec. */
-    integrationKey: string;
-    integrationVersion: string;
-    /** Human-readable label (e.g., "Production Stripe"). */
-    label: string;
-    environment?: string;
-    createdAt: string | Date;
-    updatedAt: string | Date;
-}
-export interface IntegrationConnection {
-    meta: IntegrationConnectionMeta;
-    /** Ownership mode indicating who controls credentials. */
-    ownershipMode: IntegrationOwnershipMode;
-    /** External provider account/project identifier (BYOK scenarios). */
-    externalAccountId?: string;
-    /** Encrypted configuration matching IntegrationSpec.configSchema. */
-    config: Record<string, unknown>;
-    /** Reference to external secret store entry containing credentials. */
-    secretProvider: string;
-    secretRef: string;
-    status: ConnectionStatus;
-    /** Last health check result. */
-    health?: IntegrationConnectionHealth;
-    /** Usage tracking. */
-    usage?: IntegrationUsageMetrics;
-}
-//# sourceMappingURL=connection.d.ts.map

package/dist/integrations/connection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/integrations/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,cAAc,GACd,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,yBAAyB,CAAC;IAChC,0DAA0D;IAC1D,aAAa,EAAE,wBAAwB,CAAC;IACxC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,gCAAgC;IAChC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,sBAAsB;IACtB,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC"}

package/dist/integrations/connection.js

@@ -1 +0,0 @@
-// @bun

package/dist/integrations/docs/integrations.docblock.d.ts

@@ -1,3 +0,0 @@
-import type { DocBlock } from '@contractspec/lib.contracts/docs';
-export declare const tech_contracts_integrations_DocBlocks: DocBlock[];
-//# sourceMappingURL=integrations.docblock.d.ts.map

package/dist/integrations/docs/integrations.docblock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"integrations.docblock.d.ts","sourceRoot":"","sources":["../../../src/integrations/docs/integrations.docblock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,qCAAqC,EAAE,QAAQ,EAuG3D,CAAC"}

package/dist/integrations/docs/integrations.docblock.js

@@ -1,255 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/docs/presentations.ts
-var DEFAULT_TARGETS = [
-  "markdown",
-  "react"
-];
-function normalizeRoute(route) {
-  if (!route.length)
-    return "/";
-  const withLeading = route.startsWith("/") ? route : `/${route}`;
-  return withLeading === "/" ? "/" : withLeading.replace(/\/+$/, "");
-}
-function deriveRoute(block, routePrefix) {
-  if (block.route)
-    return normalizeRoute(block.route);
-  const prefix = routePrefix ?? "/docs";
-  const slug = block.id.replace(/^docs\.?/, "").replace(/\./g, "/").replace(/\/+/g, "/");
-  const path = slug.startsWith("/") ? slug : `${prefix}/${slug}`;
-  return normalizeRoute(path);
-}
-function buildName(block, namespace) {
-  return namespace ? `${namespace}.${block.id}` : block.id;
-}
-function docBlockToPresentationSpec(block, options) {
-  const targets = options?.defaultTargets ?? DEFAULT_TARGETS;
-  const version = block.version ?? options?.defaultVersion ?? "1.0.0";
-  const stability = block.stability ?? options?.defaultStability ?? "stable";
-  return {
-    meta: {
-      key: buildName(block, options?.namespace),
-      title: block.title,
-      version,
-      description: block.summary ?? block.title,
-      tags: block.tags || [],
-      owners: block.owners || [],
-      domain: block.domain || "",
-      stability,
-      goal: `Documentation of: ${block.summary}`,
-      context: `Auto-generated`
-    },
-    policy: block.visibility && block.visibility !== "public" ? { flags: [block.visibility] } : undefined,
-    source: {
-      type: "blocknotejs",
-      docJson: block.body
-    },
-    targets
-  };
-}
-function docBlocksToPresentationRoutes(blocks, options) {
-  return blocks.map((block) => ({
-    block,
-    route: deriveRoute(block, options?.routePrefix),
-    descriptor: docBlockToPresentationSpec(block, options)
-  }));
-}
-function docBlocksToPresentationSpecs(blocks, options) {
-  return blocks.map((block) => docBlockToPresentationSpec(block, options));
-}
-function mapDocRoutes(routes) {
-  return routes.map(({ route, descriptor }) => [route, descriptor]);
-}
-
-// src/docs/registry.ts
-class DocRegistry {
-  routes = new Map;
-  constructor(blocks = [], options) {
-    blocks.forEach((block) => this.register(block, options));
-  }
-  register(block, options) {
-    const [route] = docBlocksToPresentationRoutes([block], options);
-    if (route) {
-      this.routes.set(block.id, route);
-    }
-    return this;
-  }
-  list() {
-    return [...this.routes.values()];
-  }
-  get(id) {
-    return this.routes.get(id);
-  }
-  toRouteTuples() {
-    return this.list().map(({ route, descriptor }) => [route, descriptor]);
-  }
-  toPresentationSpecs(options) {
-    return this.list().map(({ block }) => docBlockToPresentationSpec(block, options));
-  }
-}
-var requiredFields = [
-  "id",
-  "title",
-  "body",
-  "kind",
-  "visibility",
-  "route"
-];
-var defaultDocRegistry = new DocRegistry;
-function registerDocBlocks(blocks) {
-  for (const block of blocks) {
-    for (const field of requiredFields) {
-      if (!block[field]) {
-        throw new Error(`DocBlock ${block.id ?? "<missing id>"} missing field ${String(field)}`);
-      }
-    }
-    defaultDocRegistry.register(block);
-  }
-}
-function listRegisteredDocBlocks() {
-  return defaultDocRegistry.list().map((r) => r.block);
-}
-function docId(id) {
-  const found = defaultDocRegistry.get(id);
-  if (!found)
-    throw new Error(`DocBlock not registered: ${id}`);
-  return id;
-}
-
-// src/integrations/docs/integrations.docblock.ts
-var tech_contracts_integrations_DocBlocks = [
-  {
-    id: "docs.tech.contracts.integrations",
-    title: "ContractSpec Integrations",
-    summary: "Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/tech/contracts/integrations",
-    tags: ["tech", "contracts", "integrations"],
-    body: `# ContractSpec Integrations
-
-This document describes the integration architecture that powers ContractSpec-based apps. It focuses on provider-agnostic contracts, secret management, health checks, and runtime guards.
-
-## Core Concepts
-
-- **IntegrationSpec** \u2013 declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.
-- **IntegrationConnection** \u2013 tenant/environment binding to a provider (\`meta\` + ownership mode + config + \`secretRef\`). Secrets are never embedded in specs or configs.
-- **AppIntegrationSlot** \u2013 blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. \`primaryLLM\`, \`primaryVectorDb\`).
-- **AppIntegrationBinding** \u2013 tenant-level slot \u2192 connection mapping.
-- **ResolvedIntegration** \u2013 runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.
-
-## Registered Providers
-
-The contracts library ships twenty-two priority providers in \`packages/libs/contracts/src/integrations/providers\`:
-
-| Category      | Provider         | Key                         | Notes                                             |
-| ------------- | ---------------- | --------------------------- | ------------------------------------------------- |
-| payments      | Stripe           | \`payments.stripe\`          | Card + invoice flows, managed or BYOK credentials |
-| email (out)   | Postmark         | \`email.postmark\`           | Transactional email delivery                      |
-| email (in)    | Gmail API        | \`email.gmail\`              | Thread ingestion (OAuth BYOK or service account)  |
-| calendar      | Google Calendar  | \`calendar.google\`          | Event scheduling via service account              |
-| analytics     | PostHog          | \`analytics.posthog\`         | Product analytics, flags, and HogQL queries       |
-| vector-db     | Qdrant           | \`vectordb.qdrant\`          | Embedding storage & search                        |
-| vector-db     | Supabase pgvector| \`vectordb.supabase\`        | Embedding storage & search on Supabase Postgres   |
-| database      | Supabase Postgres| \`database.supabase\`        | SQL queries and transactions on Supabase Postgres |
-| storage       | Google Cloud     | \`storage.gcs\`              | Object storage                                    |
-| ai-llm        | Mistral          | \`ai-llm.mistral\`           | Primary chat + embedding provider                 |
-| ai-voice      | ElevenLabs       | \`ai-voice.elevenlabs\`      | Text-to-speech synthesis                          |
-| ai-voice      | Gradium          | \`ai-voice.gradium\`         | Low-latency text-to-speech synthesis              |
-| ai-voice      | Fal Chatterbox   | \`ai-voice.fal\`             | Chatterbox text-to-speech via queue API           |
-| sms           | Twilio SMS       | \`sms.twilio\`               | Urgent and fallback reminders                     |
-| open-banking  | Powens           | \`openbanking.powens\`       | Read-only account, transaction, and balance sync  |
-| project-management | Linear       | \`project-management.linear\` | Issues, project tracking, and team tasks          |
-| project-management | Jira Cloud   | \`project-management.jira\`   | Work item sync for Jira Cloud                     |
-| project-management | Notion       | \`project-management.notion\` | Shared summaries and task databases               |
-| meeting-recorder | Granola       | \`meeting-recorder.granola\`  | Meeting notes + transcripts via API or MCP        |
-| meeting-recorder | tl;dv         | \`meeting-recorder.tldv\`     | Meeting recordings, transcripts, and webhooks     |
-| meeting-recorder | Fireflies     | \`meeting-recorder.fireflies\` | GraphQL transcripts + webhook events              |
-| meeting-recorder | Fathom        | \`meeting-recorder.fathom\`   | External API meetings + webhook registration      |
-
-PostHog adapters also support read access (events, persons, insights, cohorts, annotations) via analytics providers.
-
-Each provider ships with:
-
-- Strongly typed adapter interfaces (\`payments.ts\`, \`llm.ts\`, etc.)
-- A concrete SDK-backed implementation under \`providers/impls\`
-- Unit tests validating adapter behaviour and health checks
-
-### Example package
-
-- Supabase dual-store example (vector + SQL): \`@contractspec/example.integration-supabase\`
-
-### Canonical registry builder
-
-To list all shipped specs at runtime, use:
-
-- \`createDefaultIntegrationSpecRegistry()\` from \`@contractspec/lib.contracts/integrations/providers/registry\`
-
-## Secret Management
-
-All integrations rely on the \`SecretProvider\` abstraction defined in \`integrations/secrets\`. Providers ship with the contracts library and are orchestrated by the \`SecretProviderManager\` composite:
-
-- **EnvSecretProvider** (\`env-secret-provider.ts\`) \u2013 high-priority, read-only overrides backed by environment variables.
-  - Supports the \`env://VARIABLE_NAME\` scheme
-  - Supports overrides for other schemes via \`?env=ALIAS\` or derived uppercase keys
-- **GcpSecretManagerProvider** (\`gcp-secret-manager.ts\`) \u2013 versioned secrets stored in Google Cloud Secret Manager.
-  - Example: \`gcp://projects/demo/secrets/stripe-key/versions/latest\`
-- **AwsSecretsManagerProvider** (\`aws-secret-manager.ts\`) \u2013 AWS Secrets Manager backend.
-  - Example: \`aws://secretsmanager/eu-west-1/my-secret?version=AWSCURRENT\`
-  - Region may be in the reference or provided via \`AWS_REGION\` / \`AWS_DEFAULT_REGION\`
-- **ScalewaySecretManagerProvider** (\`scaleway-secret-manager.ts\`) \u2013 Scaleway Secret Manager backend.
-  - Example (id): \`scw://secret-manager/fr-par/1234...-uuid?version=latest\`
-  - Example (name, create+write): \`scw://secret-manager/fr-par/my-secret-name\`
-  - Requires \`SCW_SECRET_KEY\` (token) and \`SCW_DEFAULT_PROJECT_ID\` when creating secrets by name
-
-The manager attempts providers in priority order (environment first, then cloud providers). Key points:
-
-- \`secretRef\` is a URI-like reference; raw secrets are never returned.
-- \`IntegrationCallGuard\` fetches and parses secrets before executing a provider adapter.
-- Local development can rely on \`.env\` files, while staging/production reference cloud secret stores.
-
-## Health Checks & Telemetry
-
-- Each IntegrationSpec optionally declares \`healthCheck.method\` and timeouts.
-- \`IntegrationCallGuard\` enforces connection status, wraps retries with exponential back-off, and emits telemetry events tagged with tenant/app/slot metadata.
-- Validation rules (\`app-config/validation.ts\`) surface issues at publish time (slot mismatch, unsupported ownership modes, missing capabilities, etc.).
-
-## Studio persistence (ContractSpec Studio)
-
-ContractSpec Studio persists tenant \`IntegrationConnection\` records in Postgres (Prisma model \`IntegrationConnection\` in \`@contractspec/lib.database-studio\`) and exposes a platform-admin management surface (see the Studio platform admin panel).
-`
-  }
-];
-registerDocBlocks(tech_contracts_integrations_DocBlocks);
-export {
-  tech_contracts_integrations_DocBlocks
-};

package/dist/integrations/health.d.ts

@@ -1,18 +0,0 @@
-import type { IntegrationConnectionHealth } from './connection';
-import type { IntegrationContext, IntegrationTelemetryEmitter } from './runtime';
-export interface IntegrationHealthCheckResult extends IntegrationConnectionHealth {
-    metadata?: Record<string, string>;
-}
-export type IntegrationHealthCheckExecutor = (context: IntegrationContext) => Promise<void>;
-export interface IntegrationHealthServiceOptions {
-    telemetry?: IntegrationTelemetryEmitter;
-    now?: () => Date;
-}
-export declare class IntegrationHealthService {
-    private readonly telemetry?;
-    private readonly nowFn;
-    constructor(options?: IntegrationHealthServiceOptions);
-    check(context: IntegrationContext, executor: IntegrationHealthCheckExecutor): Promise<IntegrationHealthCheckResult>;
-    private emitTelemetry;
-}
-//# sourceMappingURL=health.d.ts.map

package/dist/integrations/health.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/integrations/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EACV,kBAAkB,EAElB,2BAA2B,EAC5B,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,4BAA6B,SAAQ,2BAA2B;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,OAAO,GAAE,+BAAoC;IAKnD,KAAK,CACT,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,8BAA8B,GACvC,OAAO,CAAC,4BAA4B,CAAC;IA4BxC,OAAO,CAAC,aAAa;CAgCtB"}

package/dist/integrations/health.js

@@ -1,103 +0,0 @@
-// @bun
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = import.meta.require;
-
-// src/integrations/health.ts
-class IntegrationHealthService {
-  telemetry;
-  nowFn;
-  constructor(options = {}) {
-    this.telemetry = options.telemetry;
-    this.nowFn = options.now ?? (() => new Date);
-  }
-  async check(context, executor) {
-    const start = this.nowFn();
-    try {
-      await executor(context);
-      const end = this.nowFn();
-      const result = {
-        status: "connected",
-        checkedAt: end,
-        latencyMs: end.getTime() - start.getTime()
-      };
-      this.emitTelemetry(context, result, "success");
-      return result;
-    } catch (error) {
-      const end = this.nowFn();
-      const message = error instanceof Error ? error.message : "Unknown error";
-      const code = extractErrorCode(error);
-      const result = {
-        status: "error",
-        checkedAt: end,
-        latencyMs: end.getTime() - start.getTime(),
-        errorMessage: message,
-        errorCode: code
-      };
-      this.emitTelemetry(context, result, "error", code, message);
-      return result;
-    }
-  }
-  emitTelemetry(context, result, status, errorCode, errorMessage) {
-    if (!this.telemetry)
-      return;
-    this.telemetry.record({
-      tenantId: context.tenantId,
-      appId: context.appId,
-      environment: context.environment,
-      slotId: context.slotId,
-      integrationKey: context.spec.meta.key,
-      integrationVersion: context.spec.meta.version,
-      connectionId: context.connection.meta.id,
-      status,
-      durationMs: result.latencyMs,
-      errorCode,
-      errorMessage,
-      occurredAt: result.checkedAt ?? this.nowFn(),
-      metadata: {
-        ...context.trace ? {
-          blueprint: `${context.trace.blueprintName}.v${context.trace.blueprintVersion}`,
-          configVersion: context.trace.configVersion
-        } : {},
-        status: result.status
-      }
-    });
-  }
-}
-function extractErrorCode(error) {
-  if (!error || typeof error !== "object")
-    return;
-  const candidate = error;
-  if (candidate.code == null)
-    return;
-  return String(candidate.code);
-}
-export {
-  IntegrationHealthService
-};

package/dist/integrations/health.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=health.test.d.ts.map

package/dist/integrations/health.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"health.test.d.ts","sourceRoot":"","sources":["../../src/integrations/health.test.ts"],"names":[],"mappings":""}

package/dist/integrations/index.d.ts

@@ -1,12 +0,0 @@
-export * from './spec';
-export * from './connection';
-export * from './binding';
-export * from './providers';
-export * from './openbanking/models';
-export * from './openbanking/contracts';
-export * from './openbanking/guards';
-export * from './openbanking/telemetry';
-export { MeetingParticipantRecord, MeetingTranscriptSegmentRecord, MeetingRecorderWebhookEventRecord, MeetingRecord as MeetingRecordModel, MeetingTranscriptRecord as MeetingTranscriptRecordModel, } from './meeting-recorder/models';
-export * from './meeting-recorder/contracts';
-export * from './meeting-recorder/telemetry';
-//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,iCAAiC,EACjC,aAAa,IAAI,kBAAkB,EACnC,uBAAuB,IAAI,4BAA4B,GACxD,MAAM,2BAA2B,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC"}