@connexia/infrastructure 1.0.1

package/dist/shared/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Infrastructure error hierarchy.
+ * Structured errors with codes, categories, severity, and correlation IDs.
+ */
+export type ErrorSeverity = "critical" | "high" | "medium" | "low" | "info";
+export type ErrorCategory = "database" | "cache" | "queue" | "storage" | "search" | "migration" | "connection" | "transaction" | "configuration" | "health" | "recovery" | "security" | "internal";
+export declare class InfrastructureError extends Error {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly timestamp: string;
+    readonly correlationId?: string;
+    readonly retryable: boolean;
+    readonly details?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(message: string, options?: {
+        code?: string;
+        category?: ErrorCategory;
+        severity?: ErrorSeverity;
+        correlationId?: string;
+        retryable?: boolean;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): Record<string, unknown>;
+    withCorrelationId(correlationId: string): this;
+}
+export declare const ERROR_CODES: {
+    readonly DB_CONNECTION_FAILED: "DB_001";
+    readonly DB_QUERY_FAILED: "DB_002";
+    readonly DB_TRANSACTION_FAILED: "DB_003";
+    readonly DB_MIGRATION_FAILED: "DB_004";
+    readonly DB_POOL_EXHAUSTED: "DB_005";
+    readonly DB_SCHEMA_MISMATCH: "DB_006";
+    readonly DB_CONSTRAINT_VIOLATION: "DB_007";
+    readonly CACHE_CONNECTION_FAILED: "CACHE_001";
+    readonly CACHE_OPERATION_FAILED: "CACHE_002";
+    readonly CACHE_KEY_EXPIRED: "CACHE_003";
+    readonly CACHE_KEY_NOT_FOUND: "CACHE_004";
+    readonly QUEUE_CONNECTION_FAILED: "QUEUE_001";
+    readonly QUEUE_JOB_FAILED: "QUEUE_002";
+    readonly QUEUE_WORKER_FAILED: "QUEUE_003";
+    readonly QUEUE_DEAD_LETTER: "QUEUE_004";
+    readonly QUEUE_BACKPRESSURE: "QUEUE_005";
+    readonly STORAGE_WRITE_FAILED: "STORAGE_001";
+    readonly STORAGE_READ_FAILED: "STORAGE_002";
+    readonly STORAGE_DELETE_FAILED: "STORAGE_003";
+    readonly STORAGE_NOT_FOUND: "STORAGE_004";
+    readonly STORAGE_CHECKSUM_MISMATCH: "STORAGE_005";
+    readonly SEARCH_INDEX_FAILED: "SEARCH_001";
+    readonly SEARCH_QUERY_FAILED: "SEARCH_002";
+    readonly MIGRATION_PENDING: "MIG_001";
+    readonly MIGRATION_CONFLICT: "MIG_002";
+    readonly MIGRATION_ROLLBACK_FAILED: "MIG_003";
+    readonly CONNECTION_TIMEOUT: "CONN_001";
+    readonly CONNECTION_REFUSED: "CONN_002";
+    readonly CONNECTION_LOST: "CONN_003";
+    readonly TX_DEADLOCK: "TX_001";
+    readonly TX_SERIALIZATION_FAILED: "TX_002";
+    readonly TX_TIMEOUT: "TX_003";
+    readonly CONFIG_INVALID: "CONFIG_001";
+    readonly CONFIG_SECRET_MISSING: "CONFIG_002";
+    readonly HEALTH_CHECK_FAILED: "HEALTH_001";
+    readonly READINESS_FAILED: "HEALTH_002";
+    readonly LIVENESS_FAILED: "HEALTH_003";
+    readonly RECOVERY_EXHAUSTED: "RECOV_001";
+    readonly CIRCUIT_BREAKER_OPEN: "RECOV_002";
+    readonly SECURITY_SECRET_EXPOSED: "SEC_001";
+    readonly SECURITY_CREDENTIAL_INVALID: "SEC_002";
+    readonly INTERNAL_ERROR: "INTERNAL_001";
+    readonly INTERNAL_ASSERTION_FAILED: "INTERNAL_002";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5E,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,eAAe,GACf,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,CAAC;AAEf,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,KAAK,CAAC;KACV;IAcR,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgBjC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;CAmB/C;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/dist/shared/errors.js

@@ -0,0 +1,110 @@
+/**
+ * Infrastructure error hierarchy.
+ * Structured errors with codes, categories, severity, and correlation IDs.
+ */
+export class InfrastructureError extends Error {
+    code;
+    category;
+    severity;
+    timestamp;
+    correlationId;
+    retryable;
+    details;
+    cause;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = options.code ?? "INTERNAL_001";
+        this.category = options.category ?? "internal";
+        this.severity = options.severity ?? "medium";
+        this.timestamp = new Date().toISOString();
+        this.correlationId = options.correlationId;
+        this.retryable = options.retryable ?? false;
+        this.details = options.details;
+        this.cause = options.cause;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            category: this.category,
+            severity: this.severity,
+            timestamp: this.timestamp,
+            correlationId: this.correlationId,
+            retryable: this.retryable,
+            details: this.details,
+            cause: this.cause?.message,
+            stack: this.stack,
+        };
+    }
+    withCorrelationId(correlationId) {
+        const Constructor = this.constructor;
+        return new Constructor(this.message, {
+            severity: this.severity,
+            correlationId,
+            retryable: this.retryable,
+            details: this.details,
+            cause: this.cause,
+        });
+    }
+}
+export const ERROR_CODES = {
+    // Database
+    DB_CONNECTION_FAILED: "DB_001",
+    DB_QUERY_FAILED: "DB_002",
+    DB_TRANSACTION_FAILED: "DB_003",
+    DB_MIGRATION_FAILED: "DB_004",
+    DB_POOL_EXHAUSTED: "DB_005",
+    DB_SCHEMA_MISMATCH: "DB_006",
+    DB_CONSTRAINT_VIOLATION: "DB_007",
+    // Cache
+    CACHE_CONNECTION_FAILED: "CACHE_001",
+    CACHE_OPERATION_FAILED: "CACHE_002",
+    CACHE_KEY_EXPIRED: "CACHE_003",
+    CACHE_KEY_NOT_FOUND: "CACHE_004",
+    // Queue
+    QUEUE_CONNECTION_FAILED: "QUEUE_001",
+    QUEUE_JOB_FAILED: "QUEUE_002",
+    QUEUE_WORKER_FAILED: "QUEUE_003",
+    QUEUE_DEAD_LETTER: "QUEUE_004",
+    QUEUE_BACKPRESSURE: "QUEUE_005",
+    // Storage
+    STORAGE_WRITE_FAILED: "STORAGE_001",
+    STORAGE_READ_FAILED: "STORAGE_002",
+    STORAGE_DELETE_FAILED: "STORAGE_003",
+    STORAGE_NOT_FOUND: "STORAGE_004",
+    STORAGE_CHECKSUM_MISMATCH: "STORAGE_005",
+    // Search
+    SEARCH_INDEX_FAILED: "SEARCH_001",
+    SEARCH_QUERY_FAILED: "SEARCH_002",
+    // Migration
+    MIGRATION_PENDING: "MIG_001",
+    MIGRATION_CONFLICT: "MIG_002",
+    MIGRATION_ROLLBACK_FAILED: "MIG_003",
+    // Connection
+    CONNECTION_TIMEOUT: "CONN_001",
+    CONNECTION_REFUSED: "CONN_002",
+    CONNECTION_LOST: "CONN_003",
+    // Transaction
+    TX_DEADLOCK: "TX_001",
+    TX_SERIALIZATION_FAILED: "TX_002",
+    TX_TIMEOUT: "TX_003",
+    // Configuration
+    CONFIG_INVALID: "CONFIG_001",
+    CONFIG_SECRET_MISSING: "CONFIG_002",
+    // Health
+    HEALTH_CHECK_FAILED: "HEALTH_001",
+    READINESS_FAILED: "HEALTH_002",
+    LIVENESS_FAILED: "HEALTH_003",
+    // Recovery
+    RECOVERY_EXHAUSTED: "RECOV_001",
+    CIRCUIT_BREAKER_OPEN: "RECOV_002",
+    // Security
+    SECURITY_SECRET_EXPOSED: "SEC_001",
+    SECURITY_CREDENTIAL_INVALID: "SEC_002",
+    // Internal
+    INTERNAL_ERROR: "INTERNAL_001",
+    INTERNAL_ASSERTION_FAILED: "INTERNAL_002",
+};
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

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

package/dist/shared/hashing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deterministic hashing utilities.
+ * Uses SHA-256 for content-addressable identifiers.
+ */
+export declare function sha256(content: string | Buffer): string;
+export declare function sha256Object(obj: unknown): string;
+export declare function deterministicStringify(obj: unknown): string;
+//# sourceMappingURL=hashing.d.ts.map

package/dist/shared/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../src/shared/hashing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE3D"}

package/dist/shared/hashing.js

@@ -0,0 +1,28 @@
+/**
+ * Deterministic hashing utilities.
+ * Uses SHA-256 for content-addressable identifiers.
+ */
+import * as crypto from "node:crypto";
+export function sha256(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+export function sha256Object(obj) {
+    return sha256(deterministicStringify(obj));
+}
+export function deterministicStringify(obj) {
+    return JSON.stringify(obj, deterministicReplacer);
+}
+function deterministicReplacer(_key, value) {
+    if (typeof value === "function" || typeof value === "undefined" || typeof value === "symbol") {
+        return undefined;
+    }
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        const sorted = {};
+        for (const k of Object.keys(value).sort()) {
+            sorted[k] = value[k];
+        }
+        return sorted;
+    }
+    return value;
+}
+//# sourceMappingURL=hashing.js.map

package/dist/shared/hashing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.js","sourceRoot":"","sources":["../../src/shared/hashing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,UAAU,MAAM,CAAC,OAAwB;IAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,KAAc;IACzD,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7F,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACrE,MAAM,CAAC,CAAC,CAAC,GAAI,KAAiC,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared module exports.
+ */
+export { INFRASTRUCTURE_VERSION, INFRASTRUCTURE_NAME, PROVIDER_TYPES, type ProviderType, HEALTH_STATUSES, type HealthStatus, LIFECYCLE_STAGES, type LifecycleStage, DEFAULT_TIMEOUTS, POOL_DEFAULTS, } from "./constants.js";
+export { type Brand, brand, unbrand } from "./branding.js";
+export { sha256, sha256Object, deterministicStringify } from "./hashing.js";
+export { deepEqual } from "./equality.js";
+export { Timer, createTimer, sleep, waitFor } from "./timing.js";
+export type { ProviderId, ConnectionId, TransactionId, MigrationId, ArtifactId, QueueId, JobId, LockId, SessionId, CacheKey, ProviderDescriptor, ProviderManifest, HealthCheckResult, ReadinessCheckResult, LivenessCheckResult, } from "./types.js";
+export { InfrastructureError, ERROR_CODES, type ErrorCode, type ErrorSeverity, type ErrorCategory, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,YAAY,EACjB,gBAAgB,EAChB,KAAK,cAAc,EACnB,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,SAAS,EACT,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,10 @@
+/**
+ * Shared module exports.
+ */
+export { INFRASTRUCTURE_VERSION, INFRASTRUCTURE_NAME, PROVIDER_TYPES, HEALTH_STATUSES, LIFECYCLE_STAGES, DEFAULT_TIMEOUTS, POOL_DEFAULTS, } from "./constants.js";
+export { brand, unbrand } from "./branding.js";
+export { sha256, sha256Object, deterministicStringify } from "./hashing.js";
+export { deepEqual } from "./equality.js";
+export { Timer, createTimer, sleep, waitFor } from "./timing.js";
+export { InfrastructureError, ERROR_CODES, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EAEd,eAAe,EAEf,gBAAgB,EAEhB,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAc,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAkBjE,OAAO,EACL,mBAAmB,EACnB,WAAW,GAIZ,MAAM,aAAa,CAAC"}

package/dist/shared/timing.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Timing utilities for performance measurement and async operations.
+ */
+export declare class Timer {
+    private start;
+    private readonly label;
+    constructor(label: string);
+    elapsedMs(): number;
+    elapsedUs(): number;
+    elapsedNs(): number;
+    getLabel(): string;
+}
+export declare function createTimer(label: string): Timer;
+export declare function sleep(ms: number): Promise<void>;
+export declare function waitFor(condition: () => boolean | Promise<boolean>, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<boolean>;
+//# sourceMappingURL=timing.d.ts.map

package/dist/shared/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/shared/timing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,EAAE,MAAM;IAKzB,SAAS,IAAI,MAAM;IAKnB,SAAS,IAAI,MAAM;IAKnB,SAAS,IAAI,MAAM;IAKnB,QAAQ,IAAI,MAAM;CAGnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEhD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC3C,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/shared/timing.js

@@ -0,0 +1,45 @@
+/**
+ * Timing utilities for performance measurement and async operations.
+ */
+export class Timer {
+    start;
+    label;
+    constructor(label) {
+        this.label = label;
+        this.start = process.hrtime.bigint();
+    }
+    elapsedMs() {
+        const now = process.hrtime.bigint();
+        return Number(now - this.start) / 1_000_000;
+    }
+    elapsedUs() {
+        const now = process.hrtime.bigint();
+        return Number(now - this.start) / 1_000;
+    }
+    elapsedNs() {
+        const now = process.hrtime.bigint();
+        return Number(now - this.start);
+    }
+    getLabel() {
+        return this.label;
+    }
+}
+export function createTimer(label) {
+    return new Timer(label);
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function waitFor(condition, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const intervalMs = options.intervalMs ?? 100;
+    const start = Date.now();
+    while (true) {
+        if (await condition())
+            return true;
+        if (Date.now() - start >= timeoutMs)
+            return false;
+        await sleep(intervalMs);
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/shared/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/shared/timing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,KAAK;IACR,KAAK,CAAS;IACL,KAAK,CAAS;IAE/B,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;IAED,SAAS;QACP,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAC9C,CAAC;IAED,SAAS;QACP,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IAC1C,CAAC;IAED,SAAS;QACP,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAA2C,EAC3C,UAAuD,EAAE;IAEzD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,SAAS,EAAE;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,SAAS;YAAE,OAAO,KAAK,CAAC;QAClD,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/shared/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared type definitions for infrastructure platform.
+ */
+import type { Brand } from "./branding.js";
+import type { HealthStatus, ProviderType } from "./constants.js";
+export type ProviderId = Brand<string, "ProviderId">;
+export type ConnectionId = Brand<string, "ConnectionId">;
+export type TransactionId = Brand<string, "TransactionId">;
+export type MigrationId = Brand<string, "MigrationId">;
+export type ArtifactId = Brand<string, "ArtifactId">;
+export type QueueId = Brand<string, "QueueId">;
+export type JobId = Brand<string, "JobId">;
+export type LockId = Brand<string, "LockId">;
+export type SessionId = Brand<string, "SessionId">;
+export type CacheKey = Brand<string, "CacheKey">;
+export interface ProviderDescriptor {
+    readonly id: ProviderId;
+    readonly type: ProviderType;
+    readonly name: string;
+    readonly version: string;
+    readonly capabilities: readonly string[];
+    readonly dependencies: readonly ProviderId[];
+    readonly config: Record<string, unknown>;
+    readonly connect?: () => Promise<void>;
+    readonly disconnect?: () => Promise<void>;
+    readonly healthCheck?: () => Promise<HealthStatus>;
+}
+export interface ProviderManifest {
+    readonly id: ProviderId;
+    readonly type: ProviderType;
+    readonly name: string;
+    readonly version: string;
+    readonly capabilities: readonly string[];
+    readonly dependencies: readonly ProviderId[];
+    readonly configChecksum: string;
+    readonly startupTime: string;
+    readonly healthEndpoint?: string;
+    readonly metricsEndpoint?: string;
+    readonly startupDurationMs?: number;
+    readonly retryCount?: number;
+    readonly failureCount?: number;
+    readonly resourceCount?: number;
+    readonly doctorStatus?: HealthStatus;
+    readonly uptimeMs?: number;
+}
+export interface HealthCheckResult {
+    readonly status: HealthStatus;
+    readonly latencyMs: number;
+    readonly message?: string;
+    readonly details?: Record<string, unknown>;
+    readonly checkedAt: string;
+}
+export interface ReadinessCheckResult extends HealthCheckResult {
+    readonly dependencies: ReadonlyArray<{
+        readonly id: ProviderId;
+        readonly status: HealthStatus;
+    }>;
+}
+export interface LivenessCheckResult extends HealthCheckResult {
+    readonly uptimeMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

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

package/dist/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared type definitions for infrastructure platform.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@connexia/infrastructure",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@connexia/domain": "^1.0.0",
+    "zod": "^3.23.8",
+    "drizzle-orm": "^0.33.0",
+    "pg": "^8.13.0",
+    "ioredis": "^5.4.0",
+    "bullmq": "^5.0.0",
+    "pino": "^9.0.0",
+    "pino-pretty": "^11.0.0",
+    "@opentelemetry/api": "^1.8.0",
+    "ulid": "^2.3.0",
+    "neverthrow": "^7.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.0",
+    "@types/pg": "^8.11.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.1.1",
+    "drizzle-kit": "^0.24.0",
+    "tsx": "^4.19.0",
+    "@vitest/coverage-v8": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "description": "Infrastructure utilities and database access for Connexia",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/connexia/connexia.git",
+    "directory": "packages/infrastructure"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/connexia/connexia/tree/main/packages/infrastructure",
+  "bugs": {
+    "url": "https://github.com/connexia/connexia/issues"
+  },
+  "keywords": [
+    "Connexia",
+    "mcp",
+    "ai",
+    "infrastructure",
+    "database",
+    "postgres",
+    "redis"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "migrate:up": "tsx src/database/drizzle/migrate.ts up",
+    "migrate:down": "tsx src/database/drizzle/migrate.ts down",
+    "migrate:generate": "tsx src/database/drizzle/migrate.ts generate",
+    "db:studio": "drizzle-kit studio"
+  }
+}