@ericminassian/platform 0.0.0-stage → 0.1.0

package/dist/clients.d.ts

@@ -0,0 +1,38 @@
+import type { CognitoIdentityProviderClient } from '@aws-sdk/client-cognito-identity-provider';
+import type { EventBridgeClient } from '@aws-sdk/client-eventbridge';
+import type { LambdaClient } from '@aws-sdk/client-lambda';
+import type { S3Client } from '@aws-sdk/client-s3';
+import type { SQSClient } from '@aws-sdk/client-sqs';
+import type { SSMClient } from '@aws-sdk/client-ssm';
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+/**
+ * AWS clients, created on first use. Under `plat dev` / `plat test` the
+ * standard `AWS_ENDPOINT_URL` points every client at the AWS Emulator and
+ * `NODE_EXTRA_CA_CERTS` trusts its certificate; nothing else differs.
+ *
+ * Only DynamoDB is imported eagerly (most apps use it, and `db.raw()` is
+ * synchronous). Everything else is a dynamic import, which esbuild keeps in
+ * the same bundle but evaluates lazily — so cold starts only pay for the
+ * services a request actually touches.
+ */
+export interface Clients {
+    ddb: DynamoDBDocumentClient;
+    sqs: SQSClient;
+    events: EventBridgeClient;
+    s3: S3Client;
+    ssm: SSMClient;
+    lambda: LambdaClient;
+    cognito: CognitoIdentityProviderClient;
+}
+export type LazyClientName = Exclude<keyof Clients, 'ddb'>;
+/** Minimal client shape (tests may substitute `{ send }` fakes). */
+export interface SendClient {
+    send(command: unknown): Promise<unknown>;
+}
+/** The DynamoDB document client (synchronous). */
+export declare function ddbClient(): DynamoDBDocumentClient;
+export declare function client<K extends LazyClientName>(name: K): Promise<Clients[K]>;
+/** Substitute a client (tests). `undefined` removes the override. */
+export declare function setClient(name: keyof Clients, fake: SendClient | undefined): void;
+/** Drop cached clients (tests that change region/endpoint between runs). */
+export declare function resetClients(): void;

package/dist/clients.js

@@ -0,0 +1,65 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+import { isEmulator, region } from './bindings.js';
+const instances = {};
+const pending = {};
+const overrides = {};
+function config() {
+    const endpoint = process.env.AWS_ENDPOINT_URL;
+    return { region: region(), ...(endpoint ? { endpoint } : {}) };
+}
+const lazyFactories = {
+    sqs: async () => new (await import('@aws-sdk/client-sqs')).SQSClient(config()),
+    events: async () => new (await import('@aws-sdk/client-eventbridge')).EventBridgeClient(config()),
+    s3: async () => new (await import('@aws-sdk/client-s3')).S3Client({
+        ...config(),
+        ...(isEmulator() ? { forcePathStyle: true } : {}),
+    }),
+    ssm: async () => new (await import('@aws-sdk/client-ssm')).SSMClient(config()),
+    lambda: async () => new (await import('@aws-sdk/client-lambda')).LambdaClient(config()),
+    cognito: async () => new (await import('@aws-sdk/client-cognito-identity-provider')).CognitoIdentityProviderClient(config()),
+};
+/** The DynamoDB document client (synchronous). */
+export function ddbClient() {
+    const o = overrides.ddb;
+    if (o)
+        return o;
+    let c = instances.ddb;
+    if (!c) {
+        c = DynamoDBDocumentClient.from(new DynamoDBClient(config()), {
+            marshallOptions: { removeUndefinedValues: true, convertClassInstanceToMap: true },
+        });
+        instances.ddb = c;
+    }
+    return c;
+}
+export async function client(name) {
+    const o = overrides[name];
+    if (o)
+        return o;
+    const existing = instances[name];
+    if (existing)
+        return existing;
+    pending[name] ??= lazyFactories[name]().then((c) => {
+        instances[name] = c;
+        return c;
+    });
+    return pending[name];
+}
+/** Substitute a client (tests). `undefined` removes the override. */
+export function setClient(name, fake) {
+    if (fake)
+        overrides[name] = fake;
+    else
+        delete overrides[name];
+}
+/** Drop cached clients (tests that change region/endpoint between runs). */
+export function resetClients() {
+    for (const k of Object.keys(instances))
+        delete instances[k];
+    for (const k of Object.keys(pending))
+        delete pending[k];
+    for (const k of Object.keys(overrides))
+        delete overrides[k];
+}
+//# sourceMappingURL=clients.js.map

package/dist/clients.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,31 @@
+import { type PlatformUser } from '@ericminassian/platform-core';
+/** Per-request / per-job context carried through async calls. */
+export interface RequestContext {
+    trace: string;
+    /** Span id of the root (request or job). */
+    span: string;
+    /** performance.now() when the root started, for span offsets. */
+    startedAt: number;
+    /** Set-Cookie values produced while handling the request (e.g. token refresh). */
+    cookies: string[];
+    /** Matched route pattern, set by the router integration. */
+    route?: string;
+    /** Resolved user (undefined = not looked up yet, null = signed out). */
+    user?: PlatformUser | null;
+    /** Job name for error attribution in workers. */
+    job?: string;
+    /** Error a framework handled itself (e.g. a Hono app's onError), for telemetry. */
+    error?: unknown;
+}
+export declare function currentContext(): RequestContext | undefined;
+export declare function runWithContext<T>(ctx: RequestContext, fn: () => T): T;
+export declare function newContext(trace?: string | null): RequestContext;
+/** Trace id of the current request/job, or a fresh one outside any context. */
+export declare function currentTrace(): string;
+/** Parse a W3C `traceparent` header (`00-<32 hex trace>-<16 hex span>-<flags>`). */
+export declare function parseTraceparent(header: string | null | undefined): string | undefined;
+/**
+ * Record the route pattern (e.g. `/api/todos/:id`) for the current request's
+ * telemetry. Hono apps get this automatically; other frameworks can call it.
+ */
+export declare function setRoute(pattern: string): void;

package/dist/context.js

@@ -0,0 +1,33 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { newSpanId, newTraceId } from '@ericminassian/platform-core';
+const storage = new AsyncLocalStorage();
+export function currentContext() {
+    return storage.getStore();
+}
+export function runWithContext(ctx, fn) {
+    return storage.run(ctx, fn);
+}
+export function newContext(trace) {
+    return { trace: trace || newTraceId(), span: newSpanId(), startedAt: performance.now(), cookies: [] };
+}
+/** Trace id of the current request/job, or a fresh one outside any context. */
+export function currentTrace() {
+    return storage.getStore()?.trace ?? newTraceId();
+}
+/** Parse a W3C `traceparent` header (`00-<32 hex trace>-<16 hex span>-<flags>`). */
+export function parseTraceparent(header) {
+    if (!header)
+        return undefined;
+    const m = /^[\da-f]{2}-([\da-f]{32})-[\da-f]{16}-[\da-f]{2}$/i.exec(header.trim());
+    return m?.[1]?.toLowerCase();
+}
+/**
+ * Record the route pattern (e.g. `/api/todos/:id`) for the current request's
+ * telemetry. Hono apps get this automatically; other frameworks can call it.
+ */
+export function setRoute(pattern) {
+    const ctx = storage.getStore();
+    if (ctx)
+        ctx.route = pattern;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAqB,MAAM,8BAA8B,CAAC;AAqBxF,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAExD,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,GAAmB,EAAE,EAAW;IAChE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACxG,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,UAAU,EAAE,CAAC;AACnD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,MAAiC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,CAAC,GAAG,oDAAoD,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC/B,IAAI,GAAG;QAAE,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC;AAC/B,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,97 @@
+import { type QueryCommandInput } from '@aws-sdk/lib-dynamodb';
+/**
+ * Document collections on the stage's single DynamoDB table (single-table
+ * design). Adding a collection needs no provisioning.
+ *
+ * Item layout:
+ *   pk       = "<collection>#<partition values joined by #>"
+ *   sk       = "<sort values joined by #>"  (or "#" without a sort key)
+ *   gsi{n}pk = "<collection>#<index>#<values>", gsi{n}sk = sort values or "#"
+ *   _c       = collection, _ttl = epoch seconds (DynamoDB TTL)
+ * Internal attributes are stripped from everything returned.
+ */
+export type KeyValue = string | number;
+type Fields<T> = (keyof T & string) | readonly (keyof T & string)[];
+export interface CollectionOptions<T> {
+    /** Attribute(s) forming the partition key. */
+    partition: Fields<T>;
+    /** Attribute(s) forming the sort key (optional). */
+    sort?: Fields<T>;
+    /** Up to three secondary indexes, each pinned to a fixed slot so reordering is safe. */
+    indexes?: Record<string, {
+        slot: 1 | 2 | 3;
+        partition: Fields<T>;
+        sort?: Fields<T>;
+    }>;
+    /** Attribute holding an epoch-seconds expiry (DynamoDB TTL). */
+    ttl?: keyof T & string;
+}
+export interface QueryOptions {
+    index?: string;
+    beginsWith?: string;
+    between?: [KeyValue, KeyValue];
+    gt?: KeyValue;
+    gte?: KeyValue;
+    lt?: KeyValue;
+    lte?: KeyValue;
+    limit?: number;
+    cursor?: string;
+    reverse?: boolean;
+}
+export interface Page<T> {
+    items: T[];
+    cursor?: string;
+}
+export interface Collection<T extends Record<string, unknown>> {
+    get(key: Partial<T>): Promise<T | undefined>;
+    put(item: T, opts?: {
+        ifNotExists?: boolean;
+    }): Promise<T>;
+    update(key: Partial<T>, patch: Partial<T>): Promise<T>;
+    delete(key: Partial<T>): Promise<void>;
+    /** All items sharing the given partition-key values. */
+    query(partition: Partial<T>, opts?: QueryOptions): Promise<Page<T>>;
+}
+export interface Db {
+    collection<T extends Record<string, unknown>>(name: string, opts: CollectionOptions<T>): Collection<T>;
+    /** Escape hatch (AWS-specific): the DynamoDB document client and table name. */
+    raw(): {
+        client: unknown;
+        table: string;
+    };
+}
+export declare const INTERNAL_ATTRIBUTES: string[];
+/** Values for `fields` from `item`, joined by `#`. Throws when any is missing. */
+export declare function keyPart(item: Record<string, unknown>, fields: string[], what: string): string;
+export declare function stripInternal<T>(item: Record<string, unknown> | undefined): T | undefined;
+export declare function encodeCursor(key: Record<string, unknown> | undefined): string | undefined;
+export declare function decodeCursor(cursor: string | undefined): Record<string, unknown> | undefined;
+/** Pure key/attribute mapping, exported for tests and the console's data browser. */
+export declare function createKeyMapper<T extends Record<string, unknown>>(name: string, opts: CollectionOptions<T>): {
+    name: string;
+    partition: string[];
+    sort: string[];
+    indexes: {
+        name: string;
+        slot: 1 | 2 | 3;
+        partition: string[];
+        sort: string[];
+    }[];
+    primaryKey: (item: Record<string, unknown>) => {
+        pk: string;
+        sk: string;
+    };
+    derived: (item: Record<string, unknown>) => Record<string, string | number | null>;
+    toItem: (item: T) => Record<string, unknown>;
+    queryInput: (values: Partial<T>, q: QueryOptions, tableName: string) => QueryCommandInput;
+    keyFields: Set<string>;
+    derivedSources: Set<string>;
+};
+/** `SET #a = :a, ... REMOVE #b` from a patch; `undefined`/`null` values are removed. */
+export declare function setExpression(patch: Record<string, unknown>, skip: Set<string>): {
+    expr: string;
+    names: Record<string, string>;
+    values: Record<string, unknown>;
+};
+export declare const db: Db;
+export {};

package/dist/db.js

@@ -0,0 +1,297 @@
+import { DeleteCommand, GetCommand, PutCommand, QueryCommand, UpdateCommand, } from '@aws-sdk/lib-dynamodb';
+import { getBindings } from './bindings.js';
+import { ddbClient } from './clients.js';
+import { span } from './telemetry.js';
+export const INTERNAL_ATTRIBUTES = [
+    'pk',
+    'sk',
+    'gsi1pk',
+    'gsi1sk',
+    'gsi2pk',
+    'gsi2sk',
+    'gsi3pk',
+    'gsi3sk',
+    '_c',
+    '_ttl',
+];
+const COLLECTION_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+function list(f) {
+    if (!f)
+        return [];
+    return typeof f === 'string' ? [f] : [...f];
+}
+function table() {
+    const t = getBindings().table;
+    if (!t)
+        throw new Error('This app has no database. Add `"db": true` to platform.json.');
+    return t;
+}
+function ddb() {
+    return ddbClient();
+}
+/** Values for `fields` from `item`, joined by `#`. Throws when any is missing. */
+export function keyPart(item, fields, what) {
+    return fields
+        .map((f) => {
+        const v = item[f];
+        if (v === undefined || v === null || v === '')
+            throw new Error(`${what}: missing key attribute "${f}"`);
+        if (typeof v !== 'string' && typeof v !== 'number')
+            throw new Error(`${what}: key attribute "${f}" must be a string or number`);
+        return String(v);
+    })
+        .join('#');
+}
+function hasAll(item, fields) {
+    return fields.every((f) => item[f] !== undefined && item[f] !== null && item[f] !== '');
+}
+export function stripInternal(item) {
+    if (!item)
+        return undefined;
+    const out = {};
+    for (const [k, v] of Object.entries(item))
+        if (!INTERNAL_ATTRIBUTES.includes(k))
+            out[k] = v;
+    return out;
+}
+export function encodeCursor(key) {
+    return key ? Buffer.from(JSON.stringify(key)).toString('base64url') : undefined;
+}
+export function decodeCursor(cursor) {
+    if (!cursor)
+        return undefined;
+    try {
+        return JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
+    }
+    catch {
+        throw new Error('Invalid cursor');
+    }
+}
+/** Pure key/attribute mapping, exported for tests and the console's data browser. */
+export function createKeyMapper(name, opts) {
+    if (!COLLECTION_NAME.test(name))
+        throw new Error(`Invalid collection name "${name}"`);
+    const partition = list(opts.partition);
+    const sort = list(opts.sort);
+    if (partition.length === 0)
+        throw new Error(`Collection "${name}" needs a partition key`);
+    const indexes = Object.entries(opts.indexes ?? {}).map(([indexName, ix]) => ({
+        name: indexName,
+        slot: ix.slot,
+        partition: list(ix.partition),
+        sort: list(ix.sort),
+    }));
+    const slots = new Set();
+    for (const ix of indexes) {
+        if (slots.has(ix.slot))
+            throw new Error(`Collection "${name}": two indexes use slot ${ix.slot}`);
+        slots.add(ix.slot);
+    }
+    const what = `collection "${name}"`;
+    const primaryKey = (item) => ({
+        pk: `${name}#${keyPart(item, partition, what)}`,
+        sk: sort.length ? keyPart(item, sort, what) : '#',
+    });
+    /** gsi/ttl attributes for `item`; `null` values mean "remove". */
+    const derived = (item) => {
+        const out = {};
+        for (const ix of indexes) {
+            if (hasAll(item, ix.partition) && (ix.sort.length === 0 || hasAll(item, ix.sort))) {
+                out[`gsi${ix.slot}pk`] = `${name}#${ix.name}#${keyPart(item, ix.partition, what)}`;
+                out[`gsi${ix.slot}sk`] = ix.sort.length ? keyPart(item, ix.sort, what) : '#';
+            }
+            else {
+                out[`gsi${ix.slot}pk`] = null;
+                out[`gsi${ix.slot}sk`] = null;
+            }
+        }
+        if (opts.ttl) {
+            const v = item[opts.ttl];
+            out._ttl = typeof v === 'number' ? Math.floor(v) : null;
+        }
+        return out;
+    };
+    const toItem = (item) => {
+        const extra = {};
+        for (const [k, v] of Object.entries(derived(item)))
+            if (v !== null)
+                extra[k] = v;
+        return { ...item, ...primaryKey(item), _c: name, ...extra };
+    };
+    const queryInput = (values, q, tableName) => {
+        let pkAttr = 'pk';
+        let skAttr = 'sk';
+        let pkValue;
+        let indexName;
+        if (q.index) {
+            const ix = indexes.find((i) => i.name === q.index);
+            if (!ix)
+                throw new Error(`${what} has no index "${q.index}"`);
+            pkAttr = `gsi${ix.slot}pk`;
+            skAttr = `gsi${ix.slot}sk`;
+            indexName = `gsi${ix.slot}`;
+            pkValue = `${name}#${ix.name}#${keyPart(values, ix.partition, what)}`;
+        }
+        else {
+            pkValue = `${name}#${keyPart(values, partition, what)}`;
+        }
+        const names = { '#pk': pkAttr };
+        const vals = { ':pk': pkValue };
+        let cond = '#pk = :pk';
+        const sortCond = (expr) => {
+            names['#sk'] = skAttr;
+            cond += ` AND ${expr}`;
+        };
+        if (q.beginsWith !== undefined) {
+            vals[':b'] = String(q.beginsWith);
+            sortCond('begins_with(#sk, :b)');
+        }
+        else if (q.between) {
+            vals[':lo'] = String(q.between[0]);
+            vals[':hi'] = String(q.between[1]);
+            sortCond('#sk BETWEEN :lo AND :hi');
+        }
+        else {
+            const ops = [
+                ['gt', '>'],
+                ['gte', '>='],
+                ['lt', '<'],
+                ['lte', '<='],
+            ];
+            const set = ops.filter(([k]) => q[k] !== undefined);
+            if (set.length > 1)
+                throw new Error('Use `between` for a range; only one of gt/gte/lt/lte is allowed');
+            const op = set[0];
+            if (op) {
+                vals[':v'] = String(q[op[0]]);
+                sortCond(`#sk ${op[1]} :v`);
+            }
+        }
+        const start = decodeCursor(q.cursor);
+        return {
+            TableName: tableName,
+            ...(indexName ? { IndexName: indexName } : {}),
+            KeyConditionExpression: cond,
+            ExpressionAttributeNames: names,
+            ExpressionAttributeValues: vals,
+            ScanIndexForward: !q.reverse,
+            ...(q.limit ? { Limit: q.limit } : {}),
+            ...(start ? { ExclusiveStartKey: start } : {}),
+        };
+    };
+    const keyFields = new Set([...partition, ...sort]);
+    const derivedSources = new Set([
+        ...indexes.flatMap((i) => [...i.partition, ...i.sort]),
+        ...(opts.ttl ? [opts.ttl] : []),
+    ]);
+    return {
+        name,
+        partition,
+        sort,
+        indexes,
+        primaryKey,
+        derived,
+        toItem,
+        queryInput,
+        keyFields,
+        derivedSources,
+    };
+}
+function collection(name, opts) {
+    const m = createKeyMapper(name, opts);
+    return {
+        get: (key) => span('db.get', name, async () => {
+            const out = await ddb().send(new GetCommand({ TableName: table(), Key: m.primaryKey(key) }));
+            return stripInternal(out.Item);
+        }),
+        put: (item, putOpts) => span('db.put', name, async () => {
+            await ddb().send(new PutCommand({
+                TableName: table(),
+                Item: m.toItem(item),
+                ...(putOpts?.ifNotExists ? { ConditionExpression: 'attribute_not_exists(pk)' } : {}),
+            }));
+            return item;
+        }),
+        update: (key, patch) => span('db.update', name, async () => {
+            for (const k of Object.keys(patch)) {
+                if (m.keyFields.has(k) && patch[k] !== key[k])
+                    throw new Error(`collection "${name}": cannot change key attribute "${k}"`);
+            }
+            const tableName = table();
+            const Key = m.primaryKey(key);
+            const { expr, names, values } = setExpression(patch, m.keyFields);
+            const out = await ddb().send(new UpdateCommand({
+                TableName: tableName,
+                Key,
+                UpdateExpression: expr,
+                ExpressionAttributeNames: { ...names, '#pk': 'pk' },
+                ...(Object.keys(values).length ? { ExpressionAttributeValues: values } : {}),
+                ConditionExpression: 'attribute_exists(#pk)',
+                ReturnValues: 'ALL_NEW',
+            }));
+            let item = out.Attributes ?? {};
+            if (Object.keys(patch).some((k) => m.derivedSources.has(k))) {
+                const d = setExpression(m.derived(item), new Set());
+                const again = await ddb().send(new UpdateCommand({
+                    TableName: tableName,
+                    Key,
+                    UpdateExpression: d.expr,
+                    ExpressionAttributeNames: { ...d.names, '#pk': 'pk' },
+                    ...(Object.keys(d.values).length ? { ExpressionAttributeValues: d.values } : {}),
+                    ConditionExpression: 'attribute_exists(#pk)',
+                    ReturnValues: 'ALL_NEW',
+                }));
+                item = again.Attributes ?? item;
+            }
+            return stripInternal(item);
+        }),
+        delete: (key) => span('db.delete', name, async () => {
+            await ddb().send(new DeleteCommand({ TableName: table(), Key: m.primaryKey(key) }));
+        }),
+        query: (values, q = {}) => span('db.query', name, async () => {
+            const out = await ddb().send(new QueryCommand(m.queryInput(values, q, table())));
+            const page = { items: (out.Items ?? []).map((i) => stripInternal(i)) };
+            const cursor = encodeCursor(out.LastEvaluatedKey);
+            if (cursor)
+                page.cursor = cursor;
+            return page;
+        }),
+    };
+}
+/** `SET #a = :a, ... REMOVE #b` from a patch; `undefined`/`null` values are removed. */
+export function setExpression(patch, skip) {
+    const sets = [];
+    const removes = [];
+    const names = {};
+    const values = {};
+    let i = 0;
+    for (const [k, v] of Object.entries(patch)) {
+        if (skip.has(k))
+            continue;
+        const n = `#f${i}`;
+        names[n] = k;
+        if (v === undefined || v === null)
+            removes.push(n);
+        else {
+            values[`:v${i}`] = v;
+            sets.push(`${n} = :v${i}`);
+        }
+        i++;
+    }
+    const parts = [];
+    if (sets.length)
+        parts.push(`SET ${sets.join(', ')}`);
+    if (removes.length)
+        parts.push(`REMOVE ${removes.join(', ')}`);
+    if (!parts.length) {
+        // No-op update still verifies existence.
+        names['#c'] = '_c';
+        parts.push('SET #c = #c');
+    }
+    return { expr: parts.join(' '), names, values };
+}
+export const db = {
+    collection,
+    raw: () => ({ client: ddb(), table: table() }),
+};
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+export interface Events {
+    publish<T = unknown>(type: string, detail: T): Promise<void>;
+}
+/** Envelope inside EventBridge `detail`, so the trace survives the hop. */
+export interface EventEnvelope<T = unknown> {
+    data: T;
+    trace: string;
+}
+export declare const events: Events;

package/dist/events.js

@@ -0,0 +1,28 @@
+import { getBindings } from './bindings.js';
+import { client } from './clients.js';
+import { currentTrace } from './context.js';
+import { span } from './telemetry.js';
+export const events = {
+    publish: (type, detail) => span('events.publish', type, async () => {
+        const b = getBindings();
+        if (!b.bus)
+            throw new Error('This app has no event bus. Add an "events" entry to platform.json.');
+        const envelope = { data: detail, trace: currentTrace() };
+        const { PutEventsCommand } = await import('@aws-sdk/client-eventbridge');
+        const out = await (await client('events')).send(new PutEventsCommand({
+            Entries: [
+                {
+                    EventBusName: b.bus.name,
+                    Source: `platform.${b.app}`,
+                    DetailType: type,
+                    Detail: JSON.stringify(envelope),
+                },
+            ],
+        }));
+        if (out.FailedEntryCount) {
+            const e = out.Entries?.find((x) => x.ErrorCode);
+            throw new Error(`events.publish("${type}") failed: ${e?.ErrorCode ?? 'unknown'} ${e?.ErrorMessage ?? ''}`.trim());
+        }
+    }),
+};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAYtC,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CACxB,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QAClG,MAAM,QAAQ,GAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC;QACxE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC7C,IAAI,gBAAgB,CAAC;YACnB,OAAO,EAAE;gBACP;oBACE,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI;oBACxB,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,EAAE;oBAC3B,UAAU,EAAE,IAAI;oBAChB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;iBACjC;aACF;SACF,CAAC,CACH,CAAC;QACF,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,cAAc,CAAC,EAAE,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CACjG,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;CACL,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,14 @@
+import { type IncomingMessage, type Server, type ServerResponse } from 'node:http';
+/**
+ * Minimal Node `http` ⇄ web `fetch` adapter (no framework dependency).
+ * Streams request and response bodies, preserves multiple Set-Cookie headers.
+ */
+export type FetchFn = (request: Request) => Promise<Response>;
+export declare function toRequest(req: IncomingMessage, signal?: AbortSignal): Request;
+export declare function writeResponse(res: ServerResponse, response: Response): Promise<void>;
+export declare function createNodeServer(fetchFn: FetchFn): Server;
+/** Parse `host:port` (IPv6 in brackets allowed). */
+export declare function parseEndpoint(endpoint: string): {
+    host: string;
+    port: number;
+};