@lssm/lib.contracts 1.2.0

package/dist/install.d.ts.map

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

package/dist/install.js

@@ -0,0 +1,2 @@
+import"./registry.js";import{z as e}from"zod";function t(e,t){return{ref:async(e,n)=>{await t.__emitGuard__?.(e.name,e.version,n)},named:async(e,n,r)=>{await t.__emitGuard__?.(e,n,r)},object:async e=>{await t.__emitGuard__?.(e.name,e.version,e.payload)}}}function n(e,t,n){return e.register(t).bind(t,n)}function r(e,t){return{spec:e,handler:t,install:r=>n(r,e,t)}}export{n as installOp,t as makeEmit,r as op};
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","names":[],"sources":["../src/install.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { AnyContractSpec, ContractSpec, EmitDecl } from './spec';\nimport type { ResourceRefDescriptor } from './resources';\nimport type { HandlerCtx } from './types';\nimport { SpecRegistry } from './registry';\nimport type { EventSpec } from './events';\nimport type { AnySchemaModel, ZodSchemaModel } from '@lssm/lib.schema';\n\n/** Infer input/output types from a ContractSpec */\nexport type SpecInput<Spec extends AnyContractSpec> = Spec['io']['input'];\nexport type ZodSpecInput<Spec extends AnyContractSpec> = ZodSchemaModel<\n  SpecInput<Spec> extends null ? AnySchemaModel : NonNullable<SpecInput<Spec>>\n>;\n\nexport type SpecOutput<Spec extends AnyContractSpec> = Spec['io']['output'];\n\ntype ResourceItem<O extends ResourceRefDescriptor<boolean>> = Record<\n  O['varName'] extends string ? O['varName'] : 'id',\n  string | number\n>;\n\ntype ResourceRefOut<O> =\n  O extends ResourceRefDescriptor<boolean>\n    ? O['many'] extends true\n      ? ResourceItem<O>[]\n      : ResourceItem<O>\n    : never;\n\nexport type RuntimeSpecOutput<Spec extends AnyContractSpec> =\n  SpecOutput<Spec> extends AnySchemaModel\n    ? ZodSchemaModel<SpecOutput<Spec>>\n    : ResourceRefOut<SpecOutput<Spec>>;\n\n/** Handler signature derived from the Spec */\nexport type HandlerFor<Spec extends AnyContractSpec> = (\n  args: ZodSpecInput<Spec>,\n  ctx: HandlerCtx\n) => Promise<RuntimeSpecOutput<Spec>>;\n\n/** Typed event param from Spec.sideEffects.emits */\nexport type EventParam<\n  S extends ContractSpec<\n    AnySchemaModel,\n    AnySchemaModel | ResourceRefDescriptor<boolean>\n  >,\n> = S extends { sideEffects?: { emits?: readonly (infer E)[] } }\n  ? E extends { name: string; version: number; payload: AnySchemaModel }\n    ? {\n        name: E['name'];\n        version: E['version'];\n        payload: z.infer<ReturnType<E['payload']['getZod']>>;\n      }\n    : never\n  : never;\n\n/** Build a type union of allowed events for a spec */\ntype AllowedEventUnion<\n  S extends ContractSpec<\n    AnySchemaModel,\n    AnySchemaModel | ResourceRefDescriptor<boolean>\n  >,\n> = S['sideEffects'] extends { emits: readonly EmitDecl[] }\n  ? {\n      [K in keyof S['sideEffects']['emits']]: S['sideEffects']['emits'][K] extends {\n        ref: EventSpec<infer P>;\n      }\n        ? {\n            name: S['sideEffects']['emits'][K]['ref']['name'];\n            version: S['sideEffects']['emits'][K]['ref']['version'];\n            payload: z.infer<ReturnType<P['getZod']>>;\n          }\n        : S['sideEffects']['emits'][K] extends {\n              name: infer N extends string;\n              version: infer V extends number;\n              payload: infer Q extends AnySchemaModel;\n            }\n          ? { name: N; version: V; payload: z.infer<ReturnType<Q['getZod']>> }\n          : never;\n    }[number]\n  : never;\n\n/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */\nexport function makeEmit<S extends AnyContractSpec>(_spec: S, ctx: HandlerCtx) {\n  return {\n    /** Le plus sûr : typé via EventSpec (pas besoin de tuple dans le spec) */\n    ref: async <T extends AnySchemaModel>(\n      ev: EventSpec<T>,\n      payload: ZodSchemaModel<T>\n    ) => {\n      await ctx.__emitGuard__?.(ev.name, ev.version, payload);\n    },\n    /** Nom/version explicites (runtime-checked par la guard) */\n    named: async (name: string, version: number, payload: unknown) => {\n      await ctx.__emitGuard__?.(name, version, payload);\n    },\n    /** Compat : objet (bénéficie du typing si votre spec a un tuple `as const`) */\n    object: async (evt: AllowedEventUnion<S>) => {\n      // expect-error — OK si le union est précis, sinon fallback accepte string/number/unknown\n      await ctx.__emitGuard__?.(evt.name, evt.version, (evt as any).payload);\n    },\n  };\n}\n\n/**\n * Register the Spec and bind the handler in one call, with full type inference.\n * Returns the registry for chaining.\n */\nexport function installOp<S extends AnyContractSpec>(\n  reg: SpecRegistry,\n  spec: S,\n  handler: HandlerFor<S>\n): SpecRegistry {\n  return reg.register(spec).bind(spec, handler);\n}\n\n/**\n * Curried variant if you prefer building a module installer.\n *   const install = op(BeginSignupSpec, handler);\n *   install(reg);\n */\nexport function op<S extends AnyContractSpec>(\n  spec: S,\n  handler: HandlerFor<AnyContractSpec>\n) {\n  return {\n    spec,\n    handler,\n    install: (reg: SpecRegistry) => installOp(reg, spec, handler),\n  };\n}\n"],"mappings":"8CAkFA,SAAgB,EAAoC,EAAU,EAAiB,CAC7E,MAAO,CAEL,IAAK,MACH,EACA,IACG,CACH,MAAM,EAAI,gBAAgB,EAAG,KAAM,EAAG,QAAS,EAAQ,EAGzD,MAAO,MAAO,EAAc,EAAiB,IAAqB,CAChE,MAAM,EAAI,gBAAgB,EAAM,EAAS,EAAQ,EAGnD,OAAQ,KAAO,IAA8B,CAE3C,MAAM,EAAI,gBAAgB,EAAI,KAAM,EAAI,QAAU,EAAY,QAAQ,EAEzE,CAOH,SAAgB,EACd,EACA,EACA,EACc,CACd,OAAO,EAAI,SAAS,EAAK,CAAC,KAAK,EAAM,EAAQ,CAQ/C,SAAgB,EACd,EACA,EACA,CACA,MAAO,CACL,OACA,UACA,QAAU,GAAsB,EAAU,EAAK,EAAM,EAAQ,CAC9D"}

package/dist/integrations/binding.d.ts

@@ -0,0 +1,18 @@
+//#region src/integrations/binding.d.ts
+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;
+}
+//#endregion
+export { AppIntegrationBinding };
+//# sourceMappingURL=binding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","names":[],"sources":["../../src/integrations/binding.ts"],"sourcesContent":[],"mappings":";UAAiB,qBAAA;EAAA"}

package/dist/integrations/connection.d.ts

@@ -0,0 +1,52 @@
+import { IntegrationOwnershipMode } from "./spec.js";
+
+//#region src/integrations/connection.d.ts
+type ConnectionStatus = 'connected' | 'disconnected' | 'error' | 'unknown';
+interface IntegrationConnectionHealth {
+  status: ConnectionStatus;
+  checkedAt?: Date;
+  latencyMs?: number;
+  errorCode?: string;
+  errorMessage?: string;
+}
+interface IntegrationUsageMetrics {
+  requestCount?: number;
+  successCount?: number;
+  errorCount?: number;
+  lastUsed?: Date;
+  lastSuccessAt?: Date;
+  lastErrorAt?: Date;
+  lastErrorCode?: string;
+}
+interface IntegrationConnectionMeta {
+  id: string;
+  tenantId: string;
+  /** Reference to IntegrationSpec. */
+  integrationKey: string;
+  integrationVersion: number;
+  /** Human-readable label (e.g., "Production Stripe"). */
+  label: string;
+  environment?: string;
+  createdAt: string | Date;
+  updatedAt: string | Date;
+}
+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;
+}
+//#endregion
+export { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics };
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","names":[],"sources":["../../src/integrations/connection.ts"],"sourcesContent":[],"mappings":";;;KAEY,gBAAA;UAEK,2BAAA;EAFL,MAAA,EAGF,gBAHkB;EAEX,SAAA,CAAA,EAEH,IAFG;EAQA,SAAA,CAAA,EAAA,MAAA;EAIJ,SAAA,CAAA,EAAA,MAAA;EACK,YAAA,CAAA,EAAA,MAAA;;AACE,UANH,uBAAA,CAMG;EAIH,YAAA,CAAA,EAAA,MAAA;EAaA,YAAA,CAAA,EAAA,MAAA;EACT,UAAA,CAAA,EAAA,MAAA;EAES,QAAA,CAAA,EAtBJ,IAsBI;EAIP,aAAA,CAAA,EAzBQ,IAyBR;EAIA,WAAA,CAAA,EA5BM,IA4BN;EAEC,aAAA,CAAA,EAAA,MAAA;;AAEsB,UA5BhB,yBAAA,CA4BgB;;;;;;;;;sBAnBX;sBACA;;UAGL,qBAAA;QACT;;iBAES;;;;UAIP;;;;UAIA;;WAEC;;UAED"}

package/dist/integrations/contracts.d.ts

@@ -0,0 +1,434 @@
+import { ContractSpec } from "../spec.js";
+import { SpecRegistry } from "../registry.js";
+
+//#region src/integrations/contracts.d.ts
+declare const CreateIntegrationConnection: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  integrationKey: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  integrationVersion: {
+    type: void 0<number, number>;
+    isOptional: false;
+  };
+  label: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  ownershipMode: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  externalAccountId: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  secretProvider: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  secretRef: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  config: {
+    type: void 0<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  id: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  tenantId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  integrationKey: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  integrationVersion: {
+    type: void 0<number, number>;
+    isOptional: false;
+  };
+  label: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  ownershipMode: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  externalAccountId: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  secretProvider: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  secretRef: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  healthStatus: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  healthCheckedAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  healthLatencyMs: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  healthErrorCode: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  healthErrorMessage: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  usageRequestCount: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  usageSuccessCount: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  usageErrorCount: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  usageLastUsedAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  usageLastErrorAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  usageLastErrorCode: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  updatedAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const UpdateIntegrationConnection: ContractSpec<SchemaModel<{
+  connectionId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  label: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  status: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  ownershipMode: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  externalAccountId: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  secretProvider: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  secretRef: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  config: {
+    type: void 0<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>, SchemaModel<{
+  id: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  tenantId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  integrationKey: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  integrationVersion: {
+    type: void 0<number, number>;
+    isOptional: false;
+  };
+  label: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  ownershipMode: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  externalAccountId: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  secretProvider: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  secretRef: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  environment: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  healthStatus: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  healthCheckedAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  healthLatencyMs: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  healthErrorCode: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  healthErrorMessage: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  usageRequestCount: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  usageSuccessCount: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  usageErrorCount: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  usageLastUsedAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  usageLastErrorAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  usageLastErrorCode: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  createdAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+  updatedAt: {
+    type: void 0<Date, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const DeleteIntegrationConnection: ContractSpec<SchemaModel<{
+  connectionId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  success: {
+    type: void 0<boolean, boolean>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const ListIntegrationConnections: ContractSpec<SchemaModel<{
+  tenantId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+  category: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  status: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+}>, SchemaModel<{
+  connections: {
+    type: SchemaModel<{
+      id: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      tenantId: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      integrationKey: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      integrationVersion: {
+        type: void 0<number, number>;
+        isOptional: false;
+      };
+      label: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      ownershipMode: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      externalAccountId: {
+        type: void 0<string, string>;
+        isOptional: true;
+      };
+      secretProvider: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      secretRef: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      status: {
+        type: void 0<string, string>;
+        isOptional: false;
+      };
+      environment: {
+        type: void 0<string, string>;
+        isOptional: true;
+      };
+      healthStatus: {
+        type: void 0<string, string>;
+        isOptional: true;
+      };
+      healthCheckedAt: {
+        type: void 0<Date, string>;
+        isOptional: true;
+      };
+      healthLatencyMs: {
+        type: void 0<number, number>;
+        isOptional: true;
+      };
+      healthErrorCode: {
+        type: void 0<string, string>;
+        isOptional: true;
+      };
+      healthErrorMessage: {
+        type: void 0<string, string>;
+        isOptional: true;
+      };
+      usageRequestCount: {
+        type: void 0<number, number>;
+        isOptional: true;
+      };
+      usageSuccessCount: {
+        type: void 0<number, number>;
+        isOptional: true;
+      };
+      usageErrorCount: {
+        type: void 0<number, number>;
+        isOptional: true;
+      };
+      usageLastUsedAt: {
+        type: void 0<Date, string>;
+        isOptional: true;
+      };
+      usageLastErrorAt: {
+        type: void 0<Date, string>;
+        isOptional: true;
+      };
+      usageLastErrorCode: {
+        type: void 0<string, string>;
+        isOptional: true;
+      };
+      createdAt: {
+        type: void 0<Date, string>;
+        isOptional: true;
+      };
+      updatedAt: {
+        type: void 0<Date, string>;
+        isOptional: true;
+      };
+    }>;
+    isOptional: false;
+    isArray: true;
+  };
+}>, undefined>;
+declare const TestIntegrationConnection: ContractSpec<SchemaModel<{
+  connectionId: {
+    type: void 0<string, string>;
+    isOptional: false;
+  };
+}>, SchemaModel<{
+  success: {
+    type: void 0<boolean, boolean>;
+    isOptional: false;
+  };
+  status: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  latencyMs: {
+    type: void 0<number, number>;
+    isOptional: true;
+  };
+  error: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+  errorCode: {
+    type: void 0<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const integrationContracts: Record<string, ContractSpec<any, any>>;
+declare function registerIntegrationContracts(registry: SpecRegistry): SpecRegistry;
+//#endregion
+export { CreateIntegrationConnection, DeleteIntegrationConnection, ListIntegrationConnections, TestIntegrationConnection, UpdateIntegrationConnection, integrationContracts, registerIntegrationContracts };
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","names":[],"sources":["../../src/integrations/contracts.ts"],"sourcesContent":[],"mappings":";;;;cAgJa,6BAA2B,aAAA;EAA3B,QAAA,EAAA;IAoBX,IAAA,EAAA,KAAA,CAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;IApBsC,IAAA,QAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAAA,KAAA;;EAAA,CAAA;EAAA,QAAA,EAAA;IAsB3B,IAAA,QAoBX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;;EApBsC,KAAA,EAAA;IAAA,IAAA,QAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAA,CAAA;EAAA,eAAA,EAAA;IAsB3B,IAAA,QAoBX,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,IAAA;EApBsC,CAAA;EAAA,eAAA,EAAA;;IAAA,UAAA,EAAA,IAAA;EAAA,CAAA;EAsB3B,eAAA,EAAA;IAoBX,IAAA,QAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;EApBqC,kBAAA,EAAA;IAAA,IAAA,QAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAA,SAAA,EAAA;IAAA,IAAA,QAAA,KAAA,EAAA,MAAA,CAAA;IAsB1B,UAAA,EAAA,IAAA;EAoBX,CAAA;CApBoC,CAAA,EAAA,SAAA,CAAA;AAAA,cAlEzB,2BAkEyB,EAlEE,YAkEF,CAlEE,WAkEF,CAAA;;UA9CpC,KAAA;;;;IA8CoC,IAAA,QAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,IAAA;EAsBzB,CAAA;EAWG,MAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;UAnGwB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsB3B,6BAA2B,aAAA;;UAoBtC,KAAA;;;;;UApBsC,KAAA;;;;cAsB3B,4BAA0B,aAAA;;UAoBrC,KAAA;;;;;;;;;;;;;;;cApBqC,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsB1B,2BAAyB,aAAA;;UAoBpC,KAAA;;;;;UApBoC,KAAA;;;;;;;;;;;;;;;;;;;;cAsBzB,sBAAsB,eAEjC;iBASc,4BAAA,WAAuC,eAAY"}

package/dist/integrations/contracts.js

@@ -0,0 +1,2 @@
+import{ScalarTypeEnum as e}from"../schema/src/ScalarTypeEnum.js";import{SchemaModel as t}from"../schema/src/SchemaModel.js";import"../schema/src/index.js";import{defineCommand as n,defineQuery as r}from"../spec.js";const i=new t({name:`IntegrationConnectionRecord`,fields:{id:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},integrationKey:{type:e.NonEmptyString(),isOptional:!1},integrationVersion:{type:e.Int_unsecure(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!1},ownershipMode:{type:e.String_unsecure(),isOptional:!1},externalAccountId:{type:e.String_unsecure(),isOptional:!0},secretProvider:{type:e.String_unsecure(),isOptional:!1},secretRef:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},healthStatus:{type:e.String_unsecure(),isOptional:!0},healthCheckedAt:{type:e.DateTime(),isOptional:!0},healthLatencyMs:{type:e.Float_unsecure(),isOptional:!0},healthErrorCode:{type:e.String_unsecure(),isOptional:!0},healthErrorMessage:{type:e.String_unsecure(),isOptional:!0},usageRequestCount:{type:e.Int_unsecure(),isOptional:!0},usageSuccessCount:{type:e.Int_unsecure(),isOptional:!0},usageErrorCount:{type:e.Int_unsecure(),isOptional:!0},usageLastUsedAt:{type:e.DateTime(),isOptional:!0},usageLastErrorAt:{type:e.DateTime(),isOptional:!0},usageLastErrorCode:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!0},updatedAt:{type:e.DateTime(),isOptional:!0}}}),a=new t({name:`CreateIntegrationConnectionInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},integrationKey:{type:e.NonEmptyString(),isOptional:!1},integrationVersion:{type:e.Int_unsecure(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!1},ownershipMode:{type:e.String_unsecure(),isOptional:!1},externalAccountId:{type:e.String_unsecure(),isOptional:!0},secretProvider:{type:e.String_unsecure(),isOptional:!1},secretRef:{type:e.String_unsecure(),isOptional:!1},environment:{type:e.String_unsecure(),isOptional:!0},config:{type:e.JSONObject(),isOptional:!1}}}),o=new t({name:`UpdateIntegrationConnectionInput`,fields:{connectionId:{type:e.ID(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!0},status:{type:e.String_unsecure(),isOptional:!0},ownershipMode:{type:e.String_unsecure(),isOptional:!0},externalAccountId:{type:e.String_unsecure(),isOptional:!0},secretProvider:{type:e.String_unsecure(),isOptional:!0},secretRef:{type:e.String_unsecure(),isOptional:!0},config:{type:e.JSONObject(),isOptional:!0}}}),s=new t({name:`DeleteIntegrationConnectionInput`,fields:{connectionId:{type:e.ID(),isOptional:!1}}}),c=new t({name:`ListIntegrationConnectionsInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!0},status:{type:e.String_unsecure(),isOptional:!0}}}),l=new t({name:`ListIntegrationConnectionsOutput`,fields:{connections:{type:i,isOptional:!1,isArray:!0}}}),u=new t({name:`TestIntegrationConnectionInput`,fields:{connectionId:{type:e.ID(),isOptional:!1}}}),d=new t({name:`TestIntegrationConnectionOutput`,fields:{success:{type:e.Boolean(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!0},latencyMs:{type:e.Float_unsecure(),isOptional:!0},error:{type:e.String_unsecure(),isOptional:!0},errorCode:{type:e.String_unsecure(),isOptional:!0}}}),f=new t({name:`DeleteIntegrationConnectionOutput`,fields:{success:{type:e.Boolean(),isOptional:!1}}}),p=n({meta:{name:`integrations.connection.create`,version:1,description:`Create a new integration connection for a tenant.`,goal:`Provision a tenant-scoped connection to an external provider.`,context:`Used by Ops or the App Studio to configure external integrations such as Stripe or Qdrant.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:a,output:i},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),m=n({meta:{name:`integrations.connection.update`,version:1,description:`Update metadata or credentials for an integration connection.`,goal:`Allow secure rotation of credentials and metadata adjustments.`,context:`Supports rotating API keys, toggling status, or updating labels for tenant integrations.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:o,output:i},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),h=n({meta:{name:`integrations.connection.delete`,version:1,description:`Delete an integration connection for a tenant.`,goal:`Safely remove credentials and disable connector usage.`,context:`Ensures connections are de-provisioned when no longer needed or breached.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:s,output:f},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),g=r({meta:{name:`integrations.connection.list`,version:1,description:`List integration connections for a tenant.`,goal:`Provide visibility into configured integrations and their status.`,context:`Used by the App Studio and Ops flows to show bindings and health.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:c,output:l},policy:{auth:`admin`,policies:[{name:`platform.integration.read`,version:1}]}}),_=n({meta:{name:`integrations.connection.test`,version:1,description:`Run a health check against a configured integration connection.`,goal:`Validate credentials and connectivity for external providers.`,context:`Triggered manually or by background monitors to confirm provider availability.`,owners:[`platform.integrations`],tags:[`integration`,`connections`],stability:`experimental`},io:{input:u,output:d},policy:{auth:`admin`,policies:[{name:`platform.integration.manage`,version:1}]}}),v={CreateIntegrationConnection:p,UpdateIntegrationConnection:m,DeleteIntegrationConnection:h,ListIntegrationConnections:g,TestIntegrationConnection:_};function y(e){return e.register(p).register(m).register(h).register(g).register(_)}export{p as CreateIntegrationConnection,h as DeleteIntegrationConnection,g as ListIntegrationConnections,_ as TestIntegrationConnection,m as UpdateIntegrationConnection,v as integrationContracts,y as registerIntegrationContracts};
+//# sourceMappingURL=contracts.js.map

package/dist/integrations/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":["integrationContracts: Record<\n  string,\n  ContractSpec<any, any>\n>"],"sources":["../../src/integrations/contracts.ts"],"sourcesContent":["import {\n  ScalarTypeEnum,\n  SchemaModel,\n} from '@lssm/lib.schema';\nimport {\n  defineCommand,\n  defineQuery,\n  type ContractSpec,\n} from '../spec';\nimport type { SpecRegistry } from '../registry';\n\nconst IntegrationConnectionRecord = new SchemaModel({\n  name: 'IntegrationConnectionRecord',\n  fields: {\n    id: { type: ScalarTypeEnum.ID(), isOptional: false },\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    integrationKey: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    integrationVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    label: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    externalAccountId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    secretProvider: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    secretRef: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    environment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    healthCheckedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    healthLatencyMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: true },\n    healthErrorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    healthErrorMessage: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    usageRequestCount: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    usageSuccessCount: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    usageErrorCount: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    usageLastUsedAt: {\n      type: ScalarTypeEnum.DateTime(),\n      isOptional: true,\n    },\n    usageLastErrorAt: {\n      type: ScalarTypeEnum.DateTime(),\n      isOptional: true,\n    },\n    usageLastErrorCode: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n\nconst CreateIntegrationConnectionInput = new SchemaModel({\n  name: 'CreateIntegrationConnectionInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    integrationKey: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    integrationVersion: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    label: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    externalAccountId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    secretProvider: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    secretRef: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    environment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    config: { type: ScalarTypeEnum.JSONObject(), isOptional: false },\n  },\n});\n\nconst UpdateIntegrationConnectionInput = new SchemaModel({\n  name: 'UpdateIntegrationConnectionInput',\n  fields: {\n    connectionId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    label: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    externalAccountId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    secretProvider: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    secretRef: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    config: { type: ScalarTypeEnum.JSONObject(), isOptional: true },\n  },\n});\n\nconst DeleteIntegrationConnectionInput = new SchemaModel({\n  name: 'DeleteIntegrationConnectionInput',\n  fields: {\n    connectionId: { type: ScalarTypeEnum.ID(), isOptional: false },\n  },\n});\n\nconst ListIntegrationConnectionsInput = new SchemaModel({\n  name: 'ListIntegrationConnectionsInput',\n  fields: {\n    tenantId: { type: ScalarTypeEnum.ID(), isOptional: false },\n    category: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst ListIntegrationConnectionsOutput = new SchemaModel({\n  name: 'ListIntegrationConnectionsOutput',\n  fields: {\n    connections: {\n      type: IntegrationConnectionRecord,\n      isOptional: false,\n      isArray: true,\n    },\n  },\n});\n\nconst TestIntegrationConnectionInput = new SchemaModel({\n  name: 'TestIntegrationConnectionInput',\n  fields: {\n    connectionId: { type: ScalarTypeEnum.ID(), isOptional: false },\n  },\n});\n\nconst TestIntegrationConnectionOutput = new SchemaModel({\n  name: 'TestIntegrationConnectionOutput',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    latencyMs: { type: ScalarTypeEnum.Float_unsecure(), isOptional: true },\n    error: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    errorCode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst DeleteIntegrationConnectionOutput = new SchemaModel({\n  name: 'DeleteIntegrationConnectionOutput',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n  },\n});\n\nexport const CreateIntegrationConnection = defineCommand({\n  meta: {\n    name: 'integrations.connection.create',\n    version: 1,\n    description: 'Create a new integration connection for a tenant.',\n    goal: 'Provision a tenant-scoped connection to an external provider.',\n    context:\n      'Used by Ops or the App Studio to configure external integrations such as Stripe or Qdrant.',\n    owners: ['platform.integrations'],\n    tags: ['integration', 'connections'],\n    stability: 'experimental',\n  },\n  io: {\n    input: CreateIntegrationConnectionInput,\n    output: IntegrationConnectionRecord,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.integration.manage', version: 1 }],\n  },\n});\n\nexport const UpdateIntegrationConnection = defineCommand({\n  meta: {\n    name: 'integrations.connection.update',\n    version: 1,\n    description: 'Update metadata or credentials for an integration connection.',\n    goal: 'Allow secure rotation of credentials and metadata adjustments.',\n    context:\n      'Supports rotating API keys, toggling status, or updating labels for tenant integrations.',\n    owners: ['platform.integrations'],\n    tags: ['integration', 'connections'],\n    stability: 'experimental',\n  },\n  io: {\n    input: UpdateIntegrationConnectionInput,\n    output: IntegrationConnectionRecord,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.integration.manage', version: 1 }],\n  },\n});\n\nexport const DeleteIntegrationConnection = defineCommand({\n  meta: {\n    name: 'integrations.connection.delete',\n    version: 1,\n    description: 'Delete an integration connection for a tenant.',\n    goal: 'Safely remove credentials and disable connector usage.',\n    context:\n      'Ensures connections are de-provisioned when no longer needed or breached.',\n    owners: ['platform.integrations'],\n    tags: ['integration', 'connections'],\n    stability: 'experimental',\n  },\n  io: {\n    input: DeleteIntegrationConnectionInput,\n    output: DeleteIntegrationConnectionOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.integration.manage', version: 1 }],\n  },\n});\n\nexport const ListIntegrationConnections = defineQuery({\n  meta: {\n    name: 'integrations.connection.list',\n    version: 1,\n    description: 'List integration connections for a tenant.',\n    goal: 'Provide visibility into configured integrations and their status.',\n    context:\n      'Used by the App Studio and Ops flows to show bindings and health.',\n    owners: ['platform.integrations'],\n    tags: ['integration', 'connections'],\n    stability: 'experimental',\n  },\n  io: {\n    input: ListIntegrationConnectionsInput,\n    output: ListIntegrationConnectionsOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.integration.read', version: 1 }],\n  },\n});\n\nexport const TestIntegrationConnection = defineCommand({\n  meta: {\n    name: 'integrations.connection.test',\n    version: 1,\n    description: 'Run a health check against a configured integration connection.',\n    goal: 'Validate credentials and connectivity for external providers.',\n    context:\n      'Triggered manually or by background monitors to confirm provider availability.',\n    owners: ['platform.integrations'],\n    tags: ['integration', 'connections'],\n    stability: 'experimental',\n  },\n  io: {\n    input: TestIntegrationConnectionInput,\n    output: TestIntegrationConnectionOutput,\n  },\n  policy: {\n    auth: 'admin',\n    policies: [{ name: 'platform.integration.manage', version: 1 }],\n  },\n});\n\nexport const integrationContracts: Record<\n  string,\n  ContractSpec<any, any>\n> = {\n  CreateIntegrationConnection,\n  UpdateIntegrationConnection,\n  DeleteIntegrationConnection,\n  ListIntegrationConnections,\n  TestIntegrationConnection,\n};\n\nexport function registerIntegrationContracts(registry: SpecRegistry) {\n  return registry\n    .register(CreateIntegrationConnection)\n    .register(UpdateIntegrationConnection)\n    .register(DeleteIntegrationConnection)\n    .register(ListIntegrationConnections)\n    .register(TestIntegrationConnection);\n}\n\n"],"mappings":"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"}

package/dist/integrations/health.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","names":[],"sources":["../../src/integrations/health.ts"],"sourcesContent":[],"mappings":";;;;UAOiB,4BAAA,SAAqC;aACzC;AADb;AAIY,KAAA,8BAAA,GAA8B,CAAA,OAC/B,EAAA,kBACN,EAAA,GAAA,OAAO,CAAA,IAAA,CAAA;AAEK,UAAA,+BAAA,CAA+B;EAKnC,SAAA,CAAA,EAJC,2BAIuB;EAId,GAAA,CAAA,EAAA,GAAA,GAPT,IAOS;;AAOT,cAXD,wBAAA,CAWC;EACD,iBAAA,SAAA;EAAR,iBAAA,KAAA;EAAO,WAAA,CAAA,OAAA,CAAA,EARW,+BAQX;iBAFC,8BACC,iCACT,QAAQ"}

package/dist/integrations/health.js

@@ -0,0 +1,2 @@
+var e=class{telemetry;nowFn;constructor(e={}){this.telemetry=e.telemetry,this.nowFn=e.now??(()=>new Date)}async check(e,n){let r=this.nowFn();try{await n(e);let t=this.nowFn(),i={status:`connected`,checkedAt:t,latencyMs:t.getTime()-r.getTime()};return this.emitTelemetry(e,i,`success`),i}catch(n){let i=this.nowFn(),a=n instanceof Error?n.message:`Unknown error`,o=t(n),s={status:`error`,checkedAt:i,latencyMs:i.getTime()-r.getTime(),errorMessage:a,errorCode:o};return this.emitTelemetry(e,s,`error`,o,a),s}}emitTelemetry(e,t,n,r,i){this.telemetry&&this.telemetry.record({tenantId:e.tenantId,appId:e.appId,environment:e.environment,slotId:e.slotId,integrationKey:e.spec.meta.key,integrationVersion:e.spec.meta.version,connectionId:e.connection.meta.id,status:n,durationMs:t.latencyMs,errorCode:r,errorMessage:i,occurredAt:t.checkedAt??this.nowFn(),metadata:{...e.trace?{blueprint:`${e.trace.blueprintName}.v${e.trace.blueprintVersion}`,configVersion:e.trace.configVersion}:{},status:t.status}})}};function t(e){if(!e||typeof e!=`object`)return;let t=e;if(t.code!=null)return String(t.code)}export{e as IntegrationHealthService};
+//# sourceMappingURL=health.js.map

package/dist/integrations/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","names":["result: IntegrationHealthCheckResult"],"sources":["../../src/integrations/health.ts"],"sourcesContent":["import type { IntegrationConnectionHealth } from './connection';\nimport type {\n  IntegrationContext,\n  IntegrationInvocationStatus,\n  IntegrationTelemetryEmitter,\n} from './runtime';\n\nexport interface IntegrationHealthCheckResult extends IntegrationConnectionHealth {\n  metadata?: Record<string, string>;\n}\n\nexport type IntegrationHealthCheckExecutor = (\n  context: IntegrationContext\n) => Promise<void>;\n\nexport interface IntegrationHealthServiceOptions {\n  telemetry?: IntegrationTelemetryEmitter;\n  now?: () => Date;\n}\n\nexport class IntegrationHealthService {\n  private readonly telemetry?: IntegrationTelemetryEmitter;\n  private readonly nowFn: () => Date;\n\n  constructor(options: IntegrationHealthServiceOptions = {}) {\n    this.telemetry = options.telemetry;\n    this.nowFn = options.now ?? (() => new Date());\n  }\n\n  async check(\n    context: IntegrationContext,\n    executor: IntegrationHealthCheckExecutor\n  ): Promise<IntegrationHealthCheckResult> {\n    const start = this.nowFn();\n    try {\n      await executor(context);\n      const end = this.nowFn();\n      const result: IntegrationHealthCheckResult = {\n        status: 'connected',\n        checkedAt: end,\n        latencyMs: end.getTime() - start.getTime(),\n      };\n      this.emitTelemetry(context, result, 'success');\n      return result;\n    } catch (error) {\n      const end = this.nowFn();\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      const code = extractErrorCode(error);\n      const result: IntegrationHealthCheckResult = {\n        status: 'error',\n        checkedAt: end,\n        latencyMs: end.getTime() - start.getTime(),\n        errorMessage: message,\n        errorCode: code,\n      };\n      this.emitTelemetry(context, result, 'error', code, message);\n      return result;\n    }\n  }\n\n  private emitTelemetry(\n    context: IntegrationContext,\n    result: IntegrationHealthCheckResult,\n    status: IntegrationInvocationStatus,\n    errorCode?: string,\n    errorMessage?: string\n  ) {\n    if (!this.telemetry) return;\n    this.telemetry.record({\n      tenantId: context.tenantId,\n      appId: context.appId,\n      environment: context.environment,\n      slotId: context.slotId,\n      integrationKey: context.spec.meta.key,\n      integrationVersion: context.spec.meta.version,\n      connectionId: context.connection.meta.id,\n      status,\n      durationMs: result.latencyMs,\n      errorCode,\n      errorMessage,\n      occurredAt: result.checkedAt ?? this.nowFn(),\n      metadata: {\n        ...(context.trace\n          ? {\n              blueprint: `${context.trace.blueprintName}.v${context.trace.blueprintVersion}`,\n              configVersion: context.trace.configVersion,\n            }\n          : {}),\n        status: result.status,\n      },\n    });\n  }\n}\n\nfunction extractErrorCode(error: unknown): string | undefined {\n  if (!error || typeof error !== 'object') return undefined;\n  const candidate = error as { code?: string | number };\n  if (candidate.code == null) return undefined;\n  return String(candidate.code);\n}\n\n\n"],"mappings":"AAoBA,IAAa,EAAb,KAAsC,CACpC,UACA,MAEA,YAAY,EAA2C,EAAE,CAAE,CACzD,KAAK,UAAY,EAAQ,UACzB,KAAK,MAAQ,EAAQ,UAAc,IAAI,MAGzC,MAAM,MACJ,EACA,EACuC,CACvC,IAAM,EAAQ,KAAK,OAAO,CAC1B,GAAI,CACF,MAAM,EAAS,EAAQ,CACvB,IAAM,EAAM,KAAK,OAAO,CAClBA,EAAuC,CAC3C,OAAQ,YACR,UAAW,EACX,UAAW,EAAI,SAAS,CAAG,EAAM,SAAS,CAC3C,CAED,OADA,KAAK,cAAc,EAAS,EAAQ,UAAU,CACvC,QACA,EAAO,CACd,IAAM,EAAM,KAAK,OAAO,CAClB,EAAU,aAAiB,MAAQ,EAAM,QAAU,gBACnD,EAAO,EAAiB,EAAM,CAC9BA,EAAuC,CAC3C,OAAQ,QACR,UAAW,EACX,UAAW,EAAI,SAAS,CAAG,EAAM,SAAS,CAC1C,aAAc,EACd,UAAW,EACZ,CAED,OADA,KAAK,cAAc,EAAS,EAAQ,QAAS,EAAM,EAAQ,CACpD,GAIX,cACE,EACA,EACA,EACA,EACA,EACA,CACK,KAAK,WACV,KAAK,UAAU,OAAO,CACpB,SAAU,EAAQ,SAClB,MAAO,EAAQ,MACf,YAAa,EAAQ,YACrB,OAAQ,EAAQ,OAChB,eAAgB,EAAQ,KAAK,KAAK,IAClC,mBAAoB,EAAQ,KAAK,KAAK,QACtC,aAAc,EAAQ,WAAW,KAAK,GACtC,SACA,WAAY,EAAO,UACnB,YACA,eACA,WAAY,EAAO,WAAa,KAAK,OAAO,CAC5C,SAAU,CACR,GAAI,EAAQ,MACR,CACE,UAAW,GAAG,EAAQ,MAAM,cAAc,IAAI,EAAQ,MAAM,mBAC5D,cAAe,EAAQ,MAAM,cAC9B,CACD,EAAE,CACN,OAAQ,EAAO,OAChB,CACF,CAAC,GAIN,SAAS,EAAiB,EAAoC,CAC5D,GAAI,CAAC,GAAS,OAAO,GAAU,SAAU,OACzC,IAAM,EAAY,EACd,KAAU,MAAQ,KACtB,OAAO,OAAO,EAAU,KAAK"}