@bluefields/db 0.2.0

package/dist/schema/host-records.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Per-host config table (Review #4; deferred from Review #2).
+ *
+ * Drives fetcher tier routing, proxy provider preference, politeness limits,
+ * robots-policy tracking, and takedown status. Small (one row per host we've
+ * ever fetched), read-heavy — cache in memory in the fetcher workers; refresh
+ * every 60 seconds.
+ */
+export declare const hostRecords: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "host_records";
+    schema: undefined;
+    columns: {
+        host: import("drizzle-orm/pg-core").PgColumn<{
+            name: "host";
+            tableName: "host_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fetchTier: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fetch_tier";
+            tableName: "host_records";
+            dataType: "number";
+            columnType: "PgSmallInt";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fetchTierUpdatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fetch_tier_updated_at";
+            tableName: "host_records";
+            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;
+        }, {}, {}>;
+        preferredProxyProvider: import("drizzle-orm/pg-core").PgColumn<{
+            name: "preferred_proxy_provider";
+            tableName: "host_records";
+            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;
+        }, {}, {}>;
+        maxConcurrentFetches: import("drizzle-orm/pg-core").PgColumn<{
+            name: "max_concurrent_fetches";
+            tableName: "host_records";
+            dataType: "number";
+            columnType: "PgSmallInt";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        observedAntiBot: import("drizzle-orm/pg-core").PgColumn<{
+            name: "observed_anti_bot";
+            tableName: "host_records";
+            dataType: "array";
+            columnType: "PgArray";
+            data: string[];
+            driverParam: string | string[];
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: import("drizzle-orm").Column<{
+                name: "observed_anti_bot";
+                tableName: "host_records";
+                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;
+            }, object, object>;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        robotsStatus: import("drizzle-orm/pg-core").PgColumn<{
+            name: "robots_status";
+            tableName: "host_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        takedownStatus: import("drizzle-orm/pg-core").PgColumn<{
+            name: "takedown_status";
+            tableName: "host_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        countryHint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "country_hint";
+            tableName: "host_records";
+            dataType: "string";
+            columnType: "PgChar";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        notes: import("drizzle-orm/pg-core").PgColumn<{
+            name: "notes";
+            tableName: "host_records";
+            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: "host_records";
+            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;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "host_records";
+            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";
+}>;
+export type HostRecord = typeof hostRecords.$inferSelect;
+export type NewHostRecord = typeof hostRecords.$inferInsert;

package/dist/schema/host-records.js

@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: Apache-2.0
+import { sql } from 'drizzle-orm';
+import { char, index, pgTable, smallint, text, timestamp } from 'drizzle-orm/pg-core';
+/**
+ * Per-host config table (Review #4; deferred from Review #2).
+ *
+ * Drives fetcher tier routing, proxy provider preference, politeness limits,
+ * robots-policy tracking, and takedown status. Small (one row per host we've
+ * ever fetched), read-heavy — cache in memory in the fetcher workers; refresh
+ * every 60 seconds.
+ */
+export const hostRecords = pgTable('host_records', {
+    // the normalized host, e.g. 'example.com'
+    host: text('host').primaryKey(),
+    // 0, 1, 2, 3 — the current working tier (Review #4)
+    fetchTier: smallint('fetch_tier').notNull().default(1),
+    fetchTierUpdatedAt: timestamp('fetch_tier_updated_at', { withTimezone: true })
+        .notNull()
+        .defaultNow(),
+    // e.g. 'decodo_residential_us'; null = default
+    preferredProxyProvider: text('preferred_proxy_provider'),
+    // politeness cap across all customers (Review #4)
+    maxConcurrentFetches: smallint('max_concurrent_fetches').notNull().default(2),
+    // ['cloudflare', 'datadome', 'akamai', 'perimeterx']
+    observedAntiBot: text('observed_anti_bot').array(),
+    // 'allowed' | 'disallowed' | 'unknown'
+    robotsStatus: text('robots_status').notNull().default('unknown'),
+    // 'active' | 'requested' | 'erased' (Review #2 takedown lifecycle)
+    takedownStatus: text('takedown_status').notNull().default('active'),
+    // ISO 3166-1 alpha-2 — geo-match proxies
+    countryHint: char('country_hint', { length: 2 }),
+    // human notes from ops
+    notes: text('notes'),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+}, (table) => [
+    index('idx_host_tier').on(table.fetchTier),
+    index('idx_host_takedown')
+        .on(table.takedownStatus)
+        .where(sql `${table.takedownStatus} != 'active'`),
+]);
+//# sourceMappingURL=host-records.js.map

package/dist/schema/host-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-records.js","sourceRoot":"","sources":["../../src/schema/host-records.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEtF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAChC,cAAc,EACd;IACE,0CAA0C;IAC1C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE;IAC/B,oDAAoD;IACpD,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,kBAAkB,EAAE,SAAS,CAAC,uBAAuB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SAC3E,OAAO,EAAE;SACT,UAAU,EAAE;IACf,+CAA+C;IAC/C,sBAAsB,EAAE,IAAI,CAAC,0BAA0B,CAAC;IACxD,kDAAkD;IAClD,oBAAoB,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,qDAAqD;IACrD,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE;IAClD,uCAAuC;IACvC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAChE,mEAAmE;IACnE,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnE,yCAAyC;IACzC,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChD,uBAAuB;IACvB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACjF,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;CAClF,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAC1C,KAAK,CAAC,mBAAmB,CAAC;SACvB,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;SACxB,KAAK,CAAC,GAAG,CAAA,GAAG,KAAK,CAAC,cAAc,cAAc,CAAC;CACnD,CACF,CAAC"}

package/dist/schema/notification-preferences.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Customer-facing notification preferences (billing-trust feature).
+ *
+ * One row per customer; absence of a row means "default opt-in" —
+ * notification check queries LEFT JOIN this table and COALESCE the
+ * enabled flags to true. Customers can disable specific alerts via
+ * an API endpoint (TODO: not yet wired) or by zeroing the threshold.
+ *
+ * Two alert kinds today:
+ *   - cost_anomaly: 24h cost > N x 7-day rolling average (N defaults to 2)
+ *   - delivery_health: webhook failure rate > N% over 6h (N defaults to 25)
+ *
+ * Both alerts debounce on `last_*_alert_at` — won't re-fire within 12h
+ * for the same customer + condition (prevents spam if the condition
+ * persists across multiple cron runs).
+ */
+export declare const notificationPreferences: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "notification_preferences";
+    schema: undefined;
+    columns: {
+        customerId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "customer_id";
+            tableName: "notification_preferences";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        costAnomalyEnabled: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cost_anomaly_enabled";
+            tableName: "notification_preferences";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        costAnomalyThresholdMultiplier: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cost_anomaly_threshold_multiplier";
+            tableName: "notification_preferences";
+            dataType: "string";
+            columnType: "PgNumeric";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deliveryHealthEnabled: import("drizzle-orm/pg-core").PgColumn<{
+            name: "delivery_health_enabled";
+            tableName: "notification_preferences";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deliveryHealthThresholdPct: import("drizzle-orm/pg-core").PgColumn<{
+            name: "delivery_health_threshold_pct";
+            tableName: "notification_preferences";
+            dataType: "number";
+            columnType: "PgSmallInt";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        emailOverride: import("drizzle-orm/pg-core").PgColumn<{
+            name: "email_override";
+            tableName: "notification_preferences";
+            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;
+        }, {}, {}>;
+        lastCostAlertAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_cost_alert_at";
+            tableName: "notification_preferences";
+            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;
+        }, {}, {}>;
+        lastDeliveryAlertAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_delivery_alert_at";
+            tableName: "notification_preferences";
+            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;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "notification_preferences";
+            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;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "notification_preferences";
+            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";
+}>;
+export type NotificationPreferences = typeof notificationPreferences.$inferSelect;
+export type NewNotificationPreferences = typeof notificationPreferences.$inferInsert;

package/dist/schema/notification-preferences.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { boolean, numeric, pgTable, smallint, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { customers } from './customers.js';
+/**
+ * Customer-facing notification preferences (billing-trust feature).
+ *
+ * One row per customer; absence of a row means "default opt-in" —
+ * notification check queries LEFT JOIN this table and COALESCE the
+ * enabled flags to true. Customers can disable specific alerts via
+ * an API endpoint (TODO: not yet wired) or by zeroing the threshold.
+ *
+ * Two alert kinds today:
+ *   - cost_anomaly: 24h cost > N x 7-day rolling average (N defaults to 2)
+ *   - delivery_health: webhook failure rate > N% over 6h (N defaults to 25)
+ *
+ * Both alerts debounce on `last_*_alert_at` — won't re-fire within 12h
+ * for the same customer + condition (prevents spam if the condition
+ * persists across multiple cron runs).
+ */
+export const notificationPreferences = pgTable('notification_preferences', {
+    customerId: uuid('customer_id')
+        .primaryKey()
+        .notNull()
+        .references(() => customers.id),
+    // ── Cost anomaly settings ──
+    costAnomalyEnabled: boolean('cost_anomaly_enabled').notNull().default(true),
+    // Multiplier — alert when 24h cost > this × 7-day daily average.
+    // numeric(4,2) → max 99.99; 0 disables this alert.
+    costAnomalyThresholdMultiplier: numeric('cost_anomaly_threshold_multiplier', {
+        precision: 4,
+        scale: 2,
+    })
+        .notNull()
+        .default('2.00'),
+    // ── Delivery health settings ──
+    deliveryHealthEnabled: boolean('delivery_health_enabled').notNull().default(true),
+    // Percent (0-100). Alert when failure rate over 6h exceeds this.
+    deliveryHealthThresholdPct: smallint('delivery_health_threshold_pct').notNull().default(25),
+    // ── Routing ──
+    // When set, notifications go here instead of customers.email. Useful
+    // for routing to a billing@ alias separate from the API contact.
+    emailOverride: text('email_override'),
+    // ── Debounce state ──
+    lastCostAlertAt: timestamp('last_cost_alert_at', { withTimezone: true }),
+    lastDeliveryAlertAt: timestamp('last_delivery_alert_at', { withTimezone: true }),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+});
+//# sourceMappingURL=notification-preferences.js.map

package/dist/schema/notification-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-preferences.js","sourceRoot":"","sources":["../../src/schema/notification-preferences.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,0BAA0B,EAAE;IACzE,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;SAC5B,UAAU,EAAE;SACZ,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IACjC,8BAA8B;IAC9B,kBAAkB,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3E,iEAAiE;IACjE,mDAAmD;IACnD,8BAA8B,EAAE,OAAO,CAAC,mCAAmC,EAAE;QAC3E,SAAS,EAAE,CAAC;QACZ,KAAK,EAAE,CAAC;KACT,CAAC;SACC,OAAO,EAAE;SACT,OAAO,CAAC,MAAM,CAAC;IAClB,iCAAiC;IACjC,qBAAqB,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjF,iEAAiE;IACjE,0BAA0B,EAAE,QAAQ,CAAC,+BAA+B,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3F,gBAAgB;IAChB,qEAAqE;IACrE,iEAAiE;IACjE,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,uBAAuB;IACvB,eAAe,EAAE,SAAS,CAAC,oBAAoB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACxE,mBAAmB,EAAE,SAAS,CAAC,wBAAwB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChF,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;IACjF,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;CAClF,CAAC,CAAC"}

package/dist/schema/scrape-cache.d.ts

@@ -0,0 +1,136 @@
+/**
+ * scrape_cache — per-customer URL-level cache for /scrape maxAge (Phase A.5).
+ *
+ * Composite PK on (customer_id, url_canonical). One row per URL per
+ * customer — upserted on every fresh scrape so we always reflect the
+ * latest fetch. Cross-customer sharing happens deeper at the extractor
+ * cache layer (content_hash + schema_hash).
+ */
+export declare const scrapeCache: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "scrape_cache";
+    schema: undefined;
+    columns: {
+        customerId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "customer_id";
+            tableName: "scrape_cache";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        urlCanonical: import("drizzle-orm/pg-core").PgColumn<{
+            name: "url_canonical";
+            tableName: "scrape_cache";
+            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;
+        }, {}, {}>;
+        extractionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "extraction_id";
+            tableName: "scrape_cache";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        contentHash: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content_hash";
+            tableName: "scrape_cache";
+            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;
+        }, {}, {}>;
+        finalUrl: import("drizzle-orm/pg-core").PgColumn<{
+            name: "final_url";
+            tableName: "scrape_cache";
+            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;
+        }, {}, {}>;
+        responseStatus: import("drizzle-orm/pg-core").PgColumn<{
+            name: "response_status";
+            tableName: "scrape_cache";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fetchedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fetched_at";
+            tableName: "scrape_cache";
+            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";
+}>;
+export type ScrapeCacheRow = typeof scrapeCache.$inferSelect;
+export type NewScrapeCacheRow = typeof scrapeCache.$inferInsert;