@relkit/providers-standard 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @relkit/providers-standard
+
+Standard provider adapters for RELKIT applications.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/factories.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderFactories } from "@relkit/engine";
+export declare const standardProviderFactories: ProviderFactories;
+//# sourceMappingURL=factories.d.ts.map

package/dist/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../src/factories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAA2C,MAAM,gBAAgB,CAAC;AA8DjG,eAAO,MAAM,yBAAyB,EAAE,iBAItC,CAAC"}

package/dist/factories.js

@@ -0,0 +1,97 @@
+import { createModelProviderRegistry } from "@relkit/agents";
+import { createRedisCacheProvider } from "./redis.js";
+import { createS3BucketProvider } from "./s3.js";
+const s3Factory = Object.freeze({
+    capability: "buckets",
+    adapter: "s3",
+    create: (context) => {
+        const configuration = context.configuration;
+        const credentials = s3Credentials(record(configuration.credentials));
+        const provider = createS3BucketProvider({
+            endpoint: urlText(configuration.endpoint, "S3 endpoint"),
+            bucketName: text(configuration.bucketName, "S3 bucketName"),
+            region: text(configuration.region, "S3 region"),
+            ...(credentials === undefined ? {} : { credentials }),
+            ...(configuration.forcePathStyle === undefined
+                ? {}
+                : { forcePathStyle: boolean(configuration.forcePathStyle, "S3 forcePathStyle") }),
+            ...(configuration.signedUrlTtlSeconds === undefined
+                ? {}
+                : {
+                    signedUrlTtlSeconds: integer(configuration.signedUrlTtlSeconds, "S3 signedUrlTtlSeconds"),
+                }),
+        });
+        return Object.freeze({ value: provider });
+    },
+});
+const redisFactory = Object.freeze({
+    capability: "cache",
+    adapter: "redis",
+    create: (context) => {
+        const provider = createRedisCacheProvider({
+            url: text(context.configuration.url, "Redis URL"),
+            cacheId: context.profile,
+            ...(context.configuration.connectionTimeoutMs === undefined
+                ? {}
+                : {
+                    connectionTimeoutMs: integer(context.configuration.connectionTimeoutMs, "Redis connectionTimeoutMs"),
+                }),
+        });
+        return Object.freeze({ value: provider, ready: provider.ready, release: provider.close });
+    },
+});
+const modelsFactory = Object.freeze({
+    capability: "models",
+    adapter: "ai-sdk",
+    create: async (context) => {
+        const modelRegistry = await createModelProviderRegistry({
+            configuration: context.configuration,
+        });
+        return Object.freeze({ modelRegistry });
+    },
+});
+export const standardProviderFactories = Object.freeze({
+    "buckets:s3": s3Factory,
+    "cache:redis": redisFactory,
+    "models:ai-sdk": modelsFactory,
+});
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function s3Credentials(value) {
+    if (value === undefined)
+        return undefined;
+    const accessKeyId = optionalText(value.accessKeyId, "S3 accessKeyId");
+    const secretAccessKey = optionalText(value.secretAccessKey, "S3 secretAccessKey");
+    const sessionToken = optionalText(value.sessionToken, "S3 sessionToken");
+    if (accessKeyId === undefined && secretAccessKey === undefined && sessionToken === undefined)
+        return undefined;
+    if (accessKeyId === undefined || secretAccessKey === undefined) {
+        throw new TypeError("S3 credentials require both accessKeyId and secretAccessKey");
+    }
+    return { accessKeyId, secretAccessKey, ...(sessionToken === undefined ? {} : { sessionToken }) };
+}
+function optionalText(value, label) {
+    return value === undefined ? undefined : text(value, label);
+}
+function urlText(value, label) {
+    return value instanceof URL ? value.toString() : text(value, label);
+}
+function text(value, label) {
+    if (typeof value !== "string" || value.trim() === "")
+        throw new TypeError(`${label} is invalid`);
+    return value.trim();
+}
+function boolean(value, label) {
+    if (typeof value !== "boolean")
+        throw new TypeError(`${label} is invalid`);
+    return value;
+}
+function integer(value, label) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new TypeError(`${label} is invalid`);
+    return value;
+}
+//# sourceMappingURL=factories.js.map

package/dist/factories.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./factories.js";
+export * from "./redis.js";
+export * from "./redis-client.js";
+export * from "./s3.js";
+export type * from "./signing.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,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,mBAAmB,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./factories.js";
+export * from "./redis.js";
+export * from "./redis-client.js";
+export * from "./s3.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,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/redis-client.d.ts

@@ -0,0 +1,20 @@
+export interface StandardRedisClientOptions {
+    readonly url: string;
+    readonly connectionTimeoutMs?: number;
+}
+export interface StandardRedisClient {
+    readonly connected: boolean;
+    connect(): Promise<void>;
+    close(): void;
+    ping(): Promise<boolean>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<number>;
+    has(key: string): Promise<boolean>;
+    increment(key: string, amount?: number): Promise<number>;
+    scan(cursor: string, pattern: string, count: number): Promise<readonly [string, readonly string[]]>;
+    type(key: string): Promise<string>;
+    ttl(key: string): Promise<number>;
+}
+export declare function createRedisClient(options: StandardRedisClientOptions): StandardRedisClient;
+//# sourceMappingURL=redis-client.d.ts.map

package/dist/redis-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-client.d.ts","sourceRoot":"","sources":["../src/redis-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CACF,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CA+C1F"}

package/dist/redis-client.js

@@ -0,0 +1,60 @@
+import { RedisClient } from "bun";
+export function createRedisClient(options) {
+    const url = validateUrl(options.url);
+    if (options.connectionTimeoutMs !== undefined &&
+        (!Number.isSafeInteger(options.connectionTimeoutMs) || options.connectionTimeoutMs < 1)) {
+        throw new RangeError("Redis connectionTimeoutMs must be a positive integer");
+    }
+    const client = new RedisClient(url, {
+        tls: url.startsWith("rediss://"),
+        ...(options.connectionTimeoutMs === undefined
+            ? {}
+            : { connectionTimeout: options.connectionTimeoutMs }),
+    });
+    return {
+        get connected() {
+            return client.connected;
+        },
+        connect: () => client.connect(),
+        close: () => client.close(),
+        ping: async () => String(await client.send("PING", [])) === "PONG",
+        get: (key) => client.get(key),
+        set: async (key, value, ttlMs) => {
+            if (ttlMs === undefined)
+                await client.set(key, value);
+            else {
+                if (!Number.isSafeInteger(ttlMs) || ttlMs < 1) {
+                    throw new RangeError("Redis ttlMs must be a positive integer");
+                }
+                await client.set(key, value, "PX", ttlMs);
+            }
+        },
+        delete: (key) => client.del(key),
+        has: (key) => client.exists(key),
+        increment: (key, amount = 1) => {
+            if (!Number.isSafeInteger(amount))
+                throw new RangeError("Redis increment must be an integer");
+            return client.incrby(key, amount);
+        },
+        scan: async (cursor, pattern, count) => {
+            const result = await client.send("SCAN", [cursor, "MATCH", pattern, "COUNT", String(count)]);
+            if (!Array.isArray(result) || result.length !== 2 || !Array.isArray(result[1])) {
+                throw new Error("Redis SCAN returned an invalid response");
+            }
+            return [String(result[0]), result[1].map(String)];
+        },
+        type: async (key) => String(await client.send("TYPE", [key])),
+        ttl: async (key) => Number(await client.send("PTTL", [key])),
+    };
+}
+function validateUrl(value) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new TypeError("Redis URL must not be empty");
+    }
+    const url = new URL(value);
+    if (url.protocol !== "redis:" && url.protocol !== "rediss:") {
+        throw new TypeError("Redis URL must use redis:// or rediss://");
+    }
+    return value;
+}
+//# sourceMappingURL=redis-client.js.map

package/dist/redis-client.js.map

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

package/dist/redis.d.ts

@@ -0,0 +1,30 @@
+import type { CacheProvider } from "@relkit/cache";
+import { type StandardRedisClient } from "./redis-client.js";
+export interface RedisCacheOptions {
+    readonly url: string;
+    readonly cacheId: string;
+    readonly connectionTimeoutMs?: number;
+    readonly client?: StandardRedisClient;
+}
+export interface RedisCacheProvider extends CacheProvider {
+    readonly ready: () => Promise<void>;
+    readonly close: () => Promise<void>;
+    readonly inspector: {
+        readonly scan: (request: {
+            readonly search?: string;
+            readonly cursor?: string;
+            readonly limit: number;
+            readonly signal: AbortSignal;
+        }) => Promise<{
+            readonly items: readonly unknown[];
+            readonly nextCursor?: string;
+        }>;
+        readonly value: (request: {
+            readonly key: string;
+            readonly limit: number;
+            readonly signal: AbortSignal;
+        }) => Promise<unknown | undefined>;
+    };
+}
+export declare function createRedisCacheProvider(options: RedisCacheOptions): RedisCacheProvider;
+//# sourceMappingURL=redis.d.ts.map

package/dist/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgD,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjG,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE;YACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;SAC9B,KAAK,OAAO,CAAC;YAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;YAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpF,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE;YACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;SAC9B,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;KACpC,CAAC;CACH;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB,CAyHvF"}

package/dist/redis.js

@@ -0,0 +1,123 @@
+import { canonicalJson } from "@relkit/contracts";
+import { createRedisClient } from "./redis-client.js";
+export function createRedisCacheProvider(options) {
+    const client = options.client ??
+        createRedisClient({
+            url: options.url,
+            ...(options.connectionTimeoutMs === undefined
+                ? {}
+                : { connectionTimeoutMs: options.connectionTimeoutMs }),
+        });
+    const flights = new Map();
+    const encoded = (key) => `${options.cacheId}:${canonicalJson(key)}`;
+    const connect = async () => {
+        if (!client.connected)
+            await client.connect();
+        return client;
+    };
+    const get = async (key, context) => {
+        check(context);
+        const value = await (await connect()).get(encoded(key));
+        return value === null ? undefined : JSON.parse(value);
+    };
+    const set = async (key, value, settings, context) => {
+        check(context);
+        await (await connect()).set(encoded(key), canonicalJson(value), settings?.ttlMs);
+    };
+    const remove = async (key, context) => {
+        check(context);
+        await (await connect()).delete(encoded(key));
+    };
+    const increment = async (key, amount = 1, settings, context) => {
+        check(context);
+        const value = await (await connect()).increment(encoded(key), amount);
+        if (settings?.ttlMs !== undefined) {
+            await (await connect()).set(encoded(key), String(value), settings.ttlMs);
+        }
+        return value;
+    };
+    const getOrSet = async (key, produce, settings, context) => {
+        const cached = await get(key, context);
+        if (cached !== undefined)
+            return cached;
+        const cacheKey = encoded(key);
+        const existing = flights.get(cacheKey);
+        if (existing !== undefined)
+            return existing;
+        const flight = Promise.resolve(produce()).then(async (value) => {
+            await set(key, value, settings, context);
+            return value;
+        });
+        flights.set(cacheKey, flight);
+        try {
+            return await flight;
+        }
+        finally {
+            if (flights.get(cacheKey) === flight)
+                flights.delete(cacheKey);
+        }
+    };
+    const inspector = Object.freeze({
+        scan: async (request) => {
+            check({ operation: "get", signal: request.signal });
+            const redis = await connect();
+            const pattern = `${options.cacheId}:*${redisPattern(request.search ?? "")}*`;
+            const [nextCursor, keys] = await redis.scan(request.cursor ?? "0", pattern, request.limit);
+            const items = await Promise.all(keys.slice(0, request.limit).map(async (key) => ({
+                key: key.slice(options.cacheId.length + 1),
+                type: await redis.type(key),
+                ttlMs: normalizeTtl(await redis.ttl(key)),
+                bytes: new TextEncoder().encode((await redis.get(key)) ?? "").byteLength,
+            })));
+            return { items, ...(nextCursor === "0" ? {} : { nextCursor }) };
+        },
+        value: async (request) => {
+            check({ operation: "get", signal: request.signal });
+            const redis = await connect();
+            const key = `${options.cacheId}:${request.key}`;
+            const value = await redis.get(key);
+            if (value === null)
+                return undefined;
+            const bytes = new TextEncoder().encode(value).byteLength;
+            return {
+                key: request.key,
+                type: await redis.type(key),
+                ttlMs: normalizeTtl(await redis.ttl(key)),
+                bytes,
+                ...(bytes > request.limit
+                    ? { truncated: true }
+                    : { value: JSON.parse(value), truncated: false }),
+            };
+        },
+    });
+    return Object.freeze({
+        capabilities: Object.freeze({ increment: true }),
+        get,
+        set,
+        delete: remove,
+        has: async (key, context) => (await get(key, context)) !== undefined,
+        getOrSet,
+        increment,
+        inspector,
+        ready: async () => {
+            check(undefined);
+            if (!(await (await connect()).ping()))
+                throw new Error("Redis readiness check failed");
+        },
+        close: async () => {
+            flights.clear();
+            client.close();
+        },
+    });
+}
+function redisPattern(value) {
+    return value.replace(/[\\*?\[\]]/g, "\\$&");
+}
+function normalizeTtl(value) {
+    return value < 0 ? null : value;
+}
+function check(context) {
+    if (context?.signal.aborted)
+        throw context.signal.reason ?? new Error("Cache operation cancelled");
+}
+//# sourceMappingURL=redis.js.map

package/dist/redis.js.map

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

package/dist/s3-url.d.ts

@@ -0,0 +1,4 @@
+export declare function objectUrl(endpoint: string, bucket: string, key: string, pathStyle: boolean): string;
+export declare function endpointFor(value: string): string;
+export declare function requiredText(value: unknown, label: string): string;
+//# sourceMappingURL=s3-url.d.ts.map

package/dist/s3-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-url.d.ts","sourceRoot":"","sources":["../src/s3-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,OAAO,GACjB,MAAM,CAUR;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlE"}

package/dist/s3-url.js

@@ -0,0 +1,29 @@
+export function objectUrl(endpoint, bucket, key, pathStyle) {
+    const parsed = new URL(endpoint);
+    const keySuffix = key === "" ? "" : `/${keyPath(key)}`;
+    if (pathStyle) {
+        parsed.pathname = `${parsed.pathname.replace(/\/$/, "")}/${encodeURIComponent(bucket)}${keySuffix}`;
+    }
+    else {
+        parsed.hostname = `${bucket}.${parsed.hostname}`;
+        parsed.pathname = `${parsed.pathname.replace(/\/$/, "")}${keySuffix || "/"}`;
+    }
+    return parsed.toString().replace(/\/$/, key === "" ? "/" : "");
+}
+export function endpointFor(value) {
+    const endpoint = requiredText(value, "S3 endpoint");
+    const parsed = new URL(endpoint);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new TypeError("S3 endpoint must use http or https");
+    }
+    return parsed.toString().replace(/\/$/, "");
+}
+export function requiredText(value, label) {
+    if (typeof value !== "string" || value.trim() === "")
+        throw new TypeError(`${label} is invalid`);
+    return value.trim();
+}
+function keyPath(value) {
+    return value.split("/").map(encodeURIComponent).join("/");
+}
+//# sourceMappingURL=s3-url.js.map

package/dist/s3-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-url.js","sourceRoot":"","sources":["../src/s3-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,MAAc,EACd,GAAW,EACX,SAAkB;IAElB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,QAAQ,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtG,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,QAAQ,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjD,MAAM,CAAC,QAAQ,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAa;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/dist/s3-xml.d.ts

@@ -0,0 +1,4 @@
+export declare function decodeS3Xml(value: string): string;
+export declare function s3XmlValue(xml: string, name: string): string | undefined;
+export declare function s3ErrorDetail(body: string): string | undefined;
+//# sourceMappingURL=s3-xml.d.ts.map

package/dist/s3-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-xml.d.ts","sourceRoot":"","sources":["../src/s3-xml.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB9D"}

package/dist/s3-xml.js

@@ -0,0 +1,25 @@
+export function decodeS3Xml(value) {
+    return value.replaceAll("&amp;", "&").replaceAll("&lt;", "<").replaceAll("&gt;", ">");
+}
+export function s3XmlValue(xml, name) {
+    return new RegExp(`<${name}>([\\s\\S]*?)<\\/${name}>`).exec(xml)?.[1];
+}
+export function s3ErrorDetail(body) {
+    const xml = [s3XmlValue(body, "Code"), s3XmlValue(body, "Message")]
+        .filter((value) => value !== undefined)
+        .map(decodeS3Xml);
+    if (xml.length > 0)
+        return xml.join(": ").slice(0, 500);
+    const text = body.trim().replace(/\s+/g, " ");
+    if (text === "")
+        return undefined;
+    try {
+        const value = JSON.parse(text);
+        const detail = [value.code, value.message, value.error].find((entry) => typeof entry === "string" && entry.trim() !== "");
+        return detail?.slice(0, 500) ?? text.slice(0, 500);
+    }
+    catch {
+        return text.slice(0, 500);
+    }
+}
+//# sourceMappingURL=s3-xml.js.map

package/dist/s3-xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-xml.js","sourceRoot":"","sources":["../src/s3-xml.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY;IAClD,OAAO,IAAI,MAAM,CAAC,IAAI,IAAI,oBAAoB,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;SAChE,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SACvD,GAAG,CAAC,WAAW,CAAC,CAAC;IACpB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QAC1D,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAC1D,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAC7E,CAAC;QACF,OAAO,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/s3.d.ts

@@ -0,0 +1,36 @@
+import type { BucketProvider } from "@relkit/buckets";
+import { type S3Credentials } from "./signing.js";
+export interface S3BucketOptions {
+    readonly endpoint: string;
+    readonly bucketName: string;
+    readonly region: string;
+    readonly credentials?: S3Credentials;
+    readonly forcePathStyle?: boolean;
+    readonly signedUrlTtlSeconds?: number;
+    readonly fetch?: typeof globalThis.fetch;
+}
+export interface S3BucketProvider extends BucketProvider {
+    readonly inspector: {
+        readonly list: (request: {
+            readonly prefix?: string;
+            readonly cursor?: string;
+            readonly limit: number;
+            readonly signal: AbortSignal;
+        }) => Promise<{
+            readonly items: readonly unknown[];
+            readonly nextCursor?: string;
+        }>;
+        readonly preview: (request: {
+            readonly key: string;
+            readonly offset: number;
+            readonly limit: number;
+            readonly signal: AbortSignal;
+        }) => Promise<{
+            readonly bytes: Uint8Array;
+            readonly metadata: unknown;
+            readonly totalBytes: number;
+        } | undefined>;
+    };
+}
+export declare function createS3BucketProvider(options: S3BucketOptions): S3BucketProvider;
+//# sourceMappingURL=s3.d.ts.map

package/dist/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../src/s3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,cAAc,EAAoB,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE;YACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;SAC9B,KAAK,OAAO,CAAC;YAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;YAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpF,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;YAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;SAC9B,KAAK,OAAO,CACT;YAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;YAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;SAAE,GACvF,SAAS,CACZ,CAAC;KACH,CAAC;CACH;AACD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAuJjF"}

package/dist/s3.js

@@ -0,0 +1,139 @@
+import { assertResponse, presignS3Url, signedRequest, } from "./signing.js";
+import { decodeS3Xml, s3XmlValue } from "./s3-xml.js";
+import { endpointFor, objectUrl, requiredText } from "./s3-url.js";
+export function createS3BucketProvider(options) {
+    const endpoint = endpointFor(options.endpoint);
+    const bucket = requiredText(options.bucketName, "S3 bucketName");
+    const region = requiredText(options.region, "S3 region");
+    const forcePathStyle = options.forcePathStyle ?? false;
+    const expires = options.signedUrlTtlSeconds ?? 900;
+    if (!Number.isSafeInteger(expires) || expires < 1 || expires > 604_800) {
+        throw new RangeError("S3 signedUrlTtlSeconds must be between 1 and 604800");
+    }
+    const url = (key = "") => objectUrl(endpoint, bucket, key, forcePathStyle);
+    const request = (key, init, context) => signedRequest(url(key), {
+        region,
+        ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+        init: { ...init, ...(context === undefined ? {} : { signal: context.signal }) },
+    });
+    const inspector = Object.freeze({
+        list: async (input) => {
+            const listUrl = new URL(url());
+            listUrl.searchParams.set("list-type", "2");
+            listUrl.searchParams.set("max-keys", String(input.limit));
+            if (input.prefix !== undefined)
+                listUrl.searchParams.set("prefix", input.prefix);
+            if (input.cursor !== undefined)
+                listUrl.searchParams.set("continuation-token", input.cursor);
+            const response = await signedRequest(listUrl.toString(), {
+                region,
+                ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
+                ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+                init: { method: "GET", signal: input.signal },
+            });
+            await assertResponse(response, "S3 inspector list");
+            const xml = await response.text();
+            const items = [...xml.matchAll(/<Contents>([\s\S]*?)<\/Contents>/g)].map((match) => ({
+                key: decodeS3Xml(s3XmlValue(match[1], "Key") ?? ""),
+                size: Number(s3XmlValue(match[1], "Size") ?? 0),
+                etag: (s3XmlValue(match[1], "ETag") ?? "").replaceAll('"', ""),
+                lastModified: s3XmlValue(match[1], "LastModified") ?? undefined,
+            }));
+            const nextCursor = s3XmlValue(xml, "NextContinuationToken");
+            return {
+                items,
+                ...(nextCursor === undefined ? {} : { nextCursor: decodeS3Xml(nextCursor) }),
+            };
+        },
+        preview: async (input) => {
+            const response = await request(input.key, {
+                method: "GET",
+                headers: { range: `bytes=${input.offset}-${input.offset + input.limit - 1}` },
+            }, { operation: "get", signal: input.signal });
+            if (response.status === 404)
+                return undefined;
+            await assertResponse(response, "S3 inspector preview");
+            const range = response.headers.get("content-range")?.match(/\/(\d+)$/);
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            return {
+                bytes,
+                totalBytes: range === undefined || range === null ? bytes.byteLength : Number(range[1]),
+                metadata: {
+                    contentType: response.headers.get("content-type") ?? "application/octet-stream",
+                    etag: response.headers.get("etag")?.replaceAll('"', "") ?? "",
+                },
+            };
+        },
+    });
+    return Object.freeze({
+        capabilities: Object.freeze({ signedReadUrl: true, signedWriteUrl: true }),
+        put: async (key, bytes, putOptions, context) => {
+            const headers = new Headers();
+            if (putOptions?.contentType !== undefined)
+                headers.set("content-type", putOptions.contentType);
+            for (const [name, value] of Object.entries(putOptions?.metadata ?? {})) {
+                headers.set(`x-amz-meta-${name}`, value);
+            }
+            await assertResponse(await request(key, { method: "PUT", headers, body: bytes }, context), "S3 put");
+        },
+        get: async (key, context) => {
+            const response = await request(key, { method: "GET" }, context);
+            if (response.status === 404)
+                return undefined;
+            await assertResponse(response, "S3 get");
+            return new Uint8Array(await response.arrayBuffer());
+        },
+        head: async (key, context) => {
+            const response = await request(key, { method: "HEAD" }, context);
+            if (response.status === 404)
+                return undefined;
+            await assertResponse(response, "S3 head");
+            const metadata = {};
+            response.headers.forEach((value, name) => {
+                if (name.startsWith("x-amz-meta-"))
+                    metadata[name.slice(11)] = value;
+            });
+            const size = Number(response.headers.get("content-length"));
+            return {
+                etag: response.headers.get("etag")?.replaceAll('"', "") ?? "",
+                ...(response.headers.get("x-amz-checksum-sha256") === null
+                    ? {}
+                    : { contentHash: response.headers.get("x-amz-checksum-sha256") }),
+                ...(response.headers.get("content-type") === null
+                    ? {}
+                    : { contentType: response.headers.get("content-type") }),
+                ...(Number.isFinite(size) ? { size } : {}),
+                metadata,
+            };
+        },
+        delete: async (key, context) => {
+            await assertResponse(await request(key, { method: "DELETE" }, context), "S3 delete");
+        },
+        exists: async (key, context) => (await request(key, { method: "HEAD" }, context)).ok,
+        list: async (prefix, context) => {
+            const listUrl = new URL(url());
+            listUrl.searchParams.set("list-type", "2");
+            if (prefix !== undefined)
+                listUrl.searchParams.set("prefix", prefix);
+            const response = await signedRequest(listUrl.toString(), {
+                region,
+                ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
+                ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+                init: { method: "GET", ...(context === undefined ? {} : { signal: context.signal }) },
+            });
+            await assertResponse(response, "S3 list");
+            return Object.freeze([...(await response.text()).matchAll(/<Key>([^<]*)<\/Key>/g)].map((match) => decodeS3Xml(match[1])));
+        },
+        createReadUrl: (key) => presignS3Url(url(key), "GET", region, expires, {
+            ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
+            ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+        }),
+        createWriteUrl: (key) => presignS3Url(url(key), "PUT", region, expires, {
+            ...(options.credentials === undefined ? {} : { credentials: options.credentials }),
+            ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+        }),
+        inspector,
+    });
+}
+//# sourceMappingURL=s3.js.map

package/dist/s3.js.map

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

package/dist/signing.d.ts

@@ -0,0 +1,18 @@
+export interface S3Credentials {
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    readonly sessionToken?: string;
+}
+export type SignedRequestInit = Omit<RequestInit, "body"> & {
+    readonly body?: string | Uint8Array | null;
+};
+export interface SignedRequestOptions {
+    readonly region: string;
+    readonly credentials?: S3Credentials;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly init?: SignedRequestInit;
+}
+export declare function signedRequest(url: string, options: SignedRequestOptions): Promise<Response>;
+export declare function presignS3Url(url: string, method: "GET" | "PUT", region: string, expiresSeconds: number, options?: Pick<SignedRequestOptions, "credentials" | "fetch">): Promise<string>;
+export declare function assertResponse(response: Response, operation: string): Promise<Response>;
+//# sourceMappingURL=signing.d.ts.map

package/dist/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAcjG;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,KAAK,GAAG,KAAK,EACrB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,OAAO,CAAM,GAChE,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAkCD,wBAAsB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAM7F"}

package/dist/signing.js

@@ -0,0 +1,145 @@
+import { s3ErrorDetail } from "./s3-xml.js";
+export async function signedRequest(url, options) {
+    const request = options.init ?? {};
+    const headers = new Headers(request.headers);
+    const body = request.body ?? "";
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const credentials = options.credentials ?? (await workloadCredentials(fetcher));
+    if (credentials !== undefined)
+        await signHeaders(url, options.region, credentials, headers, body, request.method);
+    const { body: requestBody, ...withoutBody } = request;
+    return fetcher(url, {
+        ...withoutBody,
+        ...(requestBody === undefined ? {} : { body: requestBody }),
+        headers,
+    });
+}
+export async function presignS3Url(url, method, region, expiresSeconds, options = {}) {
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const credentials = options.credentials ?? (await workloadCredentials(fetcher));
+    if (credentials === undefined)
+        throw new Error("S3 signed URLs require credentials");
+    const now = new Date();
+    const amzDate = timestamp(now);
+    const date = amzDate.slice(0, 8);
+    const scope = `${date}/${region}/s3/aws4_request`;
+    const parsed = new URL(url);
+    parsed.searchParams.set("X-Amz-Algorithm", "AWS4-HMAC-SHA256");
+    parsed.searchParams.set("X-Amz-Credential", `${credentials.accessKeyId}/${scope}`);
+    parsed.searchParams.set("X-Amz-Date", amzDate);
+    parsed.searchParams.set("X-Amz-Expires", String(expiresSeconds));
+    parsed.searchParams.set("X-Amz-SignedHeaders", "host");
+    if (credentials.sessionToken !== undefined) {
+        parsed.searchParams.set("X-Amz-Security-Token", credentials.sessionToken);
+    }
+    const canonical = [
+        method,
+        parsed.pathname || "/",
+        canonicalQuery(parsed.searchParams),
+        `host:${parsed.host}\n`,
+        "host",
+        "UNSIGNED-PAYLOAD",
+    ].join("\n");
+    const stringToSign = `AWS4-HMAC-SHA256\n${amzDate}\n${scope}\n${await hash(canonical)}`;
+    const signingKey = await deriveKey(credentials.secretAccessKey, date, region, "s3");
+    parsed.searchParams.set("X-Amz-Signature", hex(await hmac(signingKey, stringToSign)));
+    return parsed.toString();
+}
+let cachedCredentials;
+async function workloadCredentials(fetcher) {
+    const path = process.env.AWS_CONTAINER_CREDENTIALS_RELATIVE_URI;
+    if (path === undefined || !path.startsWith("/"))
+        return undefined;
+    if (cachedCredentials !== undefined && cachedCredentials.expiresAt > Date.now() + 60_000) {
+        return cachedCredentials.value;
+    }
+    const headers = new Headers();
+    const token = process.env.AWS_CONTAINER_AUTHORIZATION_TOKEN;
+    if (token !== undefined)
+        headers.set("authorization", token);
+    const response = await fetcher(`http://169.254.170.2${path}`, { headers });
+    await assertResponse(response, "container credentials");
+    const result = (await response.json());
+    if (typeof result.AccessKeyId !== "string" || typeof result.SecretAccessKey !== "string") {
+        throw new Error("AWS container credentials response is invalid");
+    }
+    const value = {
+        accessKeyId: result.AccessKeyId,
+        secretAccessKey: result.SecretAccessKey,
+        ...(typeof result.Token === "string" ? { sessionToken: result.Token } : {}),
+    };
+    const expiration = typeof result.Expiration === "string" ? Date.parse(result.Expiration) : NaN;
+    cachedCredentials = {
+        value,
+        expiresAt: Number.isFinite(expiration) ? expiration : Date.now() + 300_000,
+    };
+    return value;
+}
+export async function assertResponse(response, operation) {
+    if (response.ok)
+        return response;
+    const detail = s3ErrorDetail(await response.text());
+    throw new Error(`${operation} failed with status ${response.status}${detail ? `: ${detail}` : ""}`);
+}
+async function signHeaders(url, region, credentials, headers, body, method = "GET") {
+    const amzDate = timestamp(new Date());
+    const date = amzDate.slice(0, 8);
+    const parsed = new URL(url);
+    const payloadHash = await hash(body);
+    headers.set("host", parsed.host);
+    headers.set("x-amz-date", amzDate);
+    headers.set("x-amz-content-sha256", payloadHash);
+    if (credentials.sessionToken !== undefined)
+        headers.set("x-amz-security-token", credentials.sessionToken);
+    const canonicalHeaders = [...headers.entries()]
+        .map(([name, value]) => [name.toLowerCase(), value.trim().replace(/\s+/g, " ")])
+        .sort(([left], [right]) => left.localeCompare(right));
+    const signedHeaders = canonicalHeaders.map(([name]) => name).join(";");
+    const canonical = [
+        method.toUpperCase(),
+        parsed.pathname || "/",
+        canonicalQuery(parsed.searchParams),
+        canonicalHeaders.map(([name, value]) => `${name}:${value}\n`).join(""),
+        signedHeaders,
+        payloadHash,
+    ].join("\n");
+    const scope = `${date}/${region}/s3/aws4_request`;
+    const stringToSign = `AWS4-HMAC-SHA256\n${amzDate}\n${scope}\n${await hash(canonical)}`;
+    const signingKey = await deriveKey(credentials.secretAccessKey, date, region, "s3");
+    const signature = hex(await hmac(signingKey, stringToSign));
+    headers.set("authorization", `AWS4-HMAC-SHA256 Credential=${credentials.accessKeyId}/${scope}, SignedHeaders=${signedHeaders}, Signature=${signature}`);
+}
+function canonicalQuery(params) {
+    return [...params.entries()]
+        .map(([name, value]) => [encode(name), encode(value)])
+        .sort(([aName, aValue], [bName, bValue]) => aName.localeCompare(bName) || aValue.localeCompare(bValue))
+        .map(([name, value]) => `${name}=${value}`)
+        .join("&");
+}
+function encode(value) {
+    return encodeURIComponent(value).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+function timestamp(value) {
+    return value.toISOString().replace(/[:-]|\.\d{3}/g, "");
+}
+async function deriveKey(secret, date, region, service) {
+    let value = await hmac(`AWS4${secret}`, date);
+    value = await hmac(value, region);
+    value = await hmac(value, service);
+    return hmac(value, "aws4_request");
+}
+async function hmac(keyValue, value) {
+    const data = typeof keyValue === "string" ? new TextEncoder().encode(keyValue) : keyValue;
+    const key = await crypto.subtle.importKey("raw", data, { name: "HMAC", hash: "SHA-256" }, false, [
+        "sign",
+    ]);
+    return crypto.subtle.sign("HMAC", key, new TextEncoder().encode(value));
+}
+async function hash(value) {
+    const bytes = typeof value === "string" ? new TextEncoder().encode(value) : value;
+    return hex(await crypto.subtle.digest("SHA-256", Uint8Array.from(bytes)));
+}
+function hex(value) {
+    return [...new Uint8Array(value)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@relkit/providers-standard",
+  "version": "0.0.0",
+  "description": "Standard provider adapters for RELKIT applications.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rel-kit/relkit.git",
+    "directory": "packages/providers-standard"
+  },
+  "homepage": "https://github.com/rel-kit/relkit#readme",
+  "bugs": {
+    "url": "https://github.com/rel-kit/relkit/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@relkit/agents": "0.0.0",
+    "@relkit/app": "0.0.0",
+    "@relkit/buckets": "0.0.0",
+    "@relkit/cache": "0.0.0",
+    "@relkit/contracts": "0.0.0",
+    "@relkit/engine": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "typecheck": "tsc -b --pretty false"
+  }
+}