@browserlessapi/inferlo 0.0.0-stage → 0.4.0

package/dist/cron.js

@@ -0,0 +1,143 @@
+/**
+ * Cron: run a job on a schedule. cron("0 * * * *", hourlyReport) enqueues hourlyReport at the start
+ * of every hour (UTC) while a worker runs (app.jobs.start() or inferlo worker).
+ *
+ * A cron schedules a job, so retries, logging and the job queue work the same way. Each tick gets a
+ * fixed job id, so with the database queue every instance can run the schedule and the job is
+ * still queued once per tick.
+ */
+import { InferloError } from "./errors.js";
+const FIELDS = [
+    { min: 0, max: 59 },
+    { min: 0, max: 23 },
+    { min: 1, max: 31 },
+    { min: 1, max: 12, names: ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"] },
+    { min: 0, max: 7, names: ["sun", "mon", "tue", "wed", "thu", "fri", "sat"] },
+];
+const FIELD_NAMES = ["minute", "hour", "day of month", "month", "day of week"];
+const FIX = 'Use five fields "minute hour day-of-month month day-of-week" in UTC, for example "0 * * * *" (every hour), "*/15 * * * *" (every 15 minutes) or "30 3 * * 1-5" (03:30 on weekdays).';
+function invalid(schedule, problem) {
+    return new InferloError("IL6013", `Invalid cron schedule ${JSON.stringify(schedule)}: ${problem}.`, { fix: FIX });
+}
+function parseValue(text, field, schedule, name) {
+    const lower = text.toLowerCase();
+    const named = field.names?.indexOf(lower) ?? -1;
+    if (named !== -1)
+        return named + field.min;
+    if (!/^\d+$/.test(text))
+        throw invalid(schedule, `"${text}" is not a valid ${name}`);
+    const n = Number(text);
+    if (n < field.min || n > field.max)
+        throw invalid(schedule, `${name} ${n} is outside ${field.min}-${field.max}`);
+    return n;
+}
+/** The allowed values of one field, and whether it was "*" (no restriction). */
+function parseField(text, field, schedule, name) {
+    const values = new Set();
+    for (const part of text.split(",")) {
+        const [range, stepText, extra] = part.split("/");
+        if (extra !== undefined || range === undefined || range === "")
+            throw invalid(schedule, `"${part}" is not a valid ${name}`);
+        let step = 1;
+        if (stepText !== undefined) {
+            if (!/^\d+$/.test(stepText) || Number(stepText) < 1)
+                throw invalid(schedule, `step "${stepText}" in the ${name} must be a whole number of at least 1`);
+            step = Number(stepText);
+        }
+        let from;
+        let to;
+        if (range === "*") {
+            from = field.min;
+            to = field.max;
+        }
+        else if (range.includes("-")) {
+            const [a, b, more] = range.split("-");
+            if (more !== undefined || !a || !b)
+                throw invalid(schedule, `"${range}" is not a valid ${name} range`);
+            from = parseValue(a, field, schedule, name);
+            to = parseValue(b, field, schedule, name);
+            if (from > to)
+                throw invalid(schedule, `the ${name} range "${range}" goes backwards`);
+        }
+        else {
+            from = parseValue(range, field, schedule, name);
+            to = stepText === undefined ? from : field.max;
+        }
+        for (let v = from; v <= to; v += step)
+            values.add(v);
+    }
+    return { values, any: text === "*" };
+}
+/** Parse a schedule into a function giving the first tick strictly after a time. Raises IL6013. */
+export function parseCron(schedule) {
+    if (typeof schedule !== "string")
+        throw invalid(schedule, "it must be a string");
+    const parts = schedule.trim().split(/\s+/);
+    if (parts.length !== 5)
+        throw invalid(schedule, `it has ${parts.length} field(s), not 5`);
+    const [minute, hour, dom, month, dow] = parts.map((p, i) => parseField(p, FIELDS[i], schedule, FIELD_NAMES[i]));
+    if (dow.values.has(7))
+        dow.values.add(0); // 7 is Sunday too
+    const dayMatches = (d) => {
+        const domOk = dom.values.has(d.getUTCDate());
+        const dowOk = dow.values.has(d.getUTCDay());
+        // Standard cron: when both day fields are restricted, either one matching is enough.
+        if (!dom.any && !dow.any)
+            return domOk || dowOk;
+        return domOk && dowOk;
+    };
+    return (after) => {
+        const t = new Date(after.getTime());
+        t.setUTCSeconds(0, 0);
+        t.setUTCMinutes(t.getUTCMinutes() + 1);
+        // Enough steps to reach any valid tick (February 29 comes every four years, or eight around 2100).
+        for (let guard = 0; guard < 366 * 5 * 24 * 2; guard++) {
+            if (!month.values.has(t.getUTCMonth() + 1)) {
+                t.setUTCMonth(t.getUTCMonth() + 1, 1);
+                t.setUTCHours(0, 0, 0, 0);
+            }
+            else if (!dayMatches(t)) {
+                t.setUTCDate(t.getUTCDate() + 1);
+                t.setUTCHours(0, 0, 0, 0);
+            }
+            else if (!hour.values.has(t.getUTCHours())) {
+                t.setUTCHours(t.getUTCHours() + 1, 0, 0, 0);
+            }
+            else if (!minute.values.has(t.getUTCMinutes())) {
+                t.setUTCMinutes(t.getUTCMinutes() + 1, 0, 0);
+            }
+            else
+                return t;
+        }
+        throw invalid(schedule, "it never matches a date");
+    };
+}
+/** Run a job on a schedule: export const hourly = cron("0 * * * *", sendReport). Times are UTC. */
+export function cron(schedule, job) {
+    const next = parseCron(schedule);
+    if (!job || job.kind !== "inferlo.job") {
+        throw new InferloError("IL6013", `cron(${JSON.stringify(schedule)}, ...) needs a job as its second argument.`, {
+            fix: 'Pass a job: cron("0 * * * *", job("hourly-report", { input: t.object({}) }).handle(async ({ db }) => { ... })).',
+        });
+    }
+    if (!job.options.input.safeParse({}).ok) {
+        throw new InferloError("IL6013", `The job "${job.name}" is run by cron with the input {}, but its input schema does not accept {}.`, {
+            fix: "Give jobs run by cron the input t.object({}) (or fields with defaults), and read what they need from the database.",
+        });
+    }
+    next(new Date(0)); // a schedule that never matches (such as "0 0 31 2 *") fails here, not in the worker
+    return { kind: "inferlo.cron", schedule: schedule.trim().split(/\s+/).join(" "), job, next };
+}
+export function isCron(value) {
+    return typeof value === "object" && value !== null && value.kind === "inferlo.cron";
+}
+/** A fixed UUID for one tick of a cron, so every instance queues the same job id. */
+export async function cronTickId(def, tick) {
+    const data = new TextEncoder().encode(`inferlo.cron:${def.job.name}:${def.schedule}:${tick.toISOString()}`);
+    const bytes = new Uint8Array(await crypto.subtle.digest("SHA-256", data)).slice(0, 16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x80; // version 8 (custom)
+    bytes[8] = (bytes[8] & 0x3f) | 0x80; // RFC 4122 variant
+    const hex = [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+//# sourceMappingURL=cron.js.map

package/dist/cron.js.map

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

package/dist/db/memory.d.ts

@@ -0,0 +1,2 @@
+import type { Adapter } from "./types.ts";
+export declare function memory(): Adapter;

package/dist/db/memory.js

@@ -0,0 +1,128 @@
+/**
+ * In-memory adapter for tests, prototypes and examples. Data is lost when the process exits.
+ * Enforces unique fields the same way Postgres does (IL4004, HTTP 409).
+ */
+import { InferloError } from "../errors.js";
+function compare(a, b) {
+    const x = a instanceof Date ? a.getTime() : a;
+    const y = b instanceof Date ? b.getTime() : b;
+    if (x === y)
+        return 0;
+    if (x === null || x === undefined)
+        return 1;
+    if (y === null || y === undefined)
+        return -1;
+    return x < y ? -1 : 1;
+}
+function likeToRegex(pattern, flags) {
+    const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/%/g, ".*").replace(/_/g, ".");
+    return new RegExp(`^${escaped}$`, flags);
+}
+function matches(row, conditions) {
+    return conditions.every(({ field, op, value }) => {
+        const v = row[field];
+        switch (op) {
+            case "eq":
+                return compare(v, value) === 0 && v !== null && v !== undefined;
+            case "ne":
+                return v !== null && v !== undefined && compare(v, value) !== 0;
+            case "gt":
+                return v != null && compare(v, value) > 0;
+            case "gte":
+                return v != null && compare(v, value) >= 0;
+            case "lt":
+                return v != null && compare(v, value) < 0;
+            case "lte":
+                return v != null && compare(v, value) <= 0;
+            case "in":
+                return value.some((x) => compare(v, x) === 0);
+            case "notIn":
+                return v != null && !value.some((x) => compare(v, x) === 0);
+            case "like":
+                return typeof v === "string" && likeToRegex(String(value), "").test(v);
+            case "ilike":
+                return typeof v === "string" && likeToRegex(String(value), "i").test(v);
+            case "isNull":
+                return value ? v === null || v === undefined : v !== null && v !== undefined;
+        }
+    });
+}
+function clone(row) {
+    return structuredClone(row);
+}
+export function memory() {
+    const tables = new Map();
+    const rowsOf = (model) => {
+        let rows = tables.get(model.name);
+        if (!rows)
+            tables.set(model.name, (rows = []));
+        return rows;
+    };
+    const checkUnique = (model, candidate, ignoreId) => {
+        for (const [field, schema] of Object.entries(model.fields)) {
+            if (!schema.def.unique || candidate[field] == null)
+                continue;
+            const clash = rowsOf(model).find((r) => r.id !== ignoreId && compare(r[field], candidate[field]) === 0);
+            if (clash) {
+                throw new InferloError("IL4004", `A ${model.name} row with this ${field} already exists.`, { status: 409, details: { table: model.name, field } });
+            }
+        }
+    };
+    return {
+        dialect: "memory",
+        async insert(model, row) {
+            checkUnique(model, row);
+            const stored = clone(row);
+            for (const key of Object.keys(model.fields))
+                if (!(key in stored))
+                    stored[key] = null;
+            rowsOf(model).push(stored);
+            return clone(stored);
+        },
+        async select(model, query) {
+            let rows = rowsOf(model).filter((r) => matches(r, query.where));
+            if (query.orderBy.length) {
+                rows = [...rows].sort((a, b) => {
+                    for (const [field, dir] of query.orderBy) {
+                        const c = compare(a[field], b[field]);
+                        if (c !== 0)
+                            return dir === "asc" ? c : -c;
+                    }
+                    return 0;
+                });
+            }
+            const start = query.offset ?? 0;
+            return rows.slice(start, query.limit === undefined ? undefined : start + query.limit).map(clone);
+        },
+        async update(model, where, patch) {
+            const out = [];
+            for (const row of rowsOf(model)) {
+                if (!matches(row, where))
+                    continue;
+                checkUnique(model, { ...row, ...patch }, row.id);
+                Object.assign(row, clone(patch));
+                out.push(clone(row));
+            }
+            return out;
+        },
+        async delete(model, where) {
+            const rows = rowsOf(model);
+            const keep = rows.filter((r) => !matches(r, where));
+            const removed = rows.length - keep.length;
+            tables.set(model.name, keep);
+            return removed;
+        },
+        async count(model, where) {
+            return rowsOf(model).filter((r) => matches(r, where)).length;
+        },
+        async sync(models) {
+            for (const m of models)
+                rowsOf(m);
+            return [];
+        },
+        async close() {
+            tables.clear();
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/db/memory.js.map

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

package/dist/db/migrate.d.ts

@@ -0,0 +1,87 @@
+import { type AnyModel } from "../model.ts";
+import type { DbRecord } from "./types.ts";
+/** One column in migrations/snapshot.json. Compared field by field to find column changes. */
+export interface MigrationSnapshotColumn {
+    /** Postgres type, e.g. "text", "varchar(80)", "integer", "jsonb". */
+    type: string;
+    /** NOT NULL (required fields). */
+    notNull: boolean;
+    /** SQL DEFAULT expression, e.g. "0", "'open'", "now()". Absent when there is no fixed default. */
+    default?: string;
+    /** Allowed values of a t.enum field (CHECK constraint). */
+    enum?: string[];
+    /** Foreign key of a t.ref field. */
+    references?: {
+        table: string;
+        onDelete: "restrict" | "cascade" | "set null";
+    };
+    /** Only the "id" column. */
+    primaryKey?: true;
+}
+/** The models as of the last generated migration. Stored as migrations/snapshot.json. */
+export interface MigrationSnapshot {
+    inferlo: 2;
+    tables: Record<string, {
+        columns: Record<string, MigrationSnapshotColumn>;
+        indexes: Record<string, string>;
+    }>;
+}
+/** The snapshot format written by Inferlo 0.2.0 (each column as its SQL definition). planMigration upgrades it. */
+export interface MigrationSnapshotV1 {
+    inferlo: 1;
+    tables: Record<string, {
+        columns: Record<string, string>;
+        indexes: Record<string, string>;
+    }>;
+}
+export interface MigrationPlan {
+    /** SQL statements to put in the new migration file, in order. Empty when nothing changed. */
+    statements: string[];
+    /** Snapshot to save after writing the file. */
+    snapshot: MigrationSnapshot;
+    /** The drops included in `statements`, e.g. "drop column tasks.notes". Empty unless allowDrop was set. */
+    drops: string[];
+    /** The column changes included in `statements`, e.g. "change column tasks.done (default false -> none)". Empty unless allowChange was set. */
+    changes: string[];
+}
+export interface PlanMigrationOptions {
+    /** Generate DROP statements for removed tables, columns and indexes. These delete data. Default false. */
+    allowDrop?: boolean;
+    /**
+     * Generate type, default, required/optional and enum value changes of existing columns (ALTER
+     * COLUMN ... TYPE, SET DEFAULT, DROP DEFAULT, SET NOT NULL, DROP NOT NULL, and replacing the enum's
+     * CHECK constraint). Changing the type fails at apply time (IL4022) if an existing value does not
+     * convert. Making a column required fails at apply time (IL4020) if rows still have NULL in it,
+     * unless the field has a fixed default, which fills them. Removing an enum value fails at apply
+     * time (IL4021) if rows still use it. Default false.
+     */
+    allowChange?: boolean;
+}
+export interface Migration {
+    /** File name without .sql, e.g. "0001_init". Sorted by name to decide the order. */
+    name: string;
+    sql: string;
+}
+/** SQL to bring the database from `previous` (or an empty database) to `models`. */
+export declare function planMigration(models: readonly AnyModel[], previous?: MigrationSnapshot | MigrationSnapshotV1, options?: PlanMigrationOptions): MigrationPlan;
+interface SqlDb {
+    $sql(text: string, params?: unknown[]): Promise<DbRecord[]>;
+    $transaction<T>(fn: (tx: SqlDb) => Promise<T>): Promise<T>;
+}
+export interface ApplyMigrationsOptions {
+    /**
+     * Called with the names of migrations that were already applied but whose SQL has changed since
+     * (IL4018). They are not run again. Restore the applied SQL and put the change in a new file.
+     */
+    onEdited?: (names: string[]) => void;
+}
+/**
+ * Run the migrations that are not yet recorded in the "inferlo_migrations" table, in name order,
+ * each in its own transaction. Returns the names it applied. Safe to run from several processes
+ * at once (a Postgres advisory lock serialises them).
+ *
+ * Each applied migration is recorded with a checksum of its SQL. Applied migrations whose SQL has
+ * changed since are reported to options.onEdited (IL4018) and are not run again.
+ */
+export declare function applyMigrations(db: SqlDb, migrations: readonly Migration[], options?: ApplyMigrationsOptions): Promise<string[]>;
+export {};