dominus-sdk-nodejs-staging 1.2.4

package/dist/index.d.ts

@@ -0,0 +1,191 @@
+/**
+ * CB Dominus SDK for Node.js
+ *
+ * Ultra-flat async SDK for CareBridge Services.
+ *
+ * Usage:
+ *     import { dominus } from 'dominus-sdk-nodejs';
+ *
+ *     // Secrets (root-level shortcuts)
+ *     const value = await dominus.get("DB_URL");
+ *     await dominus.upsert("KEY", "value");
+ *
+ *     // Database (root-level shortcuts)
+ *     const tables = await dominus.listTables();
+ *     const users = await dominus.queryTable("users", { filters: { status: "active" } });
+ *     await dominus.insertRow("users", { name: "John" });
+ *
+ *     // Secure table access (with audit logging)
+ *     const patients = await dominus.secure.query("patients", {
+ *       reason: "Reviewing chart for appointment #123",
+ *       actor: userId
+ *     });
+ *
+ *     // Database (namespace)
+ *     const tables = await dominus.db.tables();
+ *     const users = await dominus.db.query("users", { filters: { status: "active" } });
+ *
+ *     // Redis
+ *     await dominus.redis.set("key", "value", { ttl: 3600 });
+ *     const cached = await dominus.redis.get("key");
+ *
+ *     // Files
+ *     const result = await dominus.files.upload(buffer, "report.pdf", { category: "reports" });
+ *     const download = await dominus.files.download({ id: result.id });
+ *
+ *     // Auth
+ *     const users = await dominus.auth.listUsers();
+ *     await dominus.auth.createUser({ username: "john", email: "j@ex.com", password: "secret" });
+ *
+ *     // DDL
+ *     await dominus.ddl.createTable("orders", [{ name: "id", type: "UUID" }]);
+ *
+ *     // Logs
+ *     await dominus.logs.info("User logged in", { user_id: "123" });
+ *
+ *     // Portal
+ *     const session = await dominus.portal.login("user@example.com", "password", "tenant-id");
+ *
+ *     // Courier
+ *     await dominus.courier.sendWelcome("user@example.com", "noreply@app.com", { name: "John", productName: "MyApp" });
+ *
+ *     // Open
+ *     const dsn = await dominus.open.dsn();
+ *
+ *     // Health
+ *     const status = await dominus.health.check();
+ *
+ *     // Crypto helpers
+ *     import { hashPassword, hashPsk, generateToken } from 'dominus-sdk-nodejs';
+ *     const hashed = hashPassword("secret");
+ *
+ * Configuration:
+ *     Set DOMINUS_TOKEN environment variable with your PSK token.
+ */
+import { SecretsNamespace } from './namespaces/secrets.js';
+import { DbNamespace, QueryOptions, QueryResult } from './namespaces/db.js';
+import { RedisNamespace } from './namespaces/redis.js';
+import { FilesNamespace } from './namespaces/files.js';
+import { AuthNamespace } from './namespaces/auth.js';
+import { DdlNamespace, ColumnDefinition } from './namespaces/ddl.js';
+import { LogsNamespace } from './namespaces/logs.js';
+import { PortalNamespace } from './namespaces/portal.js';
+import { CourierNamespace } from './namespaces/courier.js';
+import { OpenNamespace } from './namespaces/open.js';
+import { HealthNamespace } from './namespaces/health.js';
+import { SecureNamespace } from './namespaces/secure.js';
+export { DominusError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, ConflictError, ServiceError, ConnectionError, TimeoutError, SecureTableError, } from './lib/errors.js';
+export { hashPassword, verifyPasswordLocal, hashPsk, verifyPskLocal, generatePskLocal, hashToken, generateToken, } from './lib/crypto.js';
+export { CircuitBreaker, DominusCache, exponentialBackoffWithJitter, dominusCache, orchestratorCircuitBreaker, } from './lib/cache.js';
+export type { DominusClient } from './lib/client.js';
+export type { Secret, UpsertResult } from './namespaces/secrets.js';
+export type { QueryOptions, QueryResult, TableInfo, ColumnInfo } from './namespaces/db.js';
+export type { SetResult, GetResult, ListResult as RedisListResult, SetnxResult, IncrResult, HsetResult, HgetallResult } from './namespaces/redis.js';
+export type { UploadResult, DownloadResult, FetchResult, ListResult, FileInfo } from './namespaces/files.js';
+export type { ColumnDefinition } from './namespaces/ddl.js';
+export type { LogContext, LogEntry, BatchResult } from './namespaces/logs.js';
+export type { Session } from './namespaces/portal.js';
+export type { SendResult } from './namespaces/courier.js';
+export type { HealthStatus } from './namespaces/health.js';
+export type { SecureQueryOptions, SecureAccessContext } from './namespaces/secure.js';
+/**
+ * Main Dominus SDK class.
+ *
+ * Provides namespace-based access to all Dominus services,
+ * plus root-level shortcuts for common operations.
+ */
+export declare class Dominus {
+    private _client;
+    /** Secrets management (Warden) */
+    readonly secrets: SecretsNamespace;
+    /** Database CRUD operations (Scribe) */
+    readonly db: DbNamespace;
+    /** Secure table operations with audit logging */
+    readonly secure: SecureNamespace;
+    /** Redis caching operations (Whisperer) */
+    readonly redis: RedisNamespace;
+    /** File storage operations (Archivist) */
+    readonly files: FilesNamespace;
+    /** Authentication & authorization (Guardian) */
+    readonly auth: AuthNamespace;
+    /** Schema DDL & migrations (Smith) */
+    readonly ddl: DdlNamespace;
+    /** Structured logging (Herald) */
+    readonly logs: LogsNamespace;
+    /** User authentication & sessions (Portal) */
+    readonly portal: PortalNamespace;
+    /** Email delivery (Courier) */
+    readonly courier: CourierNamespace;
+    /** Direct database access (Scribe Open) */
+    readonly open: OpenNamespace;
+    /** Health checks */
+    readonly health: HealthNamespace;
+    constructor();
+    /**
+     * Get a secret value (shortcut for dominus.secrets.get).
+     */
+    get(key: string): Promise<unknown>;
+    /**
+     * Create or update a secret (shortcut for dominus.secrets.upsert).
+     */
+    upsert(key: string, value: string, comment?: string): Promise<import("./namespaces/secrets.js").UpsertResult>;
+    /**
+     * List tables in a schema (shortcut for dominus.db.tables).
+     */
+    listTables(schema?: string): Promise<import("./namespaces/db.js").TableInfo[]>;
+    /**
+     * Query table data (shortcut for dominus.db.query).
+     */
+    queryTable(table: string, options?: QueryOptions): Promise<QueryResult>;
+    /**
+     * Insert a row (shortcut for dominus.db.insert).
+     */
+    insertRow(table: string, data: Record<string, unknown>, options?: {
+        schema?: string;
+        reason?: string;
+        actor?: string;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Update rows (shortcut for dominus.db.update).
+     */
+    updateRows(table: string, data: Record<string, unknown>, filters: Record<string, unknown>, options?: {
+        schema?: string;
+        reason?: string;
+        actor?: string;
+    }): Promise<{
+        affected_rows: number;
+    }>;
+    /**
+     * Delete rows (shortcut for dominus.db.delete).
+     */
+    deleteRows(table: string, filters: Record<string, unknown>, options?: {
+        schema?: string;
+        reason?: string;
+        actor?: string;
+    }): Promise<{
+        affected_rows: number;
+    }>;
+    /**
+     * List columns in a table (shortcut for dominus.db.columns).
+     */
+    listColumns(table: string, schema?: string): Promise<import("./namespaces/db.js").ColumnInfo[]>;
+    /**
+     * Create a table (shortcut for dominus.ddl.createTable).
+     */
+    addTable(tableName: string, columns: ColumnDefinition[], schema?: string): Promise<Record<string, unknown>>;
+    /**
+     * Drop a table (shortcut for dominus.ddl.dropTable).
+     */
+    deleteTable(tableName: string, schema?: string): Promise<Record<string, unknown>>;
+    /**
+     * Add a column to a table (shortcut for dominus.ddl.addColumn).
+     */
+    addColumn(tableName: string, column: ColumnDefinition, schema?: string): Promise<Record<string, unknown>>;
+    /**
+     * Drop a column from a table (shortcut for dominus.ddl.dropColumn).
+     */
+    deleteColumn(tableName: string, columnName: string, schema?: string): Promise<Record<string, unknown>>;
+}
+export declare const dominus: Dominus;
+export default dominus;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,224 @@
+/**
+ * CB Dominus SDK for Node.js
+ *
+ * Ultra-flat async SDK for CareBridge Services.
+ *
+ * Usage:
+ *     import { dominus } from 'dominus-sdk-nodejs';
+ *
+ *     // Secrets (root-level shortcuts)
+ *     const value = await dominus.get("DB_URL");
+ *     await dominus.upsert("KEY", "value");
+ *
+ *     // Database (root-level shortcuts)
+ *     const tables = await dominus.listTables();
+ *     const users = await dominus.queryTable("users", { filters: { status: "active" } });
+ *     await dominus.insertRow("users", { name: "John" });
+ *
+ *     // Secure table access (with audit logging)
+ *     const patients = await dominus.secure.query("patients", {
+ *       reason: "Reviewing chart for appointment #123",
+ *       actor: userId
+ *     });
+ *
+ *     // Database (namespace)
+ *     const tables = await dominus.db.tables();
+ *     const users = await dominus.db.query("users", { filters: { status: "active" } });
+ *
+ *     // Redis
+ *     await dominus.redis.set("key", "value", { ttl: 3600 });
+ *     const cached = await dominus.redis.get("key");
+ *
+ *     // Files
+ *     const result = await dominus.files.upload(buffer, "report.pdf", { category: "reports" });
+ *     const download = await dominus.files.download({ id: result.id });
+ *
+ *     // Auth
+ *     const users = await dominus.auth.listUsers();
+ *     await dominus.auth.createUser({ username: "john", email: "j@ex.com", password: "secret" });
+ *
+ *     // DDL
+ *     await dominus.ddl.createTable("orders", [{ name: "id", type: "UUID" }]);
+ *
+ *     // Logs
+ *     await dominus.logs.info("User logged in", { user_id: "123" });
+ *
+ *     // Portal
+ *     const session = await dominus.portal.login("user@example.com", "password", "tenant-id");
+ *
+ *     // Courier
+ *     await dominus.courier.sendWelcome("user@example.com", "noreply@app.com", { name: "John", productName: "MyApp" });
+ *
+ *     // Open
+ *     const dsn = await dominus.open.dsn();
+ *
+ *     // Health
+ *     const status = await dominus.health.check();
+ *
+ *     // Crypto helpers
+ *     import { hashPassword, hashPsk, generateToken } from 'dominus-sdk-nodejs';
+ *     const hashed = hashPassword("secret");
+ *
+ * Configuration:
+ *     Set DOMINUS_TOKEN environment variable with your PSK token.
+ */
+import { getClient } from './lib/client.js';
+import { SecretsNamespace } from './namespaces/secrets.js';
+import { DbNamespace } from './namespaces/db.js';
+import { RedisNamespace } from './namespaces/redis.js';
+import { FilesNamespace } from './namespaces/files.js';
+import { AuthNamespace } from './namespaces/auth.js';
+import { DdlNamespace } from './namespaces/ddl.js';
+import { LogsNamespace } from './namespaces/logs.js';
+import { PortalNamespace } from './namespaces/portal.js';
+import { CourierNamespace } from './namespaces/courier.js';
+import { OpenNamespace } from './namespaces/open.js';
+import { HealthNamespace } from './namespaces/health.js';
+import { SecureNamespace } from './namespaces/secure.js';
+// Initialize cache with token for encryption
+import { dominusCache } from './lib/cache.js';
+const token = process.env.DOMINUS_TOKEN;
+if (token) {
+    dominusCache.setEncryptionKey(token);
+}
+// Re-export errors for consumers
+export { DominusError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, ConflictError, ServiceError, ConnectionError, TimeoutError, SecureTableError, } from './lib/errors.js';
+// Re-export crypto helpers for consumers
+export { hashPassword, verifyPasswordLocal, hashPsk, verifyPskLocal, generatePskLocal, hashToken, generateToken, } from './lib/crypto.js';
+// Re-export cache utilities (internal but useful)
+export { CircuitBreaker, DominusCache, exponentialBackoffWithJitter, dominusCache, orchestratorCircuitBreaker, } from './lib/cache.js';
+/**
+ * Main Dominus SDK class.
+ *
+ * Provides namespace-based access to all Dominus services,
+ * plus root-level shortcuts for common operations.
+ */
+export class Dominus {
+    _client;
+    /** Secrets management (Warden) */
+    secrets;
+    /** Database CRUD operations (Scribe) */
+    db;
+    /** Secure table operations with audit logging */
+    secure;
+    /** Redis caching operations (Whisperer) */
+    redis;
+    /** File storage operations (Archivist) */
+    files;
+    /** Authentication & authorization (Guardian) */
+    auth;
+    /** Schema DDL & migrations (Smith) */
+    ddl;
+    /** Structured logging (Herald) */
+    logs;
+    /** User authentication & sessions (Portal) */
+    portal;
+    /** Email delivery (Courier) */
+    courier;
+    /** Direct database access (Scribe Open) */
+    open;
+    /** Health checks */
+    health;
+    constructor() {
+        this._client = getClient();
+        // Initialize all namespaces
+        this.secrets = new SecretsNamespace(this._client);
+        this.db = new DbNamespace(this._client);
+        this.secure = new SecureNamespace(this._client);
+        this.redis = new RedisNamespace(this._client);
+        this.files = new FilesNamespace(this._client);
+        this.auth = new AuthNamespace(this._client);
+        this.ddl = new DdlNamespace(this._client);
+        this.logs = new LogsNamespace(this._client);
+        this.portal = new PortalNamespace(this._client);
+        this.courier = new CourierNamespace(this._client);
+        this.open = new OpenNamespace(this._client);
+        this.health = new HealthNamespace(this._client);
+    }
+    // ========================================
+    // ROOT-LEVEL SHORTCUTS - SECRETS
+    // ========================================
+    /**
+     * Get a secret value (shortcut for dominus.secrets.get).
+     */
+    async get(key) {
+        return this.secrets.get(key);
+    }
+    /**
+     * Create or update a secret (shortcut for dominus.secrets.upsert).
+     */
+    async upsert(key, value, comment) {
+        return this.secrets.upsert(key, value, comment);
+    }
+    // ========================================
+    // ROOT-LEVEL SHORTCUTS - DATABASE
+    // ========================================
+    /**
+     * List tables in a schema (shortcut for dominus.db.tables).
+     */
+    async listTables(schema = 'public') {
+        return this.db.tables(schema);
+    }
+    /**
+     * Query table data (shortcut for dominus.db.query).
+     */
+    async queryTable(table, options) {
+        return this.db.query(table, options);
+    }
+    /**
+     * Insert a row (shortcut for dominus.db.insert).
+     */
+    async insertRow(table, data, options) {
+        return this.db.insert(table, data, options);
+    }
+    /**
+     * Update rows (shortcut for dominus.db.update).
+     */
+    async updateRows(table, data, filters, options) {
+        return this.db.update(table, data, filters, options);
+    }
+    /**
+     * Delete rows (shortcut for dominus.db.delete).
+     */
+    async deleteRows(table, filters, options) {
+        return this.db.delete(table, filters, options);
+    }
+    /**
+     * List columns in a table (shortcut for dominus.db.columns).
+     */
+    async listColumns(table, schema = 'public') {
+        return this.db.columns(table, schema);
+    }
+    // ========================================
+    // ROOT-LEVEL SHORTCUTS - DDL
+    // ========================================
+    /**
+     * Create a table (shortcut for dominus.ddl.createTable).
+     */
+    async addTable(tableName, columns, schema = 'public') {
+        return this.ddl.createTable(tableName, columns, schema);
+    }
+    /**
+     * Drop a table (shortcut for dominus.ddl.dropTable).
+     */
+    async deleteTable(tableName, schema = 'public') {
+        return this.ddl.dropTable(tableName, schema);
+    }
+    /**
+     * Add a column to a table (shortcut for dominus.ddl.addColumn).
+     */
+    async addColumn(tableName, column, schema = 'public') {
+        return this.ddl.addColumn(tableName, column, schema);
+    }
+    /**
+     * Drop a column from a table (shortcut for dominus.ddl.dropColumn).
+     */
+    async deleteColumn(tableName, columnName, schema = 'public') {
+        return this.ddl.dropColumn(tableName, columnName, schema);
+    }
+}
+// Create and export singleton instance
+export const dominus = new Dominus();
+// Default export for ESM compatibility
+export default dominus;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,OAAO,EAAE,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAA6B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,6CAA6C;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AACxC,IAAI,KAAK,EAAE,CAAC;IACV,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,iCAAiC;AACjC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,yCAAyC;AACzC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,kDAAkD;AAClD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,4BAA4B,EAC5B,YAAY,EACZ,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAexB;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IACV,OAAO,CAAgB;IAE/B,kCAAkC;IAClB,OAAO,CAAmB;IAE1C,wCAAwC;IACxB,EAAE,CAAc;IAEhC,iDAAiD;IACjC,MAAM,CAAkB;IAExC,2CAA2C;IAC3B,KAAK,CAAiB;IAEtC,0CAA0C;IAC1B,KAAK,CAAiB;IAEtC,gDAAgD;IAChC,IAAI,CAAgB;IAEpC,sCAAsC;IACtB,GAAG,CAAe;IAElC,kCAAkC;IAClB,IAAI,CAAgB;IAEpC,8CAA8C;IAC9B,MAAM,CAAkB;IAExC,+BAA+B;IACf,OAAO,CAAmB;IAE1C,2CAA2C;IAC3B,IAAI,CAAgB;IAEpC,oBAAoB;IACJ,MAAM,CAAkB;IAExC;QACE,IAAI,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC;QAE3B,4BAA4B;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,EAAE,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,2CAA2C;IAC3C,iCAAiC;IACjC,2CAA2C;IAE3C;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAa,EAAE,OAAgB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,2CAA2C;IAC3C,kCAAkC;IAClC,2CAA2C;IAE3C;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,QAAQ;QAChC,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAAsB;QACpD,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,KAAa,EACb,IAA6B,EAC7B,OAA8D;QAE9D,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,KAAa,EACb,IAA6B,EAC7B,OAAgC,EAChC,OAA8D;QAE9D,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,KAAa,EACb,OAAgC,EAChC,OAA8D;QAE9D,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,MAAM,GAAG,QAAQ;QAChD,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,2CAA2C;IAC3C,6BAA6B;IAC7B,2CAA2C;IAE3C;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,OAA2B,EAAE,MAAM,GAAG,QAAQ;QAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,MAAM,GAAG,QAAQ;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,MAAwB,EACxB,MAAM,GAAG,QAAQ;QAEjB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,UAAkB,EAAE,MAAM,GAAG,QAAQ;QACzE,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,uCAAuC;AACvC,eAAe,OAAO,CAAC"}

package/dist/lib/cache.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Internal cache with automatic encryption and circuit breaker.
+ *
+ * NOT exposed to SDK users - internal use only.
+ */
+/**
+ * Circuit breaker states.
+ */
+declare enum CircuitState {
+    CLOSED = "closed",
+    OPEN = "open",
+    HALF_OPEN = "half_open"
+}
+/**
+ * Simple circuit breaker to prevent runaway retries.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Too many failures, requests blocked
+ * - HALF_OPEN: Testing if service recovered
+ *
+ * Prevents CPU/quota exhaustion from retry storms.
+ */
+export declare class CircuitBreaker {
+    private failureThreshold;
+    private recoveryTimeout;
+    private halfOpenMaxCalls;
+    private failureCount;
+    private state;
+    private lastFailureTime;
+    private halfOpenCalls;
+    constructor(failureThreshold?: number, recoveryTimeout?: number, // 30 seconds in ms
+    halfOpenMaxCalls?: number);
+    /**
+     * Get current state, transitioning OPEN→HALF_OPEN if timeout elapsed.
+     */
+    getState(): CircuitState;
+    /**
+     * Check if a request can be executed.
+     */
+    canExecute(): boolean;
+    /**
+     * Record a successful call.
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed call.
+     */
+    recordFailure(): void;
+    /**
+     * Record a call attempt in HALF_OPEN state.
+     */
+    recordHalfOpenCall(): void;
+    /**
+     * Reset the circuit breaker.
+     */
+    reset(): void;
+}
+/**
+ * Calculate backoff delay with jitter to prevent thundering herd.
+ *
+ * @param attempt - Zero-based attempt number
+ * @param baseDelay - Base delay in milliseconds
+ * @param maxDelay - Maximum delay cap
+ * @param jitter - Jitter factor (0-1), adds randomness
+ * @returns Delay in milliseconds
+ */
+export declare function exponentialBackoffWithJitter(attempt: number, baseDelay?: number, maxDelay?: number, jitter?: number): number;
+/**
+ * Internal process-local cache with auto-encryption.
+ *
+ * Used by dominus services only:
+ * - Validation state
+ * - Service URLs
+ * - API responses
+ *
+ * NOT accessible by SDK users.
+ */
+export declare class DominusCache {
+    private defaultTtl;
+    private store;
+    private cipher;
+    constructor(defaultTtl?: number);
+    /**
+     * Initialize encryption using auth token.
+     */
+    setEncryptionKey(token: string): void;
+    /**
+     * Get and decrypt, refresh TTL.
+     */
+    get<T = unknown>(key: string): T | null;
+    /**
+     * Encrypt and store.
+     */
+    set<T = unknown>(key: string, value: T, ttl?: number): void;
+    /**
+     * Delete key.
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all.
+     */
+    clear(): number;
+    /**
+     * Get cache size.
+     */
+    size(): number;
+}
+export declare const dominusCache: DominusCache;
+export declare const orchestratorCircuitBreaker: CircuitBreaker;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/lib/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,aAAK,YAAY;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IAOvB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,gBAAgB;IAR1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAK;gBAGhB,gBAAgB,SAAI,EACpB,eAAe,SAAQ,EAAE,mBAAmB;IAC5C,gBAAgB,SAAI;IAG9B;;OAEG;IACH,QAAQ,IAAI,YAAY;IAUxB;;OAEG;IACH,UAAU,IAAI,OAAO;IAWrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAQrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAYrB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,SAAO,EAChB,QAAQ,SAAQ,EAChB,MAAM,SAAM,GACX,MAAM,CAIR;AAOD;;;;;;;;;GASG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,UAAU;IAH9B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,MAAM,CAAmD;gBAE7C,UAAU,SAAS;IAEvC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrC;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA4CvC;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IA+B3D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,MAAM;IAMf;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAGD,eAAO,MAAM,YAAY,cAA2B,CAAC;AAGrD,eAAO,MAAM,0BAA0B,gBAItC,CAAC"}