@cogenta/core 0.1.0

package/dist/queue/database.js.map

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

package/dist/queue/index.d.ts

@@ -0,0 +1,7 @@
+export type { BullmqModule, BullmqQueueDriverOptions, BullmqQueueOptions } from './bullmq.js';
+export { bullmqQueueDriver, createBullmqQueue, loadBullmqModule } from './bullmq.js';
+export type { DatabaseQueueOptions } from './database.js';
+export { createDatabaseQueue } from './database.js';
+export type { EnqueueOptions, Job, JobHandler, JobId, JobState, JobStatus, QueueConfig, QueueDriver, QueueDriverOptions, } from './types.js';
+export { JOB_STATUSES } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACpF,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,YAAY,EACV,cAAc,EACd,GAAG,EACH,UAAU,EACV,KAAK,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/queue/index.js

@@ -0,0 +1,4 @@
+export { bullmqQueueDriver, createBullmqQueue, loadBullmqModule } from './bullmq.js';
+export { createDatabaseQueue } from './database.js';
+export { JOB_STATUSES } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAYnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/queue/types.d.ts

@@ -0,0 +1,61 @@
+export type JobId = string;
+export declare const JOB_STATUSES: readonly ['pending', 'running', 'completed', 'failed', 'cancelled'];
+export type JobStatus = (typeof JOB_STATUSES)[number];
+export interface EnqueueOptions {
+    readonly name: string;
+    readonly payload?: unknown;
+    /** Epoch milliseconds. A job is invisible until then. */
+    readonly runAt?: number;
+    /** Higher runs first. Ties break by `runAt`, then by insertion order. */
+    readonly priority?: number;
+    readonly maxAttempts?: number;
+}
+export interface Job<TPayload = unknown> {
+    readonly id: JobId;
+    readonly name: string;
+    readonly payload: TPayload;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+}
+export interface JobState {
+    readonly id: JobId;
+    readonly name: string;
+    readonly status: JobStatus;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly runAt: number;
+    readonly lastError: string | undefined;
+}
+export type JobHandler<TPayload = unknown> = (job: Job<TPayload>) => Promise<void>;
+export interface QueueDriver {
+    enqueue(options: EnqueueOptions): Promise<JobId>;
+    /** Registers the handler for a job name. One handler per name. */
+    process<TPayload = unknown>(name: string, handler: JobHandler<TPayload>): void;
+    /**
+     * Runs one batch of due jobs and returns how many were handled.
+     *
+     * The degraded driver has no worker of its own: something has to call this —
+     * a system cron on shared hosting, a loop in a long-lived process elsewhere.
+     * That is why it is on the interface rather than hidden inside a driver.
+     */
+    tick(): Promise<number>;
+    cancel(id: JobId): Promise<void>;
+    status(id: JobId): Promise<JobState | null>;
+    close(): Promise<void>;
+}
+export interface QueueConfig {
+    readonly driver?: string;
+    readonly url?: string | undefined;
+}
+export interface QueueDriverOptions {
+    /** Injected so scheduling and lease expiry are testable without waiting. */
+    readonly now?: () => number;
+    /**
+     * How long a claimed job may run before another worker may take it over.
+     * A worker that is killed mid-job must not hold its job forever.
+     */
+    readonly leaseMs?: number;
+    /** Jobs claimed per `tick`. */
+    readonly batchSize?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAA;AAE1B,eAAO,MAAM,YAAY,YAAI,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAA;AAE/F,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,GAAG,CAAC,QAAQ,GAAG,OAAO;IACrC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CACvC;AAED,MAAM,MAAM,UAAU,CAAC,QAAQ,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAElF,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAChD,kEAAkE;IAClE,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAA;IAC9E;;;;;;OAMG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACvB,MAAM,CAAC,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B"}

package/dist/queue/types.js

@@ -0,0 +1,2 @@
+export const JOB_STATUSES = ['pending', 'running', 'completed', 'failed', 'cancelled'];
+//# sourceMappingURL=types.js.map

package/dist/queue/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAA"}

package/dist/storage/index.d.ts

@@ -0,0 +1,14 @@
+import { type DriverRegistry } from '../drivers/index.js';
+import type { Logger } from '../logger/index.js';
+import type { StorageConfig, StorageDriver, StorageDriverOptions } from './types.js';
+export { assertKey, parseKey } from './key.js';
+export type { LocalStorageOptions } from './local.js';
+export { createLocalStorage, localStorageDriver, signLocalUrl, verifyLocalSignedUrl, } from './local.js';
+export type { S3Modules, S3StorageOptions } from './s3.js';
+export { createS3Storage, loadS3Modules, s3StorageDriver } from './s3.js';
+export type { StorageConfig, StorageDriver, StorageDriverOptions, StorageObjectInfo, StoragePutOptions, } from './types.js';
+export interface StorageRegistryOptions extends StorageDriverOptions {
+    readonly logger?: Logger;
+}
+export declare function createStorageRegistry(options?: StorageRegistryOptions): DriverRegistry<StorageDriver, StorageConfig>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEpF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzE,YAAY,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,sBAA2B,GACnC,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,CAW9C"}

package/dist/storage/index.js

@@ -0,0 +1,17 @@
+import { createDriverRegistry } from '../drivers/index.js';
+import { localStorageDriver } from './local.js';
+import { s3StorageDriver } from './s3.js';
+export { assertKey, parseKey } from './key.js';
+export { createLocalStorage, localStorageDriver, signLocalUrl, verifyLocalSignedUrl, } from './local.js';
+export { createS3Storage, loadS3Modules, s3StorageDriver } from './s3.js';
+export function createStorageRegistry(options = {}) {
+    const { logger, ...driverOptions } = options;
+    const registry = createDriverRegistry({
+        need: 'storage',
+        ...(logger === undefined ? {} : { logger }),
+    });
+    registry.register(s3StorageDriver(driverOptions));
+    registry.register(localStorageDriver(driverOptions));
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,qBAAqB,CAAA;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAazE,MAAM,UAAU,qBAAqB,CACnC,OAAO,GAA2B,EAAE;IAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAA;IAC5C,MAAM,QAAQ,GAAG,oBAAoB,CAA+B;QAClE,IAAI,EAAE,SAAS;QACf,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAA;IAEF,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAA;IAEpD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/storage/key.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validates an object key and returns its segments.
+ *
+ * Keys reach this function from uploads, imports and plugins, and the local
+ * driver turns them into filesystem paths. `../` in a key would let a caller
+ * write anywhere the process can write, so the check is a whitelist of what a
+ * segment may contain rather than a blacklist of what it may not — a blacklist
+ * loses to URL encoding, Unicode look-alikes and backslashes.
+ */
+export declare function parseKey(key: string): string[];
+export declare function assertKey(key: string): void;
+//# sourceMappingURL=key.d.ts.map

package/dist/storage/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/storage/key.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB9C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/storage/key.js

@@ -0,0 +1,43 @@
+import { CogentaError } from '../errors/index.js';
+const SEGMENT = /^[a-zA-Z0-9._-]+$/;
+/**
+ * Validates an object key and returns its segments.
+ *
+ * Keys reach this function from uploads, imports and plugins, and the local
+ * driver turns them into filesystem paths. `../` in a key would let a caller
+ * write anywhere the process can write, so the check is a whitelist of what a
+ * segment may contain rather than a blacklist of what it may not — a blacklist
+ * loses to URL encoding, Unicode look-alikes and backslashes.
+ */
+export function parseKey(key) {
+    const invalid = (why) => new CogentaError({
+        code: 'STORAGE_FAILED',
+        message: `Invalid storage key "${key}": ${why}.`,
+        hint: 'Use segments of letters, digits, dot, dash and underscore, separated by "/", for example "media/2026/08/cover.webp".',
+        details: { key },
+    });
+    if (key.length === 0)
+        throw invalid('it is empty');
+    if (key.length > 1024)
+        throw invalid('it is longer than 1024 characters');
+    if (key.startsWith('/'))
+        throw invalid('it must be relative');
+    if (key.includes('\\'))
+        throw invalid('backslashes are not allowed');
+    if (key.includes('\0'))
+        throw invalid('it contains a null byte');
+    const segments = key.split('/');
+    for (const segment of segments) {
+        if (segment === '')
+            throw invalid('it has an empty segment');
+        if (segment === '.' || segment === '..')
+            throw invalid('relative segments are not allowed');
+        if (!SEGMENT.test(segment))
+            throw invalid(`the segment "${segment}" has forbidden characters`);
+    }
+    return segments;
+}
+export function assertKey(key) {
+    parseKey(key);
+}
+//# sourceMappingURL=key.js.map

package/dist/storage/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../src/storage/key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,OAAO,GAAG,mBAAmB,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAgB,EAAE,CAC5C,IAAI,YAAY,CAAC;QACf,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,wBAAwB,GAAG,MAAM,GAAG,GAAG;QAChD,IAAI,EAAE,sHAAsH;QAC5H,OAAO,EAAE,EAAE,GAAG,EAAE;KACjB,CAAC,CAAA;IAEJ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IAClD,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI;QAAE,MAAM,OAAO,CAAC,mCAAmC,CAAC,CAAA;IACzE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,OAAO,CAAC,6BAA6B,CAAC,CAAA;IACpE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAA;IAEhE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,EAAE;YAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAA;QAC5D,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,OAAO,CAAC,mCAAmC,CAAC,CAAA;QAC3F,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,MAAM,OAAO,CAAC,gBAAgB,OAAO,4BAA4B,CAAC,CAAA;IAChG,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,QAAQ,CAAC,GAAG,CAAC,CAAA;AACf,CAAC"}

package/dist/storage/local.d.ts

@@ -0,0 +1,23 @@
+import type { Driver } from '../drivers/index.js';
+import type { StorageConfig, StorageDriver, StorageDriverOptions } from './types.js';
+export interface LocalStorageOptions extends StorageDriverOptions {
+    readonly path: string;
+    /** Prefix for `publicUrl`. Relative is fine: it is resolved by the browser. */
+    readonly baseUrl?: string;
+    /**
+     * HMAC key for signed URLs. When absent a random one is generated for this
+     * process, which means signed URLs stop working after a restart — acceptable
+     * for a single-process site, reported by `health()`, and fixed by setting
+     * `COGENTA_STORAGE_SIGNING_KEY`.
+     */
+    readonly signingKey?: string;
+}
+export declare function createLocalStorage(options: LocalStorageOptions): StorageDriver;
+export declare function signLocalUrl(signingKey: string, key: string, expires: number): string;
+/**
+ * Checks a URL produced by `signedUrl`. Comparison is constant-time: a plain
+ * `===` leaks how much of a forged signature was correct, one byte at a time.
+ */
+export declare function verifyLocalSignedUrl(signingKey: string, key: string, expires: number, signature: string, nowSeconds?: number): boolean;
+export declare function localStorageDriver(options?: StorageDriverOptions): Driver<StorageDriver, StorageConfig>;
+//# sourceMappingURL=local.d.ts.map

package/dist/storage/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/storage/local.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,qBAAqB,CAAA;AAG/D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EAGrB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAcD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAuI9E;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAsC,GACjD,OAAO,CAOT;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAiDtC"}

package/dist/storage/local.js

@@ -0,0 +1,204 @@
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { CogentaError } from '../errors/index.js';
+import { parseKey } from './key.js';
+/** What HTTP calls an unknown type, and what S3 stores by default. */
+const DEFAULT_CONTENT_TYPE = 'application/octet-stream';
+function missing(error) {
+    return error?.code === 'ENOENT';
+}
+export function createLocalStorage(options) {
+    const now = options.now ?? Date.now;
+    const baseUrl = (options.baseUrl ?? '/media').replace(/\/$/, '');
+    const signingKey = options.signingKey ?? randomBytes(32).toString('hex');
+    // parseKey has already rejected anything that could escape the root, so the
+    // join below cannot climb out of it.
+    const objectsDir = join(options.path, 'objects');
+    const metaDir = join(options.path, 'meta');
+    const fileFor = (key) => join(objectsDir, ...parseKey(key));
+    // Metadata lives in a parallel tree, never beside the object. Next to it, the
+    // sidecar would be addressable as an object itself: readable under a guessable
+    // key, overwritable through a forged one, and colliding with any object whose
+    // key happens to end in the suffix.
+    const metaFor = (key) => `${join(metaDir, ...parseKey(key))}.json`;
+    async function readMetadata(key) {
+        try {
+            return JSON.parse(await readFile(metaFor(key), 'utf8'));
+        }
+        catch {
+            return {};
+        }
+    }
+    return {
+        put: async (key, data, putOptions) => {
+            const target = fileFor(key);
+            await mkdir(dirname(target), { recursive: true });
+            try {
+                if (Buffer.isBuffer(data)) {
+                    await writeFile(target, data);
+                }
+                else {
+                    const { createWriteStream } = await import('node:fs');
+                    await pipeline(data, createWriteStream(target));
+                }
+            }
+            catch (error) {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: `Could not write the media object "${key}".`,
+                    hint: `Check that ${options.path} exists and is writable.`,
+                    cause: error,
+                });
+            }
+            // Content type is given by the caller and cannot be recovered later, so it
+            // is stored rather than dropped because the filesystem has nowhere to put it.
+            const metadata = {
+                ...(putOptions?.contentType === undefined ? {} : { contentType: putOptions.contentType }),
+                ...(putOptions?.cacheControl === undefined
+                    ? {}
+                    : { cacheControl: putOptions.cacheControl }),
+            };
+            if (Object.keys(metadata).length > 0) {
+                const metaTarget = metaFor(key);
+                await mkdir(dirname(metaTarget), { recursive: true });
+                await writeFile(metaTarget, JSON.stringify(metadata), 'utf8');
+            }
+            else {
+                await rm(metaFor(key), { force: true });
+            }
+        },
+        get: async (key) => {
+            const target = fileFor(key);
+            try {
+                await stat(target);
+            }
+            catch (error) {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: `No media object stored under "${key}".`,
+                    hint: 'Check the key, or upload the object first.',
+                    cause: error,
+                    details: { key },
+                });
+            }
+            return createReadStream(target);
+        },
+        head: async (key) => {
+            try {
+                const stats = await stat(fileFor(key));
+                const metadata = await readMetadata(key);
+                return {
+                    key,
+                    size: stats.size,
+                    // The HTTP default for an unknown type, and what S3 returns for an
+                    // object stored without one. Returning undefined here instead would
+                    // make the two drivers disagree for every upload with no declared
+                    // type — which is most of them.
+                    contentType: metadata.contentType ?? DEFAULT_CONTENT_TYPE,
+                    cacheControl: metadata.cacheControl,
+                };
+            }
+            catch (error) {
+                if (missing(error))
+                    return null;
+                throw error;
+            }
+        },
+        delete: async (key) => {
+            await rm(fileFor(key), { force: true });
+            await rm(metaFor(key), { force: true });
+        },
+        exists: async (key) => {
+            // Validated outside the try: an unsafe key must raise, not be reported as
+            // simply absent, or a traversal attempt looks like an ordinary miss.
+            const target = fileFor(key);
+            try {
+                await stat(target);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        signedUrl: async (key, expiresIn) => {
+            parseKey(key);
+            if (!Number.isFinite(expiresIn) || expiresIn <= 0) {
+                throw new CogentaError({
+                    code: 'STORAGE_FAILED',
+                    message: `A signed URL must expire in a positive number of seconds, received ${String(expiresIn)}.`,
+                    hint: 'Pass the lifetime in seconds, for example 300 for five minutes.',
+                });
+            }
+            const expires = Math.floor(now() / 1000) + Math.floor(expiresIn);
+            const signature = signLocalUrl(signingKey, key, expires);
+            return `${baseUrl}/${key}?expires=${expires}&signature=${signature}`;
+        },
+        publicUrl: (key) => {
+            parseKey(key);
+            return `${baseUrl}/${key}`;
+        },
+    };
+}
+export function signLocalUrl(signingKey, key, expires) {
+    return createHmac('sha256', signingKey).update(`${key}:${expires}`).digest('hex');
+}
+/**
+ * Checks a URL produced by `signedUrl`. Comparison is constant-time: a plain
+ * `===` leaks how much of a forged signature was correct, one byte at a time.
+ */
+export function verifyLocalSignedUrl(signingKey, key, expires, signature, nowSeconds = Math.floor(Date.now() / 1000)) {
+    if (!Number.isFinite(expires) || expires <= nowSeconds)
+        return false;
+    const expected = Buffer.from(signLocalUrl(signingKey, key, expires), 'utf8');
+    const received = Buffer.from(signature, 'utf8');
+    if (expected.length !== received.length)
+        return false;
+    return timingSafeEqual(expected, received);
+}
+export function localStorageDriver(options = {}) {
+    let path;
+    let generatedKey = false;
+    return {
+        name: 'local',
+        tier: 'degraded',
+        available: async (config) => {
+            const candidate = config.path ?? './.cogenta/media';
+            try {
+                await mkdir(candidate, { recursive: true });
+                const probe = join(candidate, `.probe-${process.pid}`);
+                await writeFile(probe, '', 'utf8');
+                await rm(probe, { force: true });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        init: async (config) => {
+            path = config.path ?? './.cogenta/media';
+            const configuredKey = process.env['COGENTA_STORAGE_SIGNING_KEY'];
+            generatedKey = configuredKey === undefined || configuredKey === '';
+            const settings = {
+                ...options,
+                path,
+                ...(config.baseUrl === undefined ? {} : { baseUrl: config.baseUrl }),
+            };
+            return createLocalStorage(configuredKey === undefined || configuredKey === ''
+                ? settings
+                : { ...settings, signingKey: configuredKey });
+        },
+        dispose: async () => undefined,
+        health: async () => ({
+            status: 'degraded',
+            driver: 'local',
+            tier: 'degraded',
+            message: generatedKey
+                ? `Media on disk at ${path ?? 'an unopened path'}. Signed URLs use a per-process key, so they stop working after a restart — set COGENTA_STORAGE_SIGNING_KEY to fix that.`
+                : `Media on disk at ${path ?? 'an unopened path'}.`,
+        }),
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist/storage/local.js.map

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

package/dist/storage/s3.d.ts

@@ -0,0 +1,54 @@
+import type { Driver } from '../drivers/index.js';
+import type { StorageConfig, StorageDriver, StorageDriverOptions } from './types.js';
+/**
+ * Only the slice of the AWS SDK this driver uses, described structurally so the
+ * published types never reference an optional peer.
+ */
+interface S3ClientLike {
+    send<TOutput>(command: object): Promise<TOutput>;
+    destroy(): void;
+}
+interface S3ModuleLike {
+    S3Client: new (config: Record<string, unknown>) => S3ClientLike;
+    PutObjectCommand: new (input: Record<string, unknown>) => object;
+    GetObjectCommand: new (input: Record<string, unknown>) => object;
+    HeadObjectCommand: new (input: Record<string, unknown>) => object;
+    DeleteObjectCommand: new (input: Record<string, unknown>) => object;
+}
+interface PresignerModuleLike {
+    getSignedUrl(client: S3ClientLike, command: object, options: {
+        expiresIn: number;
+    }): Promise<string>;
+}
+interface UploadModuleLike {
+    Upload: new (input: Record<string, unknown>) => {
+        done(): Promise<unknown>;
+    };
+}
+export interface S3Modules {
+    readonly s3: S3ModuleLike;
+    readonly presigner: PresignerModuleLike;
+    readonly upload: UploadModuleLike;
+}
+/**
+ * Loads the AWS SDK if the host application installed it.
+ *
+ * It is an optional peer, and a large one — which is exactly why it must not be
+ * a hard dependency. A site on local storage installs none of it.
+ */
+export declare function loadS3Modules(): Promise<S3Modules | null>;
+export interface S3StorageOptions extends StorageDriverOptions {
+    readonly modules: S3Modules;
+    readonly client: S3ClientLike;
+    readonly bucket: string;
+    /** Prefix for `publicUrl`. Without it, objects have no stable public address. */
+    readonly baseUrl?: string;
+    /** Key prefix inside the bucket, so one bucket can hold several sites. */
+    readonly prefix?: string;
+}
+export declare function createS3Storage(options: S3StorageOptions): StorageDriver;
+export declare function s3StorageDriver(options?: StorageDriverOptions & {
+    prefix?: string;
+}): Driver<StorageDriver, StorageConfig>;
+export {};
+//# sourceMappingURL=s3.d.ts.map

package/dist/storage/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/storage/s3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,qBAAqB,CAAA;AAG/D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EAGrB,MAAM,YAAY,CAAA;AAEnB;;;GAGG;AACH,UAAU,YAAY;IACpB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,YAAY,CAAA;IAC/D,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;IAChE,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;IAChE,iBAAiB,EAAE,KAAK,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;IACjE,mBAAmB,EAAE,KAAK,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;CACpE;AAED,UAAU,mBAAmB;IAC3B,YAAY,CACV,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,MAAM,CAAC,CAAA;CACnB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;QAAE,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAA;CAC7E;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAW/D;AAQD,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CA8HxE;AAED,wBAAgB,eAAe,CAC7B,OAAO,GAAE,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CA0GtC"}