@pulse-compute/assets 0.0.0 → 1.0.0-beta.2

package/README.md

@@ -1,3 +1,33 @@
 # @pulse-compute/assets
 
-This is an inert namespace-bootstrap package. It contains no executable code.
+<!-- pulse-package-status:start -->
+> **Support tier:** Supported provider/extension surface<br>
+> **Audience:** Applications using JavaScript asset middleware or the package-owned lowerable asset lookup capability.<br>
+> **Install directly:** Yes, only when the application uses the assets capability.<br>
+> **Supported entry points:** `@pulse-compute/assets`<br>
+> **Stability:** The package root is the supported JavaScript API and canonical Native authoring surface; /pulsewasm remains a compatibility subpath, while manifest/compiler subpaths are toolchain integration.<br>
+> **npm:** [`@pulse-compute/assets`](https://www.npmjs.com/package/@pulse-compute/assets)<br>
+> **Canonical documentation:** [Package guide](https://pulsecompute.io/v1.0.0-beta.2/packages/assets/)
+>
+> This release-status block is generated from the synchronized `Pulse 1.0.0-beta.2` package policy.
+<!-- pulse-package-status:end -->
+
+The normal package root is the supported JavaScript API and canonical Native authoring surface:
+
+```ts
+import { assets } from '@pulse-compute/assets'
+
+const found = await assets.lookup(ctx, 'public', '/app.js', { method: 'GET' })
+return assets.respond(found)
+```
+
+`assets.lookup()` is a request-bound package effect owned by the internal `pulse.assets` contract and may be directly awaited or included in `ctx.parallel({ ... })`. JavaScript executes the actual package implementation; supported Native calls are recognized by the trusted package compiler and lowered to `assets.lookup`.
+
+The same root exports `createAssets`, `AssetManager`, `AssetBucket`, and `signSigV4` for direct JavaScript local, hosted, and S3-compatible asset middleware. Hosted and bucket modes preserve upstream Web response streams. Local mode follows the restored reference behavior; a broader resource-bound policy belongs at the shared core request/response boundary.
+
+`@pulse-compute/assets/pulsewasm` remains a compatibility-only lowerable
+facade. Direct JavaScript execution of that subpath throws
+`PulseWasmAssetsLoweringError`; applications should use the normal package
+root. Manifest and compiler exports are toolchain integration. Migration
+guidance is published at
+<https://pulsecompute.io/v1.0.0-beta.2/guides/compatibility-imports/>.

package/as/README.md

@@ -0,0 +1,12 @@
+# PulseWasm assets sidecar
+
+This directory contains the package-owned AssemblyScript sidecar declared by `../pulsewasm.manifest.cjs`.
+
+The stable exports are:
+
+- `pulse_assets_lookup`
+- `pulse_assets_respond`
+
+They delegate to the corresponding `pulse_assets_host` imports and form the compiled-Wasm ABI used by synchronized provider integration tests. Asset payload validation and canonical effect construction remain in the package compiler builder; provider execution remains in provider packages.
+
+This sidecar is an implementation surface, not an application-author entry point.

package/as/index.as.ts

@@ -0,0 +1,54 @@
+/**
+ * PulseWasm assets AssemblyScript sidecar.
+ *
+ * This package-owned sidecar is intentionally tiny. User code lowers
+ * assets.lookup/respond into these stable exports; the exports delegate to
+ * host-owned provider imports. Keeping the AS surface explicit lets package-out
+ * tests validate the link ABI without materializing JS asset objects in Wasm.
+ */
+
+export const PULSE_ASSETS_METHOD_GET: i32 = 1;
+export const PULSE_ASSETS_METHOD_HEAD: i32 = 2;
+export const PULSE_ASSETS_EFFECT_TERMINAL_RESPONSE: i32 = 1;
+
+@external("pulse_assets_host", "lookup")
+declare function __pulse_assets_host_lookup(
+  storePtr: usize,
+  storeLen: i32,
+  keyPtr: usize,
+  keyLen: i32,
+  method: i32,
+  optionsRef: i32
+): i32;
+
+@external("pulse_assets_host", "respond")
+declare function __pulse_assets_host_respond(assetHandle: i32, optionsRef: i32): i32;
+
+/**
+ * Lowering target for assets.lookup(store, key, options).
+ *
+ * The generated caller passes string pointers/lengths and a static method code.
+ * The host/provider owns the lookup result handle. Returning a handle keeps the
+ * AS sidecar narrow and avoids materializing arbitrary JS objects in Wasm.
+ */
+export function pulse_assets_lookup(
+  storePtr: usize,
+  storeLen: i32,
+  keyPtr: usize,
+  keyLen: i32,
+  method: i32,
+  optionsRef: i32
+): i32 {
+  return __pulse_assets_host_lookup(storePtr, storeLen, keyPtr, keyLen, method, optionsRef);
+}
+
+/**
+ * Lowering target for assets.respond(assetHandle, options).
+ *
+ * The first compiled path treats this as a terminal asset response effect, not a
+ * continuation boundary. That keeps the assets lifecycle independent from
+ * ctx.resolve resume semantics until a later pass deliberately adds it.
+ */
+export function pulse_assets_respond(assetHandle: i32, optionsRef: i32): i32 {
+  return __pulse_assets_host_respond(assetHandle, optionsRef);
+}

package/conformance/native.json

@@ -0,0 +1,7 @@
+{
+  "version": "pulse.package-conformance-fixture.v1",
+  "contractId": "pulse.assets",
+  "target": "native",
+  "status": "contract-only",
+  "cases": ["assets.lookup", "assets.respond"]
+}

package/dist/asset-bucket.d.ts

@@ -0,0 +1,85 @@
+import type { PulseContext, RouterNext } from '@pulse-compute/runtime';
+import { type SecretValue, type SigV4Credentials } from './sigv4.js';
+import { type AssetBucketContext, type AssetBucketRouteContext, type LegacyAssetBucketRouteContext, type RouteNext } from './asset-context.js';
+export type { AssetBucketContext, AssetBucketRouteContext, LegacyAssetBucketRouteContext, RouteNext, } from './asset-context.js';
+export type AssetBucketMethod = 'GET' | 'HEAD';
+export type AssetBucketResponseContext = {
+    request: Request;
+    key: string;
+    upstream: Response;
+};
+export type AssetBucketSignerInput = {
+    method: string;
+    url: URL;
+    headers: Headers;
+    credentials: SigV4Credentials;
+    region: string;
+    service: string;
+};
+export type AssetBucketSigner = (input: AssetBucketSignerInput) => Promise<Request>;
+export type AssetBucketOptions = {
+    endpoint: string;
+    bucket: string;
+    credentials: {
+        key: SecretValue;
+        secret: SecretValue;
+        token?: SecretValue | undefined;
+    };
+    region?: string | undefined;
+    service?: string | undefined;
+    prefix?: string | undefined;
+    basePath?: string | undefined;
+    ttl?: number | false | undefined;
+    immutable?: boolean | undefined;
+    pathStyle?: boolean | undefined;
+    methods?: AssetBucketMethod[] | undefined;
+    passThroughOn404?: boolean | undefined;
+    passThroughOnError?: boolean | undefined;
+    signer?: "sigv4" | AssetBucketSigner | undefined;
+    fetch?: typeof fetch | undefined;
+    mapKey?: ((ctx: AssetBucketContext) => string | Promise<string>) | undefined;
+    setHeaders?: ((ctx: AssetBucketResponseContext) => HeadersInit | void | Promise<HeadersInit | void>) | undefined;
+};
+export type AssetBucketMiddleware = ((ctx: PulseContext, next: RouterNext) => Promise<Response>) & ((ctx: LegacyAssetBucketRouteContext, next?: RouteNext) => Promise<Response | void>);
+export type AssetBucketInstance = AssetBucketMiddleware & {
+    readonly core: AssetBucketCore;
+    handle: AssetBucketMiddleware;
+    resolveKey(ctx: AssetBucketRouteContext): Promise<string>;
+};
+export interface AssetBucketConstructor {
+    new (options: AssetBucketOptions): AssetBucketInstance;
+    (options: AssetBucketOptions): AssetBucketInstance;
+}
+type ResolvedOptions = {
+    endpoint: URL;
+    bucket: string;
+    credentials: AssetBucketOptions["credentials"];
+    region: string;
+    service: string;
+    prefix: string;
+    basePath?: string | undefined;
+    ttl: number | false;
+    immutable: boolean;
+    pathStyle: boolean;
+    methods: ReadonlySet<AssetBucketMethod>;
+    passThroughOn404: boolean;
+    passThroughOnError: boolean;
+    signer: "sigv4" | AssetBucketSigner;
+    fetch: typeof fetch;
+    mapKey?: AssetBucketOptions["mapKey"] | undefined;
+    setHeaders?: AssetBucketOptions["setHeaders"] | undefined;
+};
+export declare class AssetBucketCore {
+    readonly options: ResolvedOptions;
+    constructor(options: AssetBucketOptions);
+    handle(ctx: AssetBucketRouteContext, next?: RouteNext): Promise<Response | void>;
+    resolveKey(ctx: AssetBucketRouteContext): Promise<string>;
+    private fetchObject;
+    private objectUrl;
+    private forwardHeaders;
+    private sign;
+    private toResponse;
+    private pass;
+}
+export declare const AssetBucket: AssetBucketConstructor;
+//# sourceMappingURL=asset-bucket.d.ts.map

package/dist/asset-bucket.d.ts.map

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

package/dist/asset-bucket.js

@@ -0,0 +1,226 @@
+import { AssetBucketConfigError, AssetBucketFetchError } from './errors.js';
+import { encodeS3Key, signSigV4 } from './sigv4.js';
+import { cancelResponseBody } from './response-ownership.js';
+import { normalizeAssetContext, } from './asset-context.js';
+const DEFAULT_TTL = 3600;
+const IMMUTABLE_TTL = 31536000;
+const FORWARDED_HEADERS = [
+    "range",
+    "if-match",
+    "if-none-match",
+    "if-modified-since",
+    "if-unmodified-since",
+];
+function trimSlashes(value) {
+    return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizePrefix(prefix) {
+    if (!prefix)
+        return "";
+    const clean = trimSlashes(prefix);
+    return clean ? `${clean}/` : "";
+}
+function normalizeBasePath(basePath) {
+    if (!basePath)
+        return undefined;
+    const clean = `/${trimSlashes(basePath)}`;
+    return clean === "/" ? undefined : clean;
+}
+function joinPath(...parts) {
+    return parts
+        .map((part) => trimSlashes(part))
+        .filter(Boolean)
+        .join("/");
+}
+function normalizeEndpoint(endpoint) {
+    try {
+        return new URL(endpoint.endsWith("/") ? endpoint : `${endpoint}/`);
+    }
+    catch {
+        throw new AssetBucketConfigError(`Invalid endpoint URL: ${endpoint}`);
+    }
+}
+function normalizedContext(ctx) {
+    return normalizeAssetContext(ctx);
+}
+function stripBasePath(pathname, basePath) {
+    if (!basePath)
+        return pathname;
+    if (pathname === basePath)
+        return "/";
+    if (pathname.startsWith(`${basePath}/`)) {
+        return pathname.slice(basePath.length);
+    }
+    return pathname;
+}
+function applyHeaders(target, headers) {
+    if (!headers)
+        return;
+    new Headers(headers).forEach((value, key) => target.set(key, value));
+}
+function makeCacheControl(options) {
+    if (options.immutable) {
+        const ttl = options.ttl === false ? IMMUTABLE_TTL : options.ttl;
+        return `public, max-age=${ttl}, immutable`;
+    }
+    if (options.ttl === false)
+        return undefined;
+    return `public, max-age=${options.ttl}`;
+}
+function resolveOptions(options) {
+    if (!options.endpoint)
+        throw new AssetBucketConfigError("AssetBucket requires endpoint");
+    if (!options.bucket)
+        throw new AssetBucketConfigError("AssetBucket requires bucket");
+    if (!options.credentials?.key)
+        throw new AssetBucketConfigError("AssetBucket requires credentials.key");
+    if (!options.credentials?.secret)
+        throw new AssetBucketConfigError("AssetBucket requires credentials.secret");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new AssetBucketConfigError("AssetBucket requires a fetch implementation");
+    }
+    return {
+        endpoint: normalizeEndpoint(options.endpoint),
+        bucket: options.bucket,
+        credentials: options.credentials,
+        region: options.region ?? "us-east-1",
+        service: options.service ?? "s3",
+        prefix: normalizePrefix(options.prefix),
+        basePath: normalizeBasePath(options.basePath),
+        ttl: options.ttl ?? DEFAULT_TTL,
+        immutable: options.immutable ?? false,
+        pathStyle: options.pathStyle ?? true,
+        methods: new Set(options.methods ?? ["GET", "HEAD"]),
+        passThroughOn404: options.passThroughOn404 ?? true,
+        passThroughOnError: options.passThroughOnError ?? false,
+        signer: options.signer ?? "sigv4",
+        fetch: fetchImpl,
+        mapKey: options.mapKey,
+        setHeaders: options.setHeaders,
+    };
+}
+export class AssetBucketCore {
+    options;
+    constructor(options) {
+        this.options = resolveOptions(options);
+    }
+    async handle(ctx, next) {
+        const normalized = normalizedContext(ctx);
+        const method = normalized.request.method.toUpperCase();
+        if (!this.options.methods.has(method)) {
+            return this.pass(next);
+        }
+        try {
+            const key = await this.resolveKey(ctx);
+            if (!key)
+                return this.pass(next);
+            const upstream = await this.fetchObject(normalized.request, key, method);
+            if (upstream.status === 404 && this.options.passThroughOn404) {
+                await cancelResponseBody(upstream);
+                return this.pass(next);
+            }
+            return await this.toResponse(normalized.request, key, upstream);
+        }
+        catch (cause) {
+            if (this.options.passThroughOnError)
+                return this.pass(next);
+            if (cause instanceof AssetBucketConfigError)
+                throw cause;
+            throw new AssetBucketFetchError("AssetBucket failed to fetch asset", { cause });
+        }
+    }
+    async resolveKey(ctx) {
+        const normalized = normalizedContext(ctx);
+        if (this.options.mapKey) {
+            return normalizeObjectKey(await this.options.mapKey(normalized));
+        }
+        let relative = normalized.path.relative || new URL(normalized.request.url).pathname;
+        relative = stripBasePath(relative, this.options.basePath);
+        relative = relative.replace(/^\/+/, "");
+        const key = `${this.options.prefix}${relative}`;
+        return normalizeObjectKey(key);
+    }
+    async fetchObject(request, key, method) {
+        const url = this.objectUrl(key);
+        const headers = this.forwardHeaders(request.headers);
+        const signed = await this.sign({ method, url, headers });
+        return await this.options.fetch(signed);
+    }
+    objectUrl(key) {
+        const endpoint = new URL(this.options.endpoint.toString());
+        const encodedKey = encodeS3Key(key);
+        if (this.options.pathStyle) {
+            endpoint.pathname = joinPath(endpoint.pathname, this.options.bucket, encodedKey);
+            return endpoint;
+        }
+        endpoint.hostname = `${this.options.bucket}.${endpoint.hostname}`;
+        endpoint.pathname = joinPath(endpoint.pathname, encodedKey);
+        return endpoint;
+    }
+    forwardHeaders(source) {
+        const headers = new Headers();
+        for (const name of FORWARDED_HEADERS) {
+            const value = source.get(name);
+            if (value !== null)
+                headers.set(name, value);
+        }
+        return headers;
+    }
+    async sign(input) {
+        if (typeof this.options.signer === "function") {
+            return await this.options.signer({
+                method: input.method,
+                url: input.url,
+                headers: input.headers,
+                credentials: this.options.credentials,
+                region: this.options.region,
+                service: this.options.service,
+            });
+        }
+        return await signSigV4({
+            method: input.method,
+            url: input.url,
+            headers: input.headers,
+            credentials: this.options.credentials,
+            region: this.options.region,
+            service: this.options.service,
+        });
+    }
+    async toResponse(request, key, upstream) {
+        const headers = new Headers(upstream.headers);
+        const cacheControl = makeCacheControl({ ttl: this.options.ttl, immutable: this.options.immutable });
+        if (cacheControl)
+            headers.set("cache-control", cacheControl);
+        const extraHeaders = await this.options.setHeaders?.({ request, key, upstream });
+        applyHeaders(headers, extraHeaders);
+        const isHead = request.method.toUpperCase() === "HEAD";
+        if (isHead)
+            await cancelResponseBody(upstream);
+        return new Response(isHead ? null : upstream.body, {
+            status: upstream.status,
+            statusText: upstream.statusText,
+            headers,
+        });
+    }
+    async pass(next) {
+        return next ? await next() : undefined;
+    }
+}
+function normalizeObjectKey(key) {
+    return key.replace(/^\/+/, "").replace(/\/+/g, "/");
+}
+function createAssetBucket(options) {
+    const core = new AssetBucketCore(options);
+    const middleware = core.handle.bind(core);
+    Object.defineProperties(middleware, {
+        core: { value: core, enumerable: false },
+        handle: { value: middleware, enumerable: false },
+        resolveKey: { value: core.resolveKey.bind(core), enumerable: false },
+    });
+    return middleware;
+}
+export const AssetBucket = function AssetBucket(options) {
+    return createAssetBucket(options);
+};
+//# sourceMappingURL=asset-bucket.js.map

package/dist/asset-bucket.js.map

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

package/dist/asset-context.d.ts

@@ -0,0 +1,34 @@
+import type { PulseContext } from '@pulse-compute/runtime';
+export type RouteNext = () => Promise<Response | void> | Response | void;
+export type LegacyAssetBucketRouteContext = {
+    request: Request;
+    params?: Readonly<Record<string, string>> | undefined;
+    state?: Record<string, unknown> | undefined;
+    path?: {
+        absolute?: string | undefined;
+        relative?: string | undefined;
+    } | undefined;
+    raw?: {
+        request?: unknown;
+        response?: unknown;
+        env?: unknown;
+        [key: string]: unknown;
+    } | undefined;
+};
+export type AssetBucketRouteContext = PulseContext | LegacyAssetBucketRouteContext;
+export type AssetBucketContext = {
+    request: Request;
+    params: Readonly<Record<string, string>>;
+    path: {
+        absolute: string;
+        relative: string;
+    };
+    raw: {
+        request?: unknown;
+        response?: unknown;
+        env?: unknown;
+        [key: string]: unknown;
+    };
+};
+export declare function normalizeAssetContext(ctx: AssetBucketRouteContext): AssetBucketContext;
+//# sourceMappingURL=asset-context.d.ts.map

package/dist/asset-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-context.d.ts","sourceRoot":"","sources":["../src/asset-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEzE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC/B,GAAG,SAAS,CAAC;IACd,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GAAG,SAAS,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,6BAA6B,CAAC;AAEnF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,GAAG,EAAE;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAMF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,kBAAkB,CAuBtF"}

package/dist/asset-context.js

@@ -0,0 +1,29 @@
+import { pulseAssetsRuntime } from './internal/package-runtime.js';
+function isPulseContext(value) {
+    return Boolean(value && typeof value === 'object' && 'req' in value && 'state' in value);
+}
+export function normalizeAssetContext(ctx) {
+    if (isPulseContext(ctx)) {
+        const view = pulseAssetsRuntime.context(ctx);
+        return {
+            request: view.request,
+            params: view.params,
+            path: view.path,
+            raw: {},
+        };
+    }
+    if (!ctx || !(ctx.request instanceof Request)) {
+        throw new TypeError('Pulse Assets middleware requires a PulseContext or legacy request context.');
+    }
+    const url = new URL(ctx.request.url);
+    return {
+        request: ctx.request,
+        params: ctx.params ?? {},
+        path: {
+            absolute: ctx.path?.absolute ?? url.pathname,
+            relative: ctx.path?.relative ?? url.pathname,
+        },
+        raw: ctx.raw ?? {},
+    };
+}
+//# sourceMappingURL=asset-context.js.map

package/dist/asset-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-context.js","sourceRoot":"","sources":["../src/asset-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAqCnE,SAAS,cAAc,CAAC,KAA8B;IACpD,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAA4B;IAChE,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,EAAE;SACR,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,YAAY,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,SAAS,CAAC,4EAA4E,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;QACxB,IAAI,EAAE;YACJ,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,QAAQ;YAC5C,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,QAAQ;SAC7C;QACD,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/dist/asset-manager.d.ts

@@ -0,0 +1,54 @@
+import { type AssetBucketMethod, type AssetBucketOptions, type AssetBucketRouteContext, type RouteNext } from './asset-bucket.js';
+import type { PulseContext, RouterNext } from '@pulse-compute/runtime';
+import { type LegacyAssetBucketRouteContext } from './asset-context.js';
+export type AssetCacheOptions = {
+    ttl?: number | false | undefined;
+    immutable?: boolean | undefined;
+    passThroughOn404?: boolean | undefined;
+    passThroughOnError?: boolean | undefined;
+    methods?: AssetBucketMethod[] | undefined;
+};
+export type LocalAssetsConfig = AssetCacheOptions & {
+    mode: 'local';
+    dir: string;
+    prefix?: string | undefined;
+    index?: string | false | undefined;
+    fetch?: typeof fetch | undefined;
+    contentTypes?: Record<string, string> | undefined;
+};
+export type HostedAssetsConfig = AssetCacheOptions & {
+    mode: 'hosted';
+    origin: string;
+    prefix?: string | undefined;
+    headers?: HeadersInit | undefined;
+    fetch?: typeof fetch | undefined;
+};
+export type BucketAssetsConfig = AssetCacheOptions & AssetBucketOptions & {
+    mode: 'bucket';
+};
+export type AssetsConfig = LocalAssetsConfig | HostedAssetsConfig | BucketAssetsConfig;
+export type AssetManagerMiddleware = ((ctx: PulseContext, next: RouterNext) => Promise<Response>) & ((ctx: LegacyAssetBucketRouteContext, next?: RouteNext) => Promise<Response | void>);
+export type AssetManagerInstance = AssetManagerMiddleware & {
+    readonly core: AssetManagerCore;
+    handle: AssetManagerMiddleware;
+    resolveKey(ctx: AssetBucketRouteContext): Promise<string>;
+};
+export interface AssetManagerConstructor {
+    new (config: AssetsConfig): AssetManagerInstance;
+    (config: AssetsConfig): AssetManagerInstance;
+}
+export declare class AssetManagerCore {
+    readonly config: AssetsConfig;
+    private readonly bucket?;
+    constructor(config: AssetsConfig);
+    handle(ctx: AssetBucketRouteContext, next?: RouteNext): Promise<Response | void>;
+    resolveKey(ctx: AssetBucketRouteContext): Promise<string>;
+    private allowed;
+    private handleLocal;
+    private handleHosted;
+    private handleMiss;
+    private pass;
+}
+export declare const AssetManager: AssetManagerConstructor;
+export declare function createAssets(config: AssetsConfig): AssetManagerInstance;
+//# sourceMappingURL=asset-manager.d.ts.map

package/dist/asset-manager.d.ts.map

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