@hyperfixation/db 0.1.0

package/dist/schema/app.js

@@ -0,0 +1,23 @@
+import { sql } from "drizzle-orm";
+import { bigint, boolean, check, integer, jsonb, numeric, pgTable, text, timestamp, } from "drizzle-orm/pg-core";
+// Singleton. `budget_usd` is only the default copied into each new hf_budget_period
+// row; `month`, `spent_usd` and `reserved_usd` deliberately do not exist — spend
+// lives per period in hf_budget_period and the reservation is derived from the
+// hf_llm_call rows still in `started`.
+export const hfAppState = pgTable("hf_app_state", {
+    id: integer("id").primaryKey().default(1),
+    paused: boolean("paused").notNull().default(false),
+    pausedBy: text("paused_by"),
+    budgetUsd: numeric("budget_usd", { precision: 12, scale: 4 }).notNull(),
+    readTokenHash: text("read_token_hash"),
+    writeTokenHash: text("write_token_hash"),
+}, (t) => [check("hf_app_state_singleton", sql `${t.id} = 1`)]);
+export const hfAudit = pgTable("hf_audit", {
+    id: bigint("id", { mode: "number" }).generatedAlwaysAsIdentity().primaryKey(),
+    actorId: text("actor_id"),
+    action: text("action").notNull(),
+    targetType: text("target_type"),
+    targetId: text("target_id"),
+    meta: jsonb("meta"),
+    at: timestamp("at", { withTimezone: true, mode: "date" }).notNull().defaultNow(),
+});

package/dist/schema/approvals.d.ts

@@ -0,0 +1,352 @@
+export declare const approvalStatuses: readonly ["pending", "approved", "rejected", "expired", "cancelled"];
+export type ApprovalStatus = (typeof approvalStatuses)[number];
+/** Everything that can decide an approval; `sweep` is `reconcile()` step (5) expiring one. */
+export declare const approvalVias: readonly ["web", "telegram", "admin", "archive", "sweep"];
+export type ApprovalVia = (typeof approvalVias)[number];
+export declare const hfApproval: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "hf_approval";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "hf_approval";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: "always";
+            generated: undefined;
+        }, {}, {}>;
+        runId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "run_id";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workflowId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workflow_id";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "type";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        recordType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "record_type";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        recordId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "record_id";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        draft: import("drizzle-orm/pg-core").PgColumn<{
+            name: "draft";
+            tableName: "hf_approval";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        editedDraft: import("drizzle-orm/pg-core").PgColumn<{
+            name: "edited_draft";
+            tableName: "hf_approval";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: "pending" | "approved" | "rejected" | "expired" | "cancelled";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["pending", "approved", "rejected", "expired", "cancelled"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        assigneeId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "assignee_id";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        decidedBy: import("drizzle-orm/pg-core").PgColumn<{
+            name: "decided_by";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        decidedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "decided_at";
+            tableName: "hf_approval";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        decidedVia: import("drizzle-orm/pg-core").PgColumn<{
+            name: "decided_via";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: "web" | "telegram" | "admin" | "archive" | "sweep";
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["web", "telegram", "admin", "archive", "sweep"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        decisionKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "decision_key";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        resumeWorkflowId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "resume_workflow_id";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        notifiedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "notified_at";
+            tableName: "hf_approval";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        expiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "expires_at";
+            tableName: "hf_approval";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        batchId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "batch_id";
+            tableName: "hf_approval";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "hf_approval";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/schema/approvals.js

@@ -0,0 +1,43 @@
+import { bigint, index, jsonb, pgTable, text, timestamp, uniqueIndex, } from "drizzle-orm/pg-core";
+export const approvalStatuses = [
+    "pending",
+    "approved",
+    "rejected",
+    "expired",
+    "cancelled",
+];
+/** Everything that can decide an approval; `sweep` is `reconcile()` step (5) expiring one. */
+export const approvalVias = ["web", "telegram", "admin", "archive", "sweep"];
+export const hfApproval = pgTable("hf_approval", {
+    id: bigint("id", { mode: "number" }).generatedAlwaysAsIdentity().primaryKey(),
+    runId: text("run_id").notNull(),
+    key: text("key").notNull(),
+    // The attempt that created the row. Informational: the decision is fenced by the
+    // `hf_run` lock `decide()` takes, not by this column.
+    workflowId: text("workflow_id").notNull(),
+    type: text("type").notNull(),
+    recordType: text("record_type"),
+    recordId: text("record_id"),
+    draft: jsonb("draft"),
+    editedDraft: jsonb("edited_draft"),
+    status: text("status", { enum: approvalStatuses }).notNull(),
+    assigneeId: text("assignee_id"),
+    decidedBy: text("decided_by"),
+    decidedAt: timestamp("decided_at", { withTimezone: true, mode: "date" }),
+    decidedVia: text("decided_via", { enum: approvalVias }),
+    // The replay token: a second `decide()` carrying a key already on the row returns the
+    // first one's result and writes nothing.
+    decisionKey: text("decision_key"),
+    /** The attempt `decide()` enqueued to carry the run on; informational. */
+    resumeWorkflowId: text("resume_workflow_id"),
+    notifiedAt: timestamp("notified_at", { withTimezone: true, mode: "date" }),
+    expiresAt: timestamp("expires_at", { withTimezone: true, mode: "date" }),
+    batchId: text("batch_id"),
+    createdAt: timestamp("created_at", { withTimezone: true, mode: "date" })
+        .notNull()
+        .defaultNow(),
+}, (t) => [
+    uniqueIndex("hf_approval_run_key_uq").on(t.runId, t.key),
+    // The inbox scan and `reconcile()` step (5)'s expiry scan, which both read by status.
+    index("hf_approval_status_idx").on(t.status, t.expiresAt),
+]);