@contractspec/lib.contracts-integrations 2.0.0

package/dist/integrations/providers/powens.js

@@ -0,0 +1,124 @@
+// @bun
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/powens.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var powensIntegrationSpec = defineIntegration({
+  meta: {
+    key: "openbanking.powens",
+    version: "1.0.0",
+    category: "open-banking",
+    title: "Powens Open Banking (Read)",
+    description: "Read-only Open Banking integration powered by Powens, exposing accounts, transactions, and balances.",
+    domain: "finance",
+    owners: ["platform.finance"],
+    tags: ["open-banking", "powens", "finance"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [
+      { key: "openbanking.accounts.read", version: "1.0.0" },
+      { key: "openbanking.transactions.read", version: "1.0.0" },
+      { key: "openbanking.balances.read", version: "1.0.0" }
+    ]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      required: ["environment"],
+      properties: {
+        environment: {
+          type: "string",
+          enum: ["sandbox", "production"],
+          description: "Powens environment to target. Sandbox uses Powens test API base URL, production uses live endpoints."
+        },
+        baseUrl: {
+          type: "string",
+          description: "Optional override for the Powens API base URL. Defaults to Powens environment defaults."
+        },
+        region: {
+          type: "string",
+          description: "Optional Powens region identifier when targeting a specific data residency cluster."
+        },
+        pollingIntervalMs: {
+          type: "number",
+          description: "Optional custom polling interval in milliseconds for background sync jobs (defaults to platform standard)."
+        }
+      }
+    },
+    example: {
+      environment: "sandbox",
+      baseUrl: "https://api-sandbox.powens.com/v2",
+      region: "eu-west-1",
+      pollingIntervalMs: 300000
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["clientId", "clientSecret"],
+      properties: {
+        clientId: {
+          type: "string",
+          description: "Powens OAuth client identifier obtained from the Powens Console (BYOK project)."
+        },
+        clientSecret: {
+          type: "string",
+          description: "Powens OAuth client secret used to exchange for access tokens."
+        },
+        apiKey: {
+          type: "string",
+          description: "Optional Powens API key (if the tenant project exposes a dedicated API token)."
+        },
+        webhookSecret: {
+          type: "string",
+          description: "Optional webhook signing secret used to verify Powens webhook payloads."
+        }
+      }
+    },
+    example: {
+      clientId: "powens-client-id",
+      clientSecret: "powens-client-secret",
+      apiKey: "powens-api-key",
+      webhookSecret: "powens-webhook-secret"
+    }
+  },
+  healthCheck: {
+    method: "ping",
+    timeoutMs: 8000
+  },
+  docsUrl: "https://docs.powens.com/",
+  constraints: {
+    rateLimit: {
+      rph: 1e4,
+      rpm: 600
+    }
+  },
+  byokSetup: {
+    setupInstructions: "Create a Powens BYOK project, generate OAuth credentials, and optionally configure webhook delivery for account/transaction updates.",
+    requiredScopes: ["accounts:read", "transactions:read", "balances:read"]
+  }
+});
+function registerPowensIntegration(registry) {
+  return registry.register(powensIntegrationSpec);
+}
+export {
+  registerPowensIntegration,
+  powensIntegrationSpec
+};

package/dist/integrations/providers/project-management.d.ts

@@ -0,0 +1,32 @@
+export type ProjectManagementWorkItemPriority = 'urgent' | 'high' | 'medium' | 'low' | 'none';
+export type ProjectManagementWorkItemType = 'task' | 'bug' | 'story' | 'epic' | 'summary';
+export interface ProjectManagementWorkItemInput {
+    title: string;
+    description?: string;
+    type?: ProjectManagementWorkItemType;
+    status?: string;
+    priority?: ProjectManagementWorkItemPriority;
+    tags?: string[];
+    assigneeId?: string;
+    projectId?: string;
+    parentId?: string;
+    dueDate?: Date;
+    estimate?: number;
+    externalId?: string;
+    metadata?: Record<string, string>;
+}
+export interface ProjectManagementWorkItem {
+    id: string;
+    title: string;
+    url?: string;
+    status?: string;
+    priority?: ProjectManagementWorkItemPriority;
+    tags?: string[];
+    projectId?: string;
+    externalId?: string;
+    metadata?: Record<string, string>;
+}
+export interface ProjectManagementProvider {
+    createWorkItem(input: ProjectManagementWorkItemInput): Promise<ProjectManagementWorkItem>;
+    createWorkItems(items: ProjectManagementWorkItemInput[]): Promise<ProjectManagementWorkItem[]>;
+}

package/dist/integrations/providers/project-management.js

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

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

@@ -0,0 +1 @@
+export {};

package/dist/integrations/providers/qdrant.d.ts

@@ -0,0 +1,3 @@
+import { IntegrationSpecRegistry } from '../spec';
+export declare const qdrantIntegrationSpec: import("..").IntegrationSpec;
+export declare function registerQdrantIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;

package/dist/integrations/providers/qdrant.js

@@ -0,0 +1,101 @@
+// @bun
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/qdrant.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var qdrantIntegrationSpec = defineIntegration({
+  meta: {
+    key: "vectordb.qdrant",
+    version: "1.0.0",
+    category: "vector-db",
+    title: "Qdrant Vector Database",
+    description: "Qdrant integration for vector search and embeddings storage.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["vector-db", "search"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["managed", "byok"],
+  capabilities: {
+    provides: [
+      { key: "vector-db.search", version: "1.0.0" },
+      { key: "vector-db.storage", version: "1.0.0" }
+    ],
+    requires: [
+      {
+        key: "ai.embeddings",
+        optional: true,
+        reason: "Required if vectors are generated via hosted embedding services"
+      }
+    ]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        apiUrl: {
+          type: "string",
+          description: "Base URL for the Qdrant instance (e.g., https://qdrant.example.com)."
+        },
+        collectionPrefix: {
+          type: "string",
+          description: "Prefix applied to all collection names for this tenant."
+        }
+      }
+    },
+    example: {
+      apiUrl: "https://qdrant.example.com",
+      collectionPrefix: "tenant_"
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "API key or token when authentication is enabled."
+        }
+      }
+    },
+    example: {
+      apiKey: "qdrant-api-key"
+    }
+  },
+  healthCheck: {
+    method: "ping",
+    timeoutMs: 4000
+  },
+  docsUrl: "https://qdrant.tech/documentation/quick-start/",
+  constraints: {
+    quotas: {
+      collections: 100,
+      pointsPerCollection: 1e6
+    }
+  },
+  byokSetup: {
+    setupInstructions: "Provide the HTTPS endpoint of your Qdrant cluster and generate an API key with read/write access to the collections that will be managed."
+  }
+});
+function registerQdrantIntegration(registry) {
+  return registry.register(qdrantIntegrationSpec);
+}
+export {
+  registerQdrantIntegration,
+  qdrantIntegrationSpec
+};

package/dist/integrations/providers/registry.d.ts

@@ -0,0 +1,6 @@
+import { IntegrationSpecRegistry } from '../spec';
+/**
+ * Creates a registry containing all IntegrationSpec providers shipped by
+ * `@contractspec/lib.contracts-spec`.
+ */
+export declare function createDefaultIntegrationSpecRegistry(): IntegrationSpecRegistry;