@ketvietlab/ketjs 0.1.1

package/dist/server/multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/server/multipart.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AA8GD;;;;GAIG;AACH,wBAAuB,SAAS,CAC9B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CAAC,aAAa,CAAC,CAuE/B"}

package/dist/server/multipart.js

@@ -0,0 +1,183 @@
+import { KetError } from '../kernel/errors.js';
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+const bytesOf = (value) => encoder.encode(value);
+const concat = (a, b) => {
+    if (!a.length)
+        return b;
+    if (!b.length)
+        return a;
+    const out = new Uint8Array(a.length + b.length);
+    out.set(a);
+    out.set(b, a.length);
+    return out;
+};
+const indexOf = (haystack, needle) => {
+    outer: for (let i = 0; i <= haystack.length - needle.length; i++) {
+        for (let j = 0; j < needle.length; j++)
+            if (haystack[i + j] !== needle[j])
+                continue outer;
+        return i;
+    }
+    return -1;
+};
+class Reader {
+    source;
+    maxBytes;
+    buffer = new Uint8Array();
+    ended = false;
+    total = 0;
+    constructor(source, maxBytes) {
+        this.source = source[Symbol.asyncIterator]();
+        this.maxBytes = maxBytes;
+    }
+    async fill(minimum) {
+        while (!this.ended && this.buffer.length < minimum) {
+            const next = await this.source.next();
+            if (next.done) {
+                this.ended = true;
+                break;
+            }
+            const chunk = next.value instanceof Uint8Array ? next.value : new Uint8Array(next.value);
+            this.total += chunk.byteLength;
+            if (this.total > this.maxBytes) {
+                throw new KetError({
+                    code: 'E_PAYLOAD_TOO_LARGE',
+                    message: `multipart body exceeds ${this.maxBytes} bytes`,
+                });
+            }
+            this.buffer = concat(this.buffer, chunk);
+        }
+    }
+    take(length) {
+        const value = this.buffer.slice(0, length);
+        this.buffer = this.buffer.slice(length);
+        return value;
+    }
+    async exact(expected) {
+        await this.fill(expected.length);
+        const actual = this.take(expected.length);
+        if (actual.length !== expected.length || indexOf(actual, expected) !== 0)
+            throw new KetError({ code: 'E_MULTIPART_SYNTAX', message: 'malformed multipart boundary' });
+    }
+    async until(marker, limit) {
+        for (;;) {
+            const found = indexOf(this.buffer, marker);
+            if (found >= 0) {
+                if (found > limit)
+                    throw new KetError({ code: 'E_MULTIPART_HEADERS', message: 'multipart headers are too large' });
+                const value = this.take(found);
+                this.take(marker.length);
+                return value;
+            }
+            if (this.buffer.length > limit)
+                throw new KetError({ code: 'E_MULTIPART_HEADERS', message: 'multipart headers are too large' });
+            if (this.ended)
+                throw new KetError({ code: 'E_MULTIPART_SYNTAX', message: 'multipart body ended before a boundary' });
+            await this.fill(this.buffer.length + 1);
+        }
+    }
+}
+const boundaryOf = (contentType) => {
+    if (!/^multipart\/form-data\b/i.test(contentType))
+        throw new KetError({ code: 'E_MULTIPART_TYPE', message: 'expected multipart/form-data' });
+    const match = /(?:^|;)\s*boundary=(?:"([^"]+)"|([^;\s]+))/i.exec(contentType);
+    const boundary = match?.[1] ?? match?.[2];
+    if (!boundary || boundary.length > 200 || /[\r\n]/.test(boundary))
+        throw new KetError({ code: 'E_MULTIPART_BOUNDARY', message: 'missing or invalid multipart boundary' });
+    return boundary;
+};
+const disposition = (value) => {
+    if (!/^form-data(?:;|$)/i.test(value))
+        throw new KetError({ code: 'E_MULTIPART_DISPOSITION', message: 'multipart part is not form-data' });
+    const params = new Map();
+    for (const match of value.matchAll(/;\s*([\w-]+)=(?:"((?:[^"\\]|\\.)*)"|([^;]*))/g)) {
+        const raw = match[2] ?? match[3] ?? '';
+        params.set(match[1].toLowerCase(), raw.replace(/\\(["\\])/g, '$1'));
+    }
+    const name = params.get('name');
+    if (!name)
+        throw new KetError({ code: 'E_MULTIPART_NAME', message: 'multipart part has no name' });
+    const filename = params.get('filename');
+    return { name, ...(filename === undefined ? {} : { filename }) };
+};
+/**
+ * Parse multipart sequentially without buffering file bodies. A part body must be
+ * consumed before requesting the next part; if a caller stops early, the parser
+ * drains only to the next boundary so the remaining parts stay readable.
+ */
+export async function* multipart(source, contentType, options = {}) {
+    const boundary = boundaryOf(contentType);
+    const reader = new Reader(source, options.maxBytes ?? 25 * 1024 * 1024);
+    const first = bytesOf(`--${boundary}\r\n`);
+    const delimiter = bytesOf(`\r\n--${boundary}`);
+    const headerEnd = bytesOf('\r\n\r\n');
+    await reader.exact(first);
+    let final = false;
+    let parts = 0;
+    while (!final) {
+        parts++;
+        if (parts > (options.maxParts ?? 20))
+            throw new KetError({ code: 'E_MULTIPART_PARTS', message: 'multipart body has too many parts' });
+        const rawHeaders = decoder.decode(await reader.until(headerEnd, options.maxHeaderBytes ?? 16 * 1024));
+        const headers = new Map();
+        for (const line of rawHeaders.split('\r\n')) {
+            const colon = line.indexOf(':');
+            if (colon <= 0)
+                throw new KetError({ code: 'E_MULTIPART_HEADERS', message: 'malformed multipart part header' });
+            headers.set(line.slice(0, colon).trim().toLowerCase(), line.slice(colon + 1).trim());
+        }
+        const meta = disposition(headers.get('content-disposition') ?? '');
+        let bodyDone = false;
+        const readBody = async function* () {
+            if (bodyDone)
+                return;
+            for (;;) {
+                const found = indexOf(reader.buffer, delimiter);
+                if (found >= 0) {
+                    await reader.fill(found + delimiter.length + 2);
+                    const suffix = decoder.decode(reader.buffer.slice(found + delimiter.length, found + delimiter.length + 2));
+                    // A file may legally contain "\\r\\n--boundary-like". It is a delimiter
+                    // only when followed by CRLF or --; keep scanning instead of truncating.
+                    if (suffix !== '--' && suffix !== '\r\n') {
+                        yield reader.take(found + 2);
+                        continue;
+                    }
+                    if (found)
+                        yield reader.take(found);
+                    reader.take(delimiter.length);
+                    reader.take(2);
+                    if (suffix === '--') {
+                        final = true;
+                        await reader.fill(2);
+                        if (decoder.decode(reader.buffer.slice(0, 2)) === '\r\n')
+                            reader.take(2);
+                    }
+                    else if (suffix !== '\r\n') {
+                        throw new KetError({ code: 'E_MULTIPART_SYNTAX', message: 'malformed multipart boundary suffix' });
+                    }
+                    bodyDone = true;
+                    return;
+                }
+                if (reader.ended)
+                    throw new KetError({
+                        code: 'E_MULTIPART_SYNTAX',
+                        message: 'multipart body ended before a boundary',
+                    });
+                const safe = Math.max(0, reader.buffer.length - delimiter.length + 1);
+                if (safe)
+                    yield reader.take(safe);
+                await reader.fill(reader.buffer.length + 1);
+            }
+        };
+        yield {
+            ...meta,
+            ...(headers.has('content-type') ? { type: headers.get('content-type') } : {}),
+            body: { [Symbol.asyncIterator]: readBody },
+        };
+        if (!bodyDone)
+            for await (const _ of readBody())
+                void _;
+    }
+}
+//# sourceMappingURL=multipart.js.map

package/dist/server/multipart.js.map

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

package/dist/server/project.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Narrow a handler's return value to the fields it declared.
+ *
+ * An undeclared output means no projection: every function would otherwise have to
+ * be rewritten at once, and a gap that is visible in `ket permissions` is a better
+ * trade than a migration nobody finishes. The count there is the progress bar.
+ */
+export declare function project(fnKey: string, output: Record<string, string>, value: unknown): unknown;
+//# sourceMappingURL=project.d.ts.map

package/dist/server/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/server/project.ts"],"names":[],"mappings":"AAgDA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAa9F"}

package/dist/server/project.js

@@ -0,0 +1,67 @@
+// What a function is allowed to hand back.
+//
+// `output` was a comment: composed into the manifest and read by nothing, so a
+// function could declare it returned three fields and return eight. That is not a
+// small gap — a handler that preloads a relation to show a product's name hands
+// back the whole product row, cost included, to whoever may call it.
+//
+// The mechanism to close it already existed and already ran: view models build a
+// null-prototype frozen object holding exactly the declared fields, which is the
+// boundary that stops a third-party theme reaching anything else. This is the same
+// idea applied to the other boundary — the one between a function and its caller.
+//
+// Two properties, and they are worth telling apart:
+//
+//   Nothing undeclared escapes. This is picking, so it holds for every value,
+//   every row, and an empty result — it cannot depend on the data.
+//
+//   Everything declared is present. This can only be checked where there is a row
+//   to check, so an empty result proves nothing about it. It is a bug in the
+//   handler rather than a hole in the boundary, and it is reported as one.
+import { KetError } from '../kernel/errors.js';
+const isPlain = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) && !(v instanceof Date);
+const pick = (fnKey, output, row) => {
+    const out = {};
+    for (const [f, type] of Object.entries(output)) {
+        if (f in row) {
+            out[f] = row[f];
+            continue;
+        }
+        // `?` means the same here as everywhere else: it may be absent. A function that
+        // answers {ok:true, qty} or {ok:false, errors} needs it — the convention is a
+        // union, and a flat record can only describe one without it.
+        if (type.endsWith('?'))
+            continue;
+        throw new KetError({
+            code: 'E_OUTPUT_FIELD_MISSING',
+            message: `"${fnKey}" declares output field "${f}" but returned a row without it`,
+            hint: `mark it "${type}?" if it is sometimes absent, or build it — the handler returned: ${Object.keys(row).join(', ') || '(nothing)'}`,
+        });
+    }
+    return out;
+};
+/**
+ * Narrow a handler's return value to the fields it declared.
+ *
+ * An undeclared output means no projection: every function would otherwise have to
+ * be rewritten at once, and a gap that is visible in `ket permissions` is a better
+ * trade than a migration nobody finishes. The count there is the progress bar.
+ */
+export function project(fnKey, output, value) {
+    const fields = Object.keys(output);
+    if (!fields.length)
+        return value;
+    if (value === null || value === undefined)
+        return value;
+    if (Array.isArray(value))
+        return value.map((v) => project(fnKey, output, v));
+    if (!isPlain(value)) {
+        throw new KetError({
+            code: 'E_OUTPUT_NOT_SHAPED',
+            message: `"${fnKey}" declares an output shape but returned ${typeof value}`,
+            hint: `declared fields: ${fields.join(', ')} — return an object with those, or a list of them`,
+        });
+    }
+    return pick(fnKey, output, value);
+}
+//# sourceMappingURL=project.js.map

package/dist/server/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/project.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,gFAAgF;AAChF,qEAAqE;AACrE,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,mFAAmF;AACnF,kFAAkF;AAClF,EAAE;AACF,oDAAoD;AACpD,EAAE;AACF,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,kFAAkF;AAClF,6EAA6E;AAC7E,2EAA2E;AAE3E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAI9C,MAAM,OAAO,GAAG,CAAC,CAAU,EAAY,EAAE,CACvC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAA;AAElF,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,MAA8B,EAAE,GAAQ,EAAO,EAAE;IAC5E,MAAM,GAAG,GAAQ,EAAE,CAAA;IACnB,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QACD,gFAAgF;QAChF,8EAA8E;QAC9E,6DAA6D;QAC7D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAQ;QAChC,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,IAAI,KAAK,4BAA4B,CAAC,iCAAiC;YAChF,IAAI,EAAE,YAAY,IAAI,qEAAqE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE;SACxI,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,MAA8B,EAAE,KAAc;IACnF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IAC5E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,IAAI,KAAK,2CAA2C,OAAO,KAAK,EAAE;YAC3E,IAAI,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,mDAAmD;SAC/F,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;AACnC,CAAC"}

package/dist/server/queue.d.ts

@@ -0,0 +1,80 @@
+import type { Adapter, JobEnqueueOptions, JobEnqueueResult, Manifest, Scope } from '../types.ts';
+export declare const JOB_CHANNEL = "ket_job_ready";
+export type JobState = 'available' | 'scheduled' | 'executing' | 'retryable' | 'completed' | 'discarded' | 'cancelled';
+export type DurableJob = {
+    id: string;
+    job: string;
+    queue: string;
+    args: Record<string, unknown>;
+    /** Compatibility spelling retained for the original createQueue callers. */
+    payload: unknown;
+    state: JobState;
+    priority: number;
+    attempt: number;
+    attempts: number;
+    maxAttempts: number;
+    scheduledAt: string;
+    attemptedAt: string | null;
+    completedAt: string | null;
+    workerId: string | null;
+    leaseUntil: string | null;
+    actor: string | null;
+    scope: Scope;
+    uniqueKey: string | null;
+    errors: Array<{
+        at: string;
+        attempt: number;
+        message: string;
+    }>;
+    insertedAt: string;
+    updatedAt: string;
+};
+export type EnqueueJobOptions = JobEnqueueOptions & {
+    queue?: string;
+    maxAttempts?: number;
+    actor?: string | null;
+    scope?: Scope;
+};
+export type QueueListOptions = {
+    state?: JobState;
+    queue?: string;
+    limit?: number;
+};
+export type Queue = {
+    enqueue(job: string, args: Record<string, unknown>, options?: EnqueueJobOptions): Promise<JobEnqueueResult>;
+    claim(queue: string): Promise<DurableJob | null>;
+    claimBatch(queue: string, options: {
+        limit?: number;
+        workerId: string;
+        leaseMs?: number;
+    }): Promise<DurableJob[]>;
+    heartbeat(id: string, workerId: string, leaseMs?: number): Promise<boolean>;
+    complete(id: string, workerId?: string): Promise<boolean>;
+    retry(id: string, error: unknown, runAt: Date, workerId?: string): Promise<boolean>;
+    discard(id: string, error: unknown, workerId?: string): Promise<boolean>;
+    cancel(id: string): Promise<boolean>;
+    /** Operator retry for retryable/discarded jobs; preserves attempt history. */
+    retryNow(id: string): Promise<boolean>;
+    rescue(options?: {
+        limit?: number;
+    }): Promise<{
+        retried: number;
+        discarded: number;
+    }>;
+    get(id: string): Promise<DurableJob | null>;
+    list(options?: QueueListOptions): Promise<DurableJob[]>;
+    prune(options?: {
+        completedBefore?: Date;
+        discardedBefore?: Date;
+    }): Promise<number>;
+    pending(queue: string): Promise<number>;
+    fail(id: string): Promise<void>;
+    release(id: string): Promise<void>;
+};
+export declare function validateJobInput(job: string, manifest: Manifest, args: Record<string, unknown>): void;
+export declare function createQueue(adapter: Adapter, options?: {
+    now?: () => Date;
+    notify?: boolean;
+}): Promise<Queue>;
+export declare function queueFor(adapter: Adapter): Promise<Queue>;
+//# sourceMappingURL=queue.d.ts.map

package/dist/server/queue.d.ts.map

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