@umec/core 0.1.0-alpha.8 → 0.1.0-alpha.9

package/schema/migrations/0004_admin_audit_log.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS admin_audit_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_type TEXT NOT NULL,
+  entity_id TEXT NOT NULL,
+  action TEXT NOT NULL,
+  delta INTEGER,
+  reason TEXT,
+  admin_email TEXT,
+  actor TEXT NOT NULL DEFAULT 'human',
+  detail_json TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_admin_audit_log_entity
+  ON admin_audit_log(entity_type, entity_id, created_at);

package/schema/migrations/0005_orders_tracking.sql

@@ -0,0 +1,3 @@
+ALTER TABLE orders ADD COLUMN tracking_number TEXT;
+ALTER TABLE orders ADD COLUMN carrier TEXT
+  CHECK (carrier IN ('yamato', 'sagawa', 'japanpost', 'other') OR carrier IS NULL);

package/schema/migrations/0006_products.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS products (
+  sku TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT,
+  price INTEGER NOT NULL CHECK (price > 0),
+  shipping_units INTEGER NOT NULL DEFAULT 1 CHECK (shipping_units > 0),
+  images_json TEXT,
+  gtin TEXT,
+  category TEXT,
+  active INTEGER NOT NULL DEFAULT 1 CHECK (active IN (0, 1)),
+  low_stock_threshold INTEGER,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  updated_by TEXT
+);

package/schema/migrations/0007_orders_extras.sql

@@ -0,0 +1 @@
+ALTER TABLE orders ADD COLUMN extras_json TEXT;

package/schema/snapshot.json

@@ -0,0 +1,433 @@
+{
+  "version": 7,
+  "tables": {
+    "processed_events": {
+      "name": "processed_events",
+      "sql": "CREATE TABLE processed_events (\n  event_id     TEXT PRIMARY KEY,\n  processed_at INTEGER NOT NULL\n)",
+      "columns": [
+        {
+          "cid": 0,
+          "name": "event_id",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 1
+        },
+        {
+          "cid": 1,
+          "name": "processed_at",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        }
+      ],
+      "indexes": [],
+      "foreignKeys": []
+    },
+    "orders": {
+      "name": "orders",
+      "sql": "CREATE TABLE orders (\n  id                 TEXT PRIMARY KEY,\n  email              TEXT NOT NULL,\n  name               TEXT,\n  phone              TEXT,\n  items_json         TEXT NOT NULL,\n  amount             INTEGER NOT NULL,\n  shipping           INTEGER,\n  address_json       TEXT,\n  payment_intent     TEXT,\n  custom_fields_json TEXT,\n  status             TEXT NOT NULL DEFAULT 'pending',\n  run_id             TEXT,\n  email_status       TEXT CHECK (email_status IN ('sent', 'failed')),\n  created_at         INTEGER NOT NULL,\n  shipped_at         INTEGER\n, tracking_number TEXT, carrier TEXT\n  CHECK (carrier IN ('yamato', 'sagawa', 'japanpost', 'other') OR carrier IS NULL), extras_json TEXT)",
+      "columns": [
+        {
+          "cid": 0,
+          "name": "id",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 1
+        },
+        {
+          "cid": 1,
+          "name": "email",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 2,
+          "name": "name",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 3,
+          "name": "phone",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 4,
+          "name": "items_json",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 5,
+          "name": "amount",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 6,
+          "name": "shipping",
+          "type": "INTEGER",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 7,
+          "name": "address_json",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 8,
+          "name": "payment_intent",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 9,
+          "name": "custom_fields_json",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 10,
+          "name": "status",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": "'pending'",
+          "pk": 0
+        },
+        {
+          "cid": 11,
+          "name": "run_id",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 12,
+          "name": "email_status",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 13,
+          "name": "created_at",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 14,
+          "name": "shipped_at",
+          "type": "INTEGER",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 15,
+          "name": "tracking_number",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 16,
+          "name": "carrier",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 17,
+          "name": "extras_json",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        }
+      ],
+      "indexes": [
+        {
+          "name": "orders_payment_intent_idx",
+          "unique": 0,
+          "origin": "c",
+          "columns": [
+            "payment_intent"
+          ]
+        }
+      ],
+      "foreignKeys": []
+    },
+    "inventory": {
+      "name": "inventory",
+      "sql": "CREATE TABLE inventory (\n  sku        TEXT PRIMARY KEY,\n  stock      INTEGER NOT NULL DEFAULT 0,\n  updated_at INTEGER NOT NULL\n)",
+      "columns": [
+        {
+          "cid": 0,
+          "name": "sku",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 1
+        },
+        {
+          "cid": 1,
+          "name": "stock",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": "0",
+          "pk": 0
+        },
+        {
+          "cid": 2,
+          "name": "updated_at",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        }
+      ],
+      "indexes": [],
+      "foreignKeys": []
+    },
+    "admin_audit_log": {
+      "name": "admin_audit_log",
+      "sql": "CREATE TABLE admin_audit_log (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  entity_type TEXT NOT NULL,\n  entity_id TEXT NOT NULL,\n  action TEXT NOT NULL,\n  delta INTEGER,\n  reason TEXT,\n  admin_email TEXT,\n  actor TEXT NOT NULL DEFAULT 'human',\n  detail_json TEXT,\n  created_at INTEGER NOT NULL\n)",
+      "columns": [
+        {
+          "cid": 0,
+          "name": "id",
+          "type": "INTEGER",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 1
+        },
+        {
+          "cid": 1,
+          "name": "entity_type",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 2,
+          "name": "entity_id",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 3,
+          "name": "action",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 4,
+          "name": "delta",
+          "type": "INTEGER",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 5,
+          "name": "reason",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 6,
+          "name": "admin_email",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 7,
+          "name": "actor",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": "'human'",
+          "pk": 0
+        },
+        {
+          "cid": 8,
+          "name": "detail_json",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 9,
+          "name": "created_at",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        }
+      ],
+      "indexes": [
+        {
+          "name": "idx_admin_audit_log_entity",
+          "unique": 0,
+          "origin": "c",
+          "columns": [
+            "entity_type",
+            "entity_id",
+            "created_at"
+          ]
+        }
+      ],
+      "foreignKeys": []
+    },
+    "products": {
+      "name": "products",
+      "sql": "CREATE TABLE products (\n  sku TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  description TEXT,\n  price INTEGER NOT NULL CHECK (price > 0),\n  shipping_units INTEGER NOT NULL DEFAULT 1 CHECK (shipping_units > 0),\n  images_json TEXT,\n  gtin TEXT,\n  category TEXT,\n  active INTEGER NOT NULL DEFAULT 1 CHECK (active IN (0, 1)),\n  low_stock_threshold INTEGER,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  updated_by TEXT\n)",
+      "columns": [
+        {
+          "cid": 0,
+          "name": "sku",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 1
+        },
+        {
+          "cid": 1,
+          "name": "name",
+          "type": "TEXT",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 2,
+          "name": "description",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 3,
+          "name": "price",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 4,
+          "name": "shipping_units",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": "1",
+          "pk": 0
+        },
+        {
+          "cid": 5,
+          "name": "images_json",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 6,
+          "name": "gtin",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 7,
+          "name": "category",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 8,
+          "name": "active",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": "1",
+          "pk": 0
+        },
+        {
+          "cid": 9,
+          "name": "low_stock_threshold",
+          "type": "INTEGER",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 10,
+          "name": "created_at",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 11,
+          "name": "updated_at",
+          "type": "INTEGER",
+          "notnull": 1,
+          "dflt_value": null,
+          "pk": 0
+        },
+        {
+          "cid": 12,
+          "name": "updated_by",
+          "type": "TEXT",
+          "notnull": 0,
+          "dflt_value": null,
+          "pk": 0
+        }
+      ],
+      "indexes": [],
+      "foreignKeys": []
+    }
+  }
+}

package/schema/upgrades/types.ts

@@ -0,0 +1,16 @@
+export type UpgradeExecutor = {
+  exec(sql: string): Promise<void>;
+  all<T>(sql: string, params?: unknown[]): Promise<T[]>;
+  first<T>(sql: string, params?: unknown[]): Promise<T | null>;
+  run(sql: string, params?: unknown[]): Promise<{ changes: number }>;
+};
+
+export type UpgradeModule = {
+  name: string;
+  fromVersion: number;
+  toVersion: number;
+  description: string;
+  replacesChecksums: readonly string[];
+  canApply(db: UpgradeExecutor): Promise<boolean>;
+  apply(db: UpgradeExecutor): Promise<void>;
+};

package/schema/upgrades/v2-to-v6.ts

@@ -0,0 +1,205 @@
+import type { UpgradeExecutor, UpgradeModule } from "./types.js";
+
+export const UPGRADE_PAGE_SIZE = 500;
+
+export const LEGACY_0002_SQL = `CREATE TABLE IF NOT EXISTS orders (
+  event_id       TEXT PRIMARY KEY NOT NULL,
+  session_id     TEXT NOT NULL,
+  amount_total   INTEGER NOT NULL,
+  currency       TEXT NOT NULL,
+  customer_email TEXT NOT NULL,
+  run_id         TEXT,
+  created_at     INTEGER NOT NULL
+);
+`;
+
+export const V6_ORDERS_DDL = `CREATE TABLE orders_new (
+  id                 TEXT PRIMARY KEY,
+  email              TEXT NOT NULL,
+  name               TEXT,
+  phone              TEXT,
+  items_json         TEXT NOT NULL,
+  amount             INTEGER NOT NULL,
+  shipping           INTEGER,
+  address_json       TEXT,
+  payment_intent     TEXT,
+  custom_fields_json TEXT,
+  status             TEXT NOT NULL DEFAULT 'pending',
+  run_id             TEXT,
+  email_status       TEXT CHECK (email_status IN ('sent', 'failed')),
+  created_at         INTEGER NOT NULL,
+  shipped_at         INTEGER,
+  tracking_number    TEXT,
+  carrier            TEXT CHECK (carrier IN ('yamato', 'sagawa', 'japanpost', 'other') OR carrier IS NULL)
+)`;
+
+type LegacyOrderRow = {
+  event_id: string;
+  session_id?: string | null;
+  amount_total?: number | null;
+  amount?: number | null;
+  customer_email?: string | null;
+  email?: string | null;
+  name?: string | null;
+  phone?: string | null;
+  items_json?: string | null;
+  shipping?: number | null;
+  address_json?: string | null;
+  payment_intent?: string | null;
+  custom_fields_json?: string | null;
+  status?: string | null;
+  run_id?: string | null;
+  email_status?: string | null;
+  created_at: number;
+  shipped_at?: number | null;
+  tracking_number?: string | null;
+  carrier?: string | null;
+};
+
+type TableInfoRow = {
+  name: string;
+  pk: number;
+};
+
+function asString(value: unknown, fallback = ""): string {
+  return typeof value === "string" ? value : fallback;
+}
+
+function asNullableString(value: unknown): string | null {
+  return typeof value === "string" ? value : null;
+}
+
+function asNumber(value: unknown, fallback = 0): number {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+
+function asNullableNumber(value: unknown): number | null {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+export async function detectLegacyOrdersPk(db: UpgradeExecutor): Promise<boolean> {
+  const columns = await db.all<TableInfoRow>("PRAGMA table_info(orders)");
+  if (columns.length === 0) return false;
+  const eventId = columns.find((column) => column.name === "event_id");
+  return eventId != null && eventId.pk === 1;
+}
+
+export function mapLegacyOrder(row: LegacyOrderRow): {
+  id: string;
+  email: string;
+  name: string | null;
+  phone: string | null;
+  items_json: string;
+  amount: number;
+  shipping: number | null;
+  address_json: string | null;
+  payment_intent: string | null;
+  custom_fields_json: string | null;
+  status: string;
+  run_id: string | null;
+  email_status: string | null;
+  created_at: number;
+  shipped_at: number | null;
+  tracking_number: string | null;
+  carrier: string | null;
+} {
+  const sessionId = asNullableString(row.session_id);
+  const eventId = asString(row.event_id);
+  return {
+    id: sessionId && sessionId.length > 0 ? sessionId : eventId,
+    email: asString(row.customer_email ?? row.email),
+    name: asNullableString(row.name),
+    phone: asNullableString(row.phone),
+    items_json: asNullableString(row.items_json) ?? "[]",
+    amount: asNumber(row.amount_total ?? row.amount),
+    shipping: asNullableNumber(row.shipping),
+    address_json: asNullableString(row.address_json),
+    payment_intent: asNullableString(row.payment_intent),
+    custom_fields_json: asNullableString(row.custom_fields_json),
+    status: asNullableString(row.status) ?? "pending",
+    run_id: asNullableString(row.run_id),
+    email_status: asNullableString(row.email_status),
+    created_at: asNumber(row.created_at),
+    shipped_at: asNullableNumber(row.shipped_at),
+    tracking_number: asNullableString(row.tracking_number),
+    carrier: asNullableString(row.carrier),
+  };
+}
+
+export async function applyV2toV6(db: UpgradeExecutor): Promise<void> {
+  if (!(await detectLegacyOrdersPk(db))) {
+    throw new Error("v2-to-v6: orders.event_id primary key not found; refuse to rebuild");
+  }
+
+  await db.exec("DROP TABLE IF EXISTS orders_new");
+  await db.exec(V6_ORDERS_DDL);
+
+  let cursor: string | null = null;
+  for (;;) {
+    const pageSql = cursor
+      ? "SELECT * FROM orders WHERE event_id > ? ORDER BY event_id LIMIT ?"
+      : "SELECT * FROM orders ORDER BY event_id LIMIT ?";
+    const pageParams = cursor ? [cursor, UPGRADE_PAGE_SIZE] : [UPGRADE_PAGE_SIZE];
+    const rows: LegacyOrderRow[] = await db.all<LegacyOrderRow>(pageSql, pageParams);
+    if (rows.length === 0) break;
+
+    for (const row of rows) {
+      const mapped = mapLegacyOrder(row);
+      await db.run(
+        `INSERT INTO orders_new (
+          id, email, name, phone, items_json, amount, shipping, address_json,
+          payment_intent, custom_fields_json, status, run_id, email_status,
+          created_at, shipped_at, tracking_number, carrier
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [
+          mapped.id,
+          mapped.email,
+          mapped.name,
+          mapped.phone,
+          mapped.items_json,
+          mapped.amount,
+          mapped.shipping,
+          mapped.address_json,
+          mapped.payment_intent,
+          mapped.custom_fields_json,
+          mapped.status,
+          mapped.run_id,
+          mapped.email_status,
+          mapped.created_at,
+          mapped.shipped_at,
+          mapped.tracking_number,
+          mapped.carrier,
+        ],
+      );
+    }
+
+    const last: LegacyOrderRow | undefined = rows[rows.length - 1];
+    if (!last) break;
+    cursor = last.event_id;
+    if (rows.length < UPGRADE_PAGE_SIZE) break;
+  }
+
+  const oldCount = await db.first<{ n: number }>("SELECT COUNT(*) AS n FROM orders");
+  const newCount = await db.first<{ n: number }>("SELECT COUNT(*) AS n FROM orders_new");
+  const expected = oldCount?.n ?? -1;
+  const copied = newCount?.n ?? -2;
+  if (expected !== copied) {
+    throw new Error(
+      `v2-to-v6: COUNT mismatch orders=${expected} orders_new=${copied}. DROP skipped. Restore from Time Travel bookmark.`,
+    );
+  }
+
+  await db.exec("DROP TABLE orders");
+  await db.exec("ALTER TABLE orders_new RENAME TO orders");
+  await db.exec("CREATE INDEX IF NOT EXISTS orders_payment_intent_idx ON orders(payment_intent)");
+}
+
+export const upgradeV2toV6: UpgradeModule = {
+  name: "v2-to-v6",
+  fromVersion: 2,
+  toVersion: 6,
+  description: "Rebuild orders from event_id PK (v2) to id PK (v6)",
+  replacesChecksums: ["ca6ec5c885f715a3ae65a7101787d66750ed831370dc2ecde0636cfc3cf83e24"],
+  canApply: detectLegacyOrdersPk,
+  apply: applyV2toV6,
+};