@streetjs/storage 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,232 @@
+/**
+ * @streetjs/storage — shared, strongly typed data models.
+ *
+ * This module is the foundational, provider-agnostic type surface of the
+ * package. Every other module (`driver.ts`, `facade.ts`, the drivers, the
+ * cross-cutting layers, the plugin/CLI/testing utilities, and the integration
+ * bridges) imports the models defined here, so this file intentionally has no
+ * dependency on any sibling module other than a type-only reference to the
+ * driver contract for {@link StorageConfig.driver}. Only core StreetJS
+ * primitives (`Clock`, `MetricsRegistry`, `HealthCheckRegistry`) are imported
+ * from `streetjs`.
+ *
+ * The structural bridge/auth/codec contracts ({@link AuthLike},
+ * {@link ImageCodec}, {@link EventsLike}, {@link QueueLike},
+ * {@link RealtimeLike}) live here because {@link StorageConfig} references them;
+ * the access/image/integration modules import these shapes from this module,
+ * keeping the dependency direction acyclic (leaf modules → types, never the
+ * reverse).
+ *
+ * _Requirements: 1.1, 4.1, 8.2, 10.1, 12.2, 13.1, 16.1, 23.2_
+ */
+import type { Clock, HealthCheckRegistry, MetricsRegistry } from "streetjs";
+import type { StorageDriver } from "./driver.js";
+/** Optional per-application map of custom metadata field types (default: unknown). */
+export interface StorageMetadataMap {
+    [key: string]: unknown;
+}
+/** The typed metadata associated with every object (Requirement 10.1). */
+export interface StorageObjectMetadata<C = Record<string, unknown>> {
+    readonly key: string;
+    readonly size: number;
+    readonly contentType: string;
+    readonly etag: string;
+    readonly checksum: string;
+    readonly owner?: string;
+    readonly tenant?: string;
+    readonly accessLevel: AccessLevel;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly custom: C;
+    readonly versionId?: string;
+}
+/** Metadata supplied on write (Requirement 4.1). */
+export interface WriteMetadata {
+    readonly contentType?: string;
+    readonly owner?: string;
+    readonly tenant?: string;
+    readonly accessLevel?: AccessLevel;
+    readonly custom?: Record<string, unknown>;
+}
+export interface GetResult {
+    readonly found: boolean;
+    readonly bytes?: Uint8Array;
+    readonly metadata?: StorageObjectMetadata;
+}
+export interface CopyResult {
+    readonly copied: boolean;
+    readonly metadata?: StorageObjectMetadata;
+}
+export interface MoveResult {
+    readonly moved: boolean;
+    readonly metadata?: StorageObjectMetadata;
+}
+export interface StorageListItem {
+    readonly key: string;
+    readonly size: number;
+    readonly updatedAt: number;
+}
+/** Options for listing keys under a prefix. */
+export interface ListOptions {
+    /** Maximum number of items to return. */
+    readonly limit?: number;
+    /** Continuation token / key to resume listing after (exclusive). */
+    readonly cursor?: string;
+    /**
+     * When true, collapse results to immediate children by treating `/` as a
+     * directory delimiter rather than returning every key under the prefix.
+     */
+    readonly delimiter?: boolean;
+}
+/** Access classifications (Requirement 11.1). */
+export type AccessLevel = "public" | "private" | "signed" | "authenticated" | "role-based" | "tenant-aware";
+/** Signed URL surface (Requirement 8). */
+export type SignedOperation = "GET" | "PUT" | "DELETE";
+export interface SignedUrlOptions {
+    readonly expiresInMs?: number;
+    readonly headers?: Record<string, string>;
+    readonly contentType?: string;
+    readonly maxSize?: number;
+    readonly metadata?: Record<string, string>;
+}
+export interface SignedUrlVerification {
+    readonly valid: boolean;
+    readonly reason?: "expired" | "operation-mismatch" | "signature-mismatch" | "malformed";
+    readonly key?: string;
+    readonly op?: SignedOperation;
+}
+/** Versioning (Requirement 12). */
+export interface VersionInfo {
+    readonly versionId: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly checksum: string;
+}
+/** Lifecycle rules (Requirement 13.1). */
+export type LifecycleRule = {
+    readonly type: "delete-after-days";
+    readonly days: number;
+    readonly prefix?: string;
+} | {
+    readonly type: "archive-after-months";
+    readonly months: number;
+    readonly prefix?: string;
+} | {
+    readonly type: "expire-temp-uploads";
+    readonly afterMs: number;
+} | {
+    readonly type: "move-to-cold";
+    readonly afterDays: number;
+    readonly coldPrefix: string;
+    readonly prefix?: string;
+};
+export interface LifecycleOutcome {
+    readonly key: string;
+    readonly action: "deleted" | "archived" | "expired" | "moved";
+}
+/** Validation (Requirement 9). */
+export interface ValidationConfig {
+    readonly allowedMimeTypes?: readonly string[];
+    readonly allowedExtensions?: readonly string[];
+    readonly maxSize?: number;
+    readonly filenamePattern?: RegExp;
+    readonly requireChecksum?: boolean;
+    readonly custom?: (input: ValidationInput) => ValidationResult | Promise<ValidationResult>;
+}
+/** The subject a validator inspects before any content is persisted. */
+export interface ValidationInput {
+    readonly key: string;
+    readonly size: number;
+    readonly contentType?: string;
+    readonly checksum?: string;
+    readonly metadata?: WriteMetadata;
+}
+export interface ValidationResult {
+    readonly ok: boolean;
+    readonly error?: string;
+}
+/** Search (Requirement 16.1). */
+export interface SearchFilters {
+    readonly prefix?: string;
+    readonly contentType?: string;
+    readonly owner?: string;
+    readonly tenant?: string;
+    readonly minSize?: number;
+    readonly maxSize?: number;
+    readonly updatedAfter?: number;
+    readonly updatedBefore?: number;
+    readonly metadata?: Record<string, unknown>;
+}
+/** Structural auth bridge used for access-level decisions (optional). */
+export interface AuthLike {
+    /** Resolve whether the given context is permitted to perform an operation. */
+    can(context: {
+        readonly key: string;
+        readonly operation: string;
+        readonly accessLevel: AccessLevel;
+        readonly owner?: string;
+        readonly tenant?: string;
+    }): boolean | Promise<boolean>;
+}
+/** Structural image codec used by the image processor (optional). */
+export interface ImageCodec {
+    /** Transform/convert source image bytes, returning the processed bytes. */
+    transform(bytes: Uint8Array, operation: {
+        readonly resize?: {
+            readonly width?: number;
+            readonly height?: number;
+        };
+        readonly format?: string;
+        readonly quality?: number;
+    }): Uint8Array | Promise<Uint8Array>;
+}
+/** Structural events bridge: publishes typed storage events (optional). */
+export interface EventsLike {
+    publish(event: string, payload: unknown): void | Promise<void>;
+}
+/** Structural queue bridge: dispatches background jobs (optional). */
+export interface QueueLike {
+    dispatch(job: string, payload: unknown): void | Promise<void>;
+}
+/** Structural realtime bridge: broadcasts upload progress/state (optional). */
+export interface RealtimeLike {
+    broadcast(channel: string, event: string, payload: unknown): void | Promise<void>;
+}
+/** Configuration (Requirement 1). */
+export interface StorageConfig {
+    readonly provider: "memory" | "local" | (string & {});
+    readonly driver?: StorageDriver;
+    readonly root?: string;
+    readonly clock?: Clock;
+    readonly validation?: ValidationConfig;
+    readonly versioning?: boolean;
+    readonly signingSecret?: string;
+    readonly metrics?: MetricsRegistry;
+    readonly health?: HealthCheckRegistry;
+    readonly auth?: AuthLike;
+    readonly imageCodec?: ImageCodec;
+    readonly bridges?: {
+        readonly events?: EventsLike;
+        readonly queue?: QueueLike;
+        readonly realtime?: RealtimeLike;
+    };
+}
+export interface StorageStats {
+    readonly uploads: number;
+    readonly downloads: number;
+    readonly bytesUploaded: number;
+    readonly bytesDownloaded: number;
+    readonly activeUploads: number;
+    readonly failedUploads: number;
+    readonly storageUsage: number;
+    readonly multipartUploads: number;
+    readonly resumableSessions: number;
+}
+/** Best-effort connectivity/quota probe result surfaced by driver health checks. */
+export interface DriverProbe {
+    readonly connectivity: boolean;
+    readonly writable: boolean;
+    readonly readable: boolean;
+    readonly quotaAvailable: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,23 @@
+/**
+ * @streetjs/storage — shared, strongly typed data models.
+ *
+ * This module is the foundational, provider-agnostic type surface of the
+ * package. Every other module (`driver.ts`, `facade.ts`, the drivers, the
+ * cross-cutting layers, the plugin/CLI/testing utilities, and the integration
+ * bridges) imports the models defined here, so this file intentionally has no
+ * dependency on any sibling module other than a type-only reference to the
+ * driver contract for {@link StorageConfig.driver}. Only core StreetJS
+ * primitives (`Clock`, `MetricsRegistry`, `HealthCheckRegistry`) are imported
+ * from `streetjs`.
+ *
+ * The structural bridge/auth/codec contracts ({@link AuthLike},
+ * {@link ImageCodec}, {@link EventsLike}, {@link QueueLike},
+ * {@link RealtimeLike}) live here because {@link StorageConfig} references them;
+ * the access/image/integration modules import these shapes from this module,
+ * keeping the dependency direction acyclic (leaf modules → types, never the
+ * reverse).
+ *
+ * _Requirements: 1.1, 4.1, 8.2, 10.1, 12.2, 13.1, 16.1, 23.2_
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @streetjs/storage — the pre-persistence validation pipeline.
+ *
+ * The {@link ValidationPipeline} runs an ordered set of validators over a
+ * {@link ValidationInput} *before* any content is persisted, so an unacceptable
+ * upload is rejected without ever reaching the driver and therefore leaves no
+ * partial object stored (Requirements 9.3, 9.4). The facade constructs a
+ * pipeline from `config.validation` and invokes it as the first step of `put`
+ * and `putStream`; the driver's `put` is only called once the pipeline reports
+ * success.
+ *
+ * The built-in validators, applied strictly in this order, are:
+ *
+ *   1. **MIME type** — the write's `contentType` must be one of
+ *      `allowedMimeTypes` (exact match, or a `type/*` wildcard entry).
+ *   2. **File extension** — the extension derived from the object key must be
+ *      one of `allowedExtensions` (compared case-insensitively, leading dots
+ *      ignored so `"png"` and `".png"` are equivalent).
+ *   3. **File size** — the byte length must not exceed `maxSize`.
+ *   4. **Filename** — the filename (final `/`-delimited segment of the key) must
+ *      match `filenamePattern`.
+ *   5. **Checksum** — when `requireChecksum` is set, a non-empty `checksum` must
+ *      be present on the input.
+ *   6. **Custom** — the configured `custom(input)` validator, if any, is invoked
+ *      last and may reject with its own descriptive message.
+ *
+ * The pipeline short-circuits: it returns the **first** rejection it encounters
+ * and does not run subsequent validators. Each validator is a no-op (returns
+ * `{ ok: true }`) when its governing configuration field is absent, so a sparse
+ * {@link ValidationConfig} only enforces the constraints it actually declares.
+ *
+ * _Requirements: 9.1, 9.2, 9.3, 9.4_
+ */
+import type { ValidationConfig, ValidationInput, ValidationResult } from "./types.js";
+/** A single validator: inspects the input against the config, returning a result. */
+export type Validator = (input: ValidationInput, config: ValidationConfig) => ValidationResult | Promise<ValidationResult>;
+/**
+ * Validator 1 — MIME type. When `allowedMimeTypes` is configured, the input's
+ * `contentType` must exactly equal one of the allowed entries, or match a
+ * `type/*` wildcard entry (e.g. `"image/*"` permits `"image/png"`). A missing
+ * `contentType` is rejected because it cannot be shown to be permitted.
+ */
+export declare const validateMimeType: Validator;
+/**
+ * Validator 2 — file extension. When `allowedExtensions` is configured, the
+ * extension derived from the object key must be one of the allowed entries,
+ * compared case-insensitively with any leading dot ignored. A key with no
+ * extension is rejected.
+ */
+export declare const validateExtension: Validator;
+/**
+ * Validator 3 — file size. When `maxSize` is configured, the input's byte
+ * length must not exceed it.
+ */
+export declare const validateSize: Validator;
+/**
+ * Validator 4 — filename. When `filenamePattern` is configured, the filename
+ * (final `/`-delimited segment of the key) must match the pattern. The pattern
+ * is evaluated against a fresh, non-global {@link RegExp} so a shared, sticky
+ * (`/g`) source pattern cannot leak `lastIndex` state across calls.
+ */
+export declare const validateFilename: Validator;
+/**
+ * Validator 5 — checksum. When `requireChecksum` is set, a non-empty `checksum`
+ * must be present on the input. For buffered writes the facade always supplies a
+ * computed checksum, so this only rejects when a checksum genuinely cannot be
+ * determined.
+ */
+export declare const validateChecksum: Validator;
+/**
+ * Validator 6 — custom. When a `custom(input)` validator is configured it runs
+ * last and its (possibly asynchronous) result is returned verbatim, so a custom
+ * rejection carries its own descriptive message.
+ */
+export declare const validateCustom: Validator;
+/**
+ * The built-in validators applied by every {@link ValidationPipeline}, in the
+ * fixed order MIME type → extension → size → filename → checksum → custom.
+ */
+export declare const BUILT_IN_VALIDATORS: readonly Validator[];
+/**
+ * Runs an ordered chain of validators against a {@link ValidationInput},
+ * short-circuiting on the first rejection.
+ *
+ * Construct one from a {@link ValidationConfig}; the facade does this once per
+ * `Storage` instance when `config.validation` is present and calls
+ * {@link ValidationPipeline.validate} before delegating any bytes to the driver.
+ * Because a rejection is surfaced *before* `driver.put` is ever called, a
+ * rejected upload leaves no partial object stored (Requirement 9.4).
+ */
+export declare class ValidationPipeline {
+    /** The configuration each validator consults. */
+    private readonly config;
+    /** The ordered validators to run (defaults to {@link BUILT_IN_VALIDATORS}). */
+    private readonly validators;
+    constructor(config: ValidationConfig, validators?: readonly Validator[]);
+    /**
+     * Run every validator in order against `input`, returning the first rejection
+     * encountered or `{ ok: true }` when all validators accept. Validators are
+     * awaited sequentially so an async custom validator observes the same
+     * short-circuiting order as the synchronous built-ins.
+     */
+    validate(input: ValidationInput): Promise<ValidationResult>;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,KACrB,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAYlD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAa9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAoB/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAS1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAW9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAQ9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAM5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,SAAS,EAOnD,CAAC;AAIF;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC7B,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;gBAGhD,MAAM,EAAE,gBAAgB,EACxB,UAAU,GAAE,SAAS,SAAS,EAAwB;IAMxD;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CASlE"}

package/dist/validation.js

@@ -0,0 +1,225 @@
+/**
+ * @streetjs/storage — the pre-persistence validation pipeline.
+ *
+ * The {@link ValidationPipeline} runs an ordered set of validators over a
+ * {@link ValidationInput} *before* any content is persisted, so an unacceptable
+ * upload is rejected without ever reaching the driver and therefore leaves no
+ * partial object stored (Requirements 9.3, 9.4). The facade constructs a
+ * pipeline from `config.validation` and invokes it as the first step of `put`
+ * and `putStream`; the driver's `put` is only called once the pipeline reports
+ * success.
+ *
+ * The built-in validators, applied strictly in this order, are:
+ *
+ *   1. **MIME type** — the write's `contentType` must be one of
+ *      `allowedMimeTypes` (exact match, or a `type/*` wildcard entry).
+ *   2. **File extension** — the extension derived from the object key must be
+ *      one of `allowedExtensions` (compared case-insensitively, leading dots
+ *      ignored so `"png"` and `".png"` are equivalent).
+ *   3. **File size** — the byte length must not exceed `maxSize`.
+ *   4. **Filename** — the filename (final `/`-delimited segment of the key) must
+ *      match `filenamePattern`.
+ *   5. **Checksum** — when `requireChecksum` is set, a non-empty `checksum` must
+ *      be present on the input.
+ *   6. **Custom** — the configured `custom(input)` validator, if any, is invoked
+ *      last and may reject with its own descriptive message.
+ *
+ * The pipeline short-circuits: it returns the **first** rejection it encounters
+ * and does not run subsequent validators. Each validator is a no-op (returns
+ * `{ ok: true }`) when its governing configuration field is absent, so a sparse
+ * {@link ValidationConfig} only enforces the constraints it actually declares.
+ *
+ * _Requirements: 9.1, 9.2, 9.3, 9.4_
+ */
+/** The shared "accepted" result, reused to avoid reallocating on every pass. */
+const OK = { ok: true };
+/** Build a rejection result carrying a descriptive message. */
+function reject(error) {
+    return { ok: false, error };
+}
+// ── Built-in validators ───────────────────────────────────────────────────────
+/**
+ * Validator 1 — MIME type. When `allowedMimeTypes` is configured, the input's
+ * `contentType` must exactly equal one of the allowed entries, or match a
+ * `type/*` wildcard entry (e.g. `"image/*"` permits `"image/png"`). A missing
+ * `contentType` is rejected because it cannot be shown to be permitted.
+ */
+export const validateMimeType = (input, config) => {
+    const allowed = config.allowedMimeTypes;
+    if (allowed === undefined) {
+        return OK;
+    }
+    const contentType = input.contentType;
+    if (contentType !== undefined && allowed.some((entry) => mimeMatches(entry, contentType))) {
+        return OK;
+    }
+    return reject(`content type "${contentType ?? "(none)"}" is not permitted; ` +
+        `allowed MIME types: ${allowed.join(", ")}`);
+};
+/**
+ * Validator 2 — file extension. When `allowedExtensions` is configured, the
+ * extension derived from the object key must be one of the allowed entries,
+ * compared case-insensitively with any leading dot ignored. A key with no
+ * extension is rejected.
+ */
+export const validateExtension = (input, config) => {
+    const allowed = config.allowedExtensions;
+    if (allowed === undefined) {
+        return OK;
+    }
+    const extension = extractExtension(input.key);
+    if (extension === undefined) {
+        return reject(`object key "${input.key}" has no file extension; ` +
+            `allowed extensions: ${allowed.join(", ")}`);
+    }
+    const normalized = normalizeExtension(extension);
+    if (allowed.some((entry) => normalizeExtension(entry) === normalized)) {
+        return OK;
+    }
+    return reject(`file extension ".${normalized}" is not permitted; ` +
+        `allowed extensions: ${allowed.join(", ")}`);
+};
+/**
+ * Validator 3 — file size. When `maxSize` is configured, the input's byte
+ * length must not exceed it.
+ */
+export const validateSize = (input, config) => {
+    const maxSize = config.maxSize;
+    if (maxSize === undefined) {
+        return OK;
+    }
+    if (input.size > maxSize) {
+        return reject(`size ${input.size} bytes exceeds the maximum of ${maxSize} bytes`);
+    }
+    return OK;
+};
+/**
+ * Validator 4 — filename. When `filenamePattern` is configured, the filename
+ * (final `/`-delimited segment of the key) must match the pattern. The pattern
+ * is evaluated against a fresh, non-global {@link RegExp} so a shared, sticky
+ * (`/g`) source pattern cannot leak `lastIndex` state across calls.
+ */
+export const validateFilename = (input, config) => {
+    const pattern = config.filenamePattern;
+    if (pattern === undefined) {
+        return OK;
+    }
+    const filename = extractFilename(input.key);
+    const safePattern = new RegExp(pattern.source, pattern.flags.replace(/[gy]/g, ""));
+    if (safePattern.test(filename)) {
+        return OK;
+    }
+    return reject(`filename "${filename}" does not match the required pattern ${pattern.toString()}`);
+};
+/**
+ * Validator 5 — checksum. When `requireChecksum` is set, a non-empty `checksum`
+ * must be present on the input. For buffered writes the facade always supplies a
+ * computed checksum, so this only rejects when a checksum genuinely cannot be
+ * determined.
+ */
+export const validateChecksum = (input, config) => {
+    if (config.requireChecksum !== true) {
+        return OK;
+    }
+    if (input.checksum !== undefined && input.checksum !== "") {
+        return OK;
+    }
+    return reject("a checksum is required for this upload but none was provided");
+};
+/**
+ * Validator 6 — custom. When a `custom(input)` validator is configured it runs
+ * last and its (possibly asynchronous) result is returned verbatim, so a custom
+ * rejection carries its own descriptive message.
+ */
+export const validateCustom = async (input, config) => {
+    const custom = config.custom;
+    if (custom === undefined) {
+        return OK;
+    }
+    return custom(input);
+};
+/**
+ * The built-in validators applied by every {@link ValidationPipeline}, in the
+ * fixed order MIME type → extension → size → filename → checksum → custom.
+ */
+export const BUILT_IN_VALIDATORS = [
+    validateMimeType,
+    validateExtension,
+    validateSize,
+    validateFilename,
+    validateChecksum,
+    validateCustom,
+];
+// ── The pipeline ──────────────────────────────────────────────────────────────
+/**
+ * Runs an ordered chain of validators against a {@link ValidationInput},
+ * short-circuiting on the first rejection.
+ *
+ * Construct one from a {@link ValidationConfig}; the facade does this once per
+ * `Storage` instance when `config.validation` is present and calls
+ * {@link ValidationPipeline.validate} before delegating any bytes to the driver.
+ * Because a rejection is surfaced *before* `driver.put` is ever called, a
+ * rejected upload leaves no partial object stored (Requirement 9.4).
+ */
+export class ValidationPipeline {
+    /** The configuration each validator consults. */
+    config;
+    /** The ordered validators to run (defaults to {@link BUILT_IN_VALIDATORS}). */
+    validators;
+    constructor(config, validators = BUILT_IN_VALIDATORS) {
+        this.config = config;
+        this.validators = validators;
+    }
+    /**
+     * Run every validator in order against `input`, returning the first rejection
+     * encountered or `{ ok: true }` when all validators accept. Validators are
+     * awaited sequentially so an async custom validator observes the same
+     * short-circuiting order as the synchronous built-ins.
+     */
+    async validate(input) {
+        for (const validator of this.validators) {
+            const result = await validator(input, this.config);
+            if (!result.ok) {
+                return result;
+            }
+        }
+        return OK;
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────────
+/** Does a (possibly `type/*` wildcard) allow-list entry match a concrete MIME type? */
+function mimeMatches(entry, contentType) {
+    const normalizedEntry = entry.trim().toLowerCase();
+    const normalizedType = contentType.trim().toLowerCase();
+    if (normalizedEntry === normalizedType) {
+        return true;
+    }
+    if (normalizedEntry.endsWith("/*")) {
+        const prefix = normalizedEntry.slice(0, normalizedEntry.length - 1); // keep trailing "/"
+        return normalizedType.startsWith(prefix);
+    }
+    return false;
+}
+/** The final `/`-delimited segment of a key (its filename). */
+function extractFilename(key) {
+    const slashIndex = key.lastIndexOf("/");
+    return slashIndex === -1 ? key : key.slice(slashIndex + 1);
+}
+/**
+ * The extension of a key's filename (the text after the final `.`), or
+ * `undefined` when the filename has no extension. A leading-dot-only filename
+ * (e.g. `".gitignore"`) is treated as having no extension.
+ */
+function extractExtension(key) {
+    const filename = extractFilename(key);
+    const dotIndex = filename.lastIndexOf(".");
+    if (dotIndex <= 0 || dotIndex === filename.length - 1) {
+        return undefined;
+    }
+    return filename.slice(dotIndex + 1);
+}
+/** Normalize an extension for comparison: lowercase, leading dots stripped. */
+function normalizeExtension(extension) {
+    return extension.replace(/^\.+/, "").toLowerCase();
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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