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

package/dist/asset-manager.js

@@ -0,0 +1,257 @@
+import { AssetBucket, } from './asset-bucket.js';
+import { AssetBucketConfigError, AssetBucketFetchError } from './errors.js';
+import { normalizeAssetContext } from './asset-context.js';
+import { cancelResponseBody } from './response-ownership.js';
+const DEFAULT_TTL = 3600;
+const IMMUTABLE_TTL = 31536000;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function trimSlashes(value) {
+    return value.replace(/^\/+|\/+$/g, '');
+}
+function normalizePrefix(prefix) {
+    if (!prefix)
+        return '';
+    const clean = trimSlashes(prefix);
+    return clean ? `${clean}/` : '';
+}
+function normalizeKey(key) {
+    const pathOnly = key.split('?')[0] ?? '';
+    return decodeURIComponent(pathOnly)
+        .replace(/^\/+/, '')
+        .replace(/\/+/g, '/');
+}
+function normalizeMethods(methods) {
+    return new Set(methods ?? ['GET', 'HEAD']);
+}
+function requestRelativePath(ctx) {
+    return normalizeAssetContext(ctx).path.relative;
+}
+function cacheControl(config) {
+    const ttl = config.ttl ?? DEFAULT_TTL;
+    const immutable = config.immutable ?? false;
+    if (immutable) {
+        const maxAge = ttl === false ? IMMUTABLE_TTL : ttl;
+        return `public, max-age=${maxAge}, immutable`;
+    }
+    if (ttl === false)
+        return undefined;
+    return `public, max-age=${ttl}`;
+}
+function applyCache(headers, config) {
+    const value = cacheControl(config);
+    if (value)
+        headers.set('cache-control', value);
+}
+function mimeType(path, overrides) {
+    const lower = path.toLowerCase();
+    const ext = lower.includes('.') ? lower.slice(lower.lastIndexOf('.') + 1) : '';
+    if (overrides?.[ext])
+        return overrides[ext];
+    switch (ext) {
+        case 'html': return 'text/html; charset=utf-8';
+        case 'css': return 'text/css; charset=utf-8';
+        case 'js':
+        case 'mjs': return 'text/javascript; charset=utf-8';
+        case 'json': return 'application/json; charset=utf-8';
+        case 'svg': return 'image/svg+xml';
+        case 'png': return 'image/png';
+        case 'jpg':
+        case 'jpeg': return 'image/jpeg';
+        case 'gif': return 'image/gif';
+        case 'webp': return 'image/webp';
+        case 'ico': return 'image/x-icon';
+        case 'txt': return 'text/plain; charset=utf-8';
+        case 'wasm': return 'application/wasm';
+        case 'woff': return 'font/woff';
+        case 'woff2': return 'font/woff2';
+        default: return undefined;
+    }
+}
+async function importNodeModule(specifier) {
+    return await import(specifier);
+}
+function validateMode(config) {
+    if (!isRecord(config)) {
+        throw new AssetBucketConfigError('AssetManager requires an assets config object');
+    }
+    if (config.mode !== 'local' && config.mode !== 'hosted' && config.mode !== 'bucket') {
+        throw new AssetBucketConfigError('AssetManager requires explicit mode: local, hosted, or bucket');
+    }
+}
+export class AssetManagerCore {
+    config;
+    bucket;
+    constructor(config) {
+        validateMode(config);
+        this.config = config;
+        if (config.mode === 'bucket') {
+            this.bucket = new AssetBucket(config);
+        }
+        else if (config.mode === 'local') {
+            if (!config.dir)
+                throw new AssetBucketConfigError('AssetManager local mode requires dir');
+        }
+        else if (config.mode === 'hosted') {
+            if (!config.origin)
+                throw new AssetBucketConfigError('AssetManager hosted mode requires origin');
+            try {
+                new URL(config.origin);
+            }
+            catch {
+                throw new AssetBucketConfigError(`AssetManager hosted mode requires a valid origin URL: ${config.origin}`);
+            }
+        }
+    }
+    async handle(ctx, next) {
+        switch (this.config.mode) {
+            case 'local': return await this.handleLocal(ctx, next);
+            case 'hosted': return await this.handleHosted(ctx, next);
+            case 'bucket': return await this.bucket.core.handle(ctx, next);
+            default: return await this.pass(next);
+        }
+    }
+    async resolveKey(ctx) {
+        if (this.config.mode === 'bucket') {
+            return await this.bucket.resolveKey(ctx);
+        }
+        const key = normalizeKey(requestRelativePath(ctx));
+        const prefix = normalizePrefix(this.config.prefix);
+        const joined = `${prefix}${key}`;
+        if (this.config.mode === 'local') {
+            if ((joined === '' || joined.endsWith('/')) && this.config.index !== false) {
+                return `${joined}${this.config.index ?? 'index.html'}`;
+            }
+        }
+        return joined;
+    }
+    allowed(method) {
+        return normalizeMethods(this.config.methods).has(method);
+    }
+    async handleLocal(ctx, next) {
+        const normalized = normalizeAssetContext(ctx);
+        const method = normalized.request.method.toUpperCase();
+        if (!this.allowed(method))
+            return await this.pass(next);
+        try {
+            const key = await this.resolveKey(ctx);
+            if (!key)
+                return await this.pass(next);
+            const { default: fs } = await importNodeModule('node:fs/promises');
+            const path = await importNodeModule('node:path');
+            const root = path.resolve(this.config.mode === 'local' ? this.config.dir : '.');
+            const target = path.resolve(root, key);
+            const separator = path.sep ?? '/';
+            if (target !== root && !target.startsWith(`${root}${separator}`)) {
+                return new Response('Forbidden', { status: 403 });
+            }
+            try {
+                const stat = await fs.stat(target);
+                if (!stat.isFile())
+                    return await this.handleMiss(next);
+            }
+            catch (cause) {
+                if (isNodeNotFound(cause))
+                    return await this.handleMiss(next);
+                throw cause;
+            }
+            const body = method === 'HEAD' ? null : await fs.readFile(target);
+            const headers = new Headers();
+            const type = mimeType(target, this.config.mode === 'local' ? this.config.contentTypes : undefined);
+            if (type)
+                headers.set('content-type', type);
+            applyCache(headers, this.config);
+            return new Response(body, { status: 200, headers });
+        }
+        catch (cause) {
+            if (this.config.passThroughOnError)
+                return await this.pass(next);
+            if (cause instanceof AssetBucketConfigError)
+                throw cause;
+            throw new AssetBucketFetchError('AssetManager failed to serve local asset', { cause });
+        }
+    }
+    async handleHosted(ctx, next) {
+        const config = this.config;
+        if (config.mode !== 'hosted')
+            return await this.pass(next);
+        const normalized = normalizeAssetContext(ctx);
+        const method = normalized.request.method.toUpperCase();
+        if (!this.allowed(method))
+            return await this.pass(next);
+        try {
+            const fetchImpl = config.fetch ?? globalThis.fetch;
+            if (typeof fetchImpl !== 'function') {
+                throw new AssetBucketConfigError('AssetManager hosted mode requires a fetch implementation');
+            }
+            const key = await this.resolveKey(ctx);
+            if (!key)
+                return await this.pass(next);
+            const url = new URL(config.origin.endsWith('/') ? config.origin : `${config.origin}/`);
+            url.pathname = joinUrlPath(url.pathname, key);
+            url.search = new URL(normalized.request.url).search;
+            const headers = new Headers(config.headers);
+            copyConditionalHeaders(normalized.request.headers, headers);
+            const upstream = await fetchImpl(new Request(url, { method, headers }));
+            if (upstream.status === 404 && (config.passThroughOn404 ?? true)) {
+                await cancelResponseBody(upstream);
+                return await this.pass(next);
+            }
+            const responseHeaders = new Headers(upstream.headers);
+            applyCache(responseHeaders, this.config);
+            if (method === 'HEAD')
+                await cancelResponseBody(upstream);
+            return new Response(method === 'HEAD' ? null : upstream.body, {
+                status: upstream.status,
+                statusText: upstream.statusText,
+                headers: responseHeaders,
+            });
+        }
+        catch (cause) {
+            if (this.config.passThroughOnError)
+                return await this.pass(next);
+            if (cause instanceof AssetBucketConfigError)
+                throw cause;
+            throw new AssetBucketFetchError('AssetManager failed to fetch hosted asset', { cause });
+        }
+    }
+    async handleMiss(next) {
+        if (this.config.passThroughOn404 ?? true)
+            return await this.pass(next);
+        return new Response('Not Found', { status: 404 });
+    }
+    async pass(next) {
+        return next ? await next() : undefined;
+    }
+}
+function isNodeNotFound(error) {
+    return isRecord(error) && error.code === 'ENOENT';
+}
+function joinUrlPath(...parts) {
+    return `/${parts.map((part) => trimSlashes(part)).filter(Boolean).join('/')}`;
+}
+function copyConditionalHeaders(source, target) {
+    for (const name of ['range', 'if-match', 'if-none-match', 'if-modified-since', 'if-unmodified-since']) {
+        const value = source.get(name);
+        if (value !== null)
+            target.set(name, value);
+    }
+}
+function createAssetManager(config) {
+    const core = new AssetManagerCore(config);
+    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 AssetManager = function AssetManager(config) {
+    return createAssetManager(config);
+};
+export function createAssets(config) {
+    return createAssetManager(config);
+}
+//# sourceMappingURL=asset-manager.js.map

package/dist/asset-manager.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class AssetBucketConfigError extends Error {
+    constructor(message: string);
+}
+export declare class AssetBucketSignError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class AssetBucketFetchError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAO3D;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAO3D"}

package/dist/errors.js

@@ -0,0 +1,25 @@
+export class AssetBucketConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AssetBucketConfigError";
+    }
+}
+export class AssetBucketSignError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = "AssetBucketSignError";
+        if (options?.cause !== undefined) {
+            this.cause = options.cause;
+        }
+    }
+}
+export class AssetBucketFetchError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = "AssetBucketFetchError";
+        if (options?.cause !== undefined) {
+            this.cause = options.cause;
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { AssetBucket, AssetBucketCore, type AssetBucketConstructor, type AssetBucketContext, type AssetBucketInstance, type AssetBucketMethod, type AssetBucketMiddleware, type AssetBucketOptions, type AssetBucketResponseContext, type AssetBucketRouteContext, type AssetBucketSigner, type AssetBucketSignerInput, type LegacyAssetBucketRouteContext, type RouteNext, } from './asset-bucket.js';
+export { AssetBucketConfigError, AssetBucketFetchError, AssetBucketSignError, } from './errors.js';
+export { encodeS3Key, signSigV4, type SecretValue, type SigV4Credentials, type SigV4SignOptions, } from './sigv4.js';
+export { AssetManager, AssetManagerCore, createAssets, type AssetCacheOptions, type AssetManagerConstructor, type AssetManagerInstance, type AssetManagerMiddleware, type AssetsConfig, type BucketAssetsConfig, type HostedAssetsConfig, type LocalAssetsConfig, } from './asset-manager.js';
+export { assets, lookup, respond, type AssetLookup, type AssetLookupEffect, type AssetLookupMethod, type AssetLookupOptions, type AssetResponseOptions, } from './portable.js';
+export { assets as default } from './portable.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { AssetBucket, AssetBucketCore, } from './asset-bucket.js';
+export { AssetBucketConfigError, AssetBucketFetchError, AssetBucketSignError, } from './errors.js';
+export { encodeS3Key, signSigV4, } from './sigv4.js';
+export { AssetManager, AssetManagerCore, createAssets, } from './asset-manager.js';
+export { assets, lookup, respond, } from './portable.js';
+export { assets as default } from './portable.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,GAahB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,SAAS,GAIV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,GASb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,MAAM,EACN,MAAM,EACN,OAAO,GAMR,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/internal/package-runtime.d.ts

@@ -0,0 +1,9 @@
+import packageRuntime from '@pulse-compute/runtime/package';
+export declare const pulseAssetsRuntime: packageRuntime.PulsePackageRuntime<{
+    readonly lookup: {
+        readonly kind: "assets.lookup";
+        readonly capability: "assets.lookup";
+        readonly result: "asset";
+    };
+}>;
+//# sourceMappingURL=package-runtime.d.ts.map

package/dist/internal/package-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/package-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,gCAAgC,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;EAWpB,CAAC"}

package/dist/internal/package-runtime.js

@@ -0,0 +1,14 @@
+import packageRuntime from '@pulse-compute/runtime/package';
+export const pulseAssetsRuntime = packageRuntime.createPackageRuntime({
+    package: '@pulse-compute/assets',
+    contractId: 'pulse.assets',
+    providerKind: 'assets',
+    operations: {
+        lookup: {
+            kind: 'assets.lookup',
+            capability: 'assets.lookup',
+            result: 'asset',
+        },
+    },
+});
+//# sourceMappingURL=package-runtime.js.map

package/dist/internal/package-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-runtime.js","sourceRoot":"","sources":["../../src/internal/package-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,gCAAgC,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC,oBAAoB,CAAC;IACpE,OAAO,EAAE,uBAAuB;IAChC,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,eAAe;YACrB,UAAU,EAAE,eAAe;YAC3B,MAAM,EAAE,OAAO;SAChB;KACF;CACO,CAAC,CAAC"}

package/dist/portable.d.ts

@@ -0,0 +1,33 @@
+import type { PulseContext, PulseParallelEffect } from '@pulse-compute/runtime';
+export type AssetLookupMethod = 'GET' | 'HEAD';
+export type AssetLookupOptions = {
+    readonly method?: AssetLookupMethod | undefined;
+    readonly headers?: HeadersInit | undefined;
+    readonly passThroughOn404?: boolean | undefined;
+    readonly cacheControl?: string | undefined;
+    /** Native lowering payload ownership selector. JavaScript providers may ignore it. */
+    readonly payloadMode?: 'text-response-body' | 'stream-pass-through-response' | undefined;
+};
+export type AssetResponseOptions = {
+    readonly status?: number | undefined;
+    readonly headers?: HeadersInit | undefined;
+};
+export type AssetLookup = Response;
+export type AssetLookupEffect = PulseParallelEffect<AssetLookup>;
+/**
+ * Request-bound, provider-owned asset lookup. The explicit context binds the
+ * effect to the active Pulse request and makes the value safe for direct await
+ * or keyed ctx.parallel({ ... }) execution.
+ */
+export declare function lookup(ctx: PulseContext, store: string, key: string, options?: AssetLookupOptions): AssetLookupEffect;
+/**
+ * Pure response adoption/decorating helper. With no overrides, the provider
+ * Response is returned by identity so a host-owned stream can pass through.
+ */
+export declare function respond(asset: AssetLookup, options?: AssetResponseOptions): Response;
+export declare const assets: Readonly<{
+    lookup: typeof lookup;
+    respond: typeof respond;
+}>;
+export default assets;
+//# sourceMappingURL=portable.d.ts.map

package/dist/portable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable.d.ts","sourceRoot":"","sources":["../src/portable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGhF,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,sFAAsF;IACtF,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,8BAA8B,GAAG,SAAS,CAAC;CAC1F,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AACnC,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAqDjE;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,kBAAkB,GAC3B,iBAAiB,CAWnB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAmBpF;AAED,eAAO,MAAM,MAAM;;;EAAqC,CAAC;AACzD,eAAe,MAAM,CAAC"}

package/dist/portable.js

@@ -0,0 +1,98 @@
+import { pulseAssetsRuntime } from './internal/package-runtime.js';
+function requireNonEmpty(label, value) {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new TypeError(`Pulse ${label} must be a non-empty string.`);
+    }
+    return value;
+}
+function normalizedHeaderPairs(headers) {
+    if (headers === undefined)
+        return undefined;
+    const pairs = [];
+    if (Array.isArray(headers)) {
+        for (const entry of headers) {
+            if (!Array.isArray(entry) || entry.length !== 2) {
+                throw new TypeError('Pulse asset headers must be [name, value] pairs.');
+            }
+            pairs.push(Object.freeze([String(entry[0]), String(entry[1])]));
+        }
+    }
+    else if (headers instanceof Headers) {
+        for (const [name, value] of headers.entries())
+            pairs.push(Object.freeze([name, value]));
+    }
+    else {
+        for (const [name, value] of Object.entries(headers))
+            pairs.push(Object.freeze([name, String(value)]));
+    }
+    return Object.freeze(pairs);
+}
+function normalizeLookupOptions(options) {
+    if (options === undefined)
+        return Object.freeze({});
+    const method = options.method === undefined ? 'GET' : String(options.method).toUpperCase();
+    if (method !== 'GET' && method !== 'HEAD') {
+        throw new TypeError('Pulse asset lookup method must be GET or HEAD.');
+    }
+    return Object.freeze({
+        method,
+        ...(options.headers === undefined ? {} : { headers: normalizedHeaderPairs(options.headers) }),
+        ...(options.passThroughOn404 === undefined ? {} : { passThroughOn404: Boolean(options.passThroughOn404) }),
+        ...(options.cacheControl === undefined ? {} : { cacheControl: String(options.cacheControl) }),
+        ...(options.payloadMode === undefined ? {} : { payloadMode: String(options.payloadMode) }),
+    });
+}
+function normalizeAssetResult(value) {
+    if (!(value instanceof Response)) {
+        throw new TypeError('Pulse assets.lookup providers must return a Web Response.');
+    }
+    return value;
+}
+function responseBodyAllowed(status) {
+    return status !== 204 && status !== 205 && status !== 304;
+}
+/**
+ * Request-bound, provider-owned asset lookup. The explicit context binds the
+ * effect to the active Pulse request and makes the value safe for direct await
+ * or keyed ctx.parallel({ ... }) execution.
+ */
+export function lookup(ctx, store, key, options) {
+    const normalized = normalizeLookupOptions(options);
+    return pulseAssetsRuntime.effect(ctx, 'lookup', {
+        store: requireNonEmpty('asset store', store),
+        key: requireNonEmpty('asset key', key),
+        method: normalized.method ?? 'GET',
+        ...(normalized.headers === undefined ? {} : { headers: normalized.headers }),
+        ...(normalized.passThroughOn404 === undefined ? {} : { passThroughOn404: normalized.passThroughOn404 }),
+        ...(normalized.cacheControl === undefined ? {} : { cacheControl: normalized.cacheControl }),
+        ...(normalized.payloadMode === undefined ? {} : { payloadMode: normalized.payloadMode }),
+    }, normalizeAssetResult);
+}
+/**
+ * Pure response adoption/decorating helper. With no overrides, the provider
+ * Response is returned by identity so a host-owned stream can pass through.
+ */
+export function respond(asset, options) {
+    if (!(asset instanceof Response)) {
+        throw new TypeError('Pulse assets.respond requires the Response produced by assets.lookup.');
+    }
+    if (options === undefined || (options.status === undefined && options.headers === undefined))
+        return asset;
+    const headers = new Headers(asset.headers);
+    if (options.headers !== undefined) {
+        for (const [name, value] of normalizedHeaderPairs(options.headers) ?? [])
+            headers.append(name, value);
+    }
+    const status = options.status === undefined ? asset.status : Number(options.status);
+    if (!Number.isInteger(status) || status < 200 || status > 599) {
+        throw new TypeError('Pulse assets.respond status must be an integer from 200 through 599.');
+    }
+    return new Response(responseBodyAllowed(status) ? asset.body : null, {
+        status,
+        statusText: asset.statusText,
+        headers,
+    });
+}
+export const assets = Object.freeze({ lookup, respond });
+export default assets;
+//# sourceMappingURL=portable.js.map

package/dist/portable.js.map

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

package/dist/pulsewasm-compiler-types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Type-only documentation for the package-owned PulseWasm compiler builder.
+ *
+ * Normal @pulse-compute/assets users do not import this module. The CommonJS
+ * builder entry lives at ../pulsewasm.compiler.cjs so package-out tooling can
+ * load it without adding TypeScript to the runtime dependency graph.
+ */
+export type PulseWasmAssetsCompilerBuilderInput = {
+    readonly sourceFile: unknown;
+    readonly typescript: unknown;
+    readonly manifest: unknown;
+    readonly manifestRecords?: readonly unknown[] | undefined;
+    readonly libraryContracts?: readonly unknown[] | undefined;
+    readonly cwd?: string | undefined;
+    readonly workspaceRoot?: string | undefined;
+    readonly generatedBy?: string | undefined;
+};
+export type PulseWasmAssetsCompilerBuilderResult = {
+    readonly artifact: unknown;
+    readonly diagnostics: readonly unknown[];
+    readonly unsupported: readonly unknown[];
+    readonly entries: readonly unknown[];
+    readonly payloadModes: unknown;
+    readonly hasErrors: boolean;
+};
+//# sourceMappingURL=pulsewasm-compiler-types.d.ts.map

package/dist/pulsewasm-compiler-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulsewasm-compiler-types.d.ts","sourceRoot":"","sources":["../src/pulsewasm-compiler-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC"}

package/dist/pulsewasm-compiler-types.js

@@ -0,0 +1,9 @@
+/**
+ * Type-only documentation for the package-owned PulseWasm compiler builder.
+ *
+ * Normal @pulse-compute/assets users do not import this module. The CommonJS
+ * builder entry lives at ../pulsewasm.compiler.cjs so package-out tooling can
+ * load it without adding TypeScript to the runtime dependency graph.
+ */
+export {};
+//# sourceMappingURL=pulsewasm-compiler-types.js.map

package/dist/pulsewasm-compiler-types.js.map

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

package/dist/pulsewasm.d.ts

@@ -0,0 +1,35 @@
+/**
+ * PulseWasm lowerable facade for @pulse-compute/assets.
+ *
+ * This module is the public package-owned lowering facade. PulseWasm compilers may recognize these symbols
+ * statically and lower them to the internal `pulse.assets` library contract.
+ * They are not a JavaScript asset runtime.
+ */
+export type AssetLookupMethod = 'GET' | 'HEAD';
+export type AssetLookupOptions = {
+    readonly method?: AssetLookupMethod | undefined;
+    readonly headers?: HeadersInit | undefined;
+    readonly passThroughOn404?: boolean | undefined;
+    readonly cacheControl?: string | undefined;
+};
+export type AssetLookup = {
+    readonly kind: 'pulse.assets.lookup';
+    readonly store: string;
+    readonly key: string;
+    readonly options?: AssetLookupOptions | undefined;
+};
+export type AssetResponseOptions = {
+    readonly status?: number | undefined;
+    readonly headers?: HeadersInit | undefined;
+};
+export declare class PulseWasmAssetsLoweringError extends Error {
+    constructor(symbol: string);
+}
+export declare function lookup(store: string, key: string, options?: AssetLookupOptions): AssetLookup;
+export declare function respond(asset: AssetLookup, options?: AssetResponseOptions): Response;
+export declare const assets: Readonly<{
+    lookup: typeof lookup;
+    respond: typeof respond;
+}>;
+export default assets;
+//# sourceMappingURL=pulsewasm.d.ts.map

package/dist/pulsewasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulsewasm.d.ts","sourceRoot":"","sources":["../src/pulsewasm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,MAAM,EAAE,MAAM;CAO3B;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAK5F;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAIpF;AAED,eAAO,MAAM,MAAM;;;EAGjB,CAAC;AAEH,eAAe,MAAM,CAAC"}