@secondlayer/shared 0.3.0 → 0.5.0

package/dist/src/schemas/subgraphs.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/schemas/subgraphs.ts"],
+  "sourcesContent": [
+    "import { z } from \"zod\";\n\n// ── Deploy Subgraph Request ─────────────────────────────────────────────────\n\nexport interface DeploySubgraphRequest {\n  name: string;\n  version?: string;\n  description?: string;\n  sources: string[];\n  schema: Record<string, unknown>;\n  handlerCode: string;\n  reindex?: boolean;\n}\n\nexport const DeploySubgraphRequestSchema: z.ZodType<DeploySubgraphRequest> = z.object({\n  name: z.string().regex(/^[a-z0-9-]+$/, \"lowercase alphanumeric + hyphens only\").max(63),\n  version: z.string().optional(),\n  description: z.string().optional(),\n  sources: z.array(z.string()).min(1),\n  schema: z.record(z.unknown()),\n  handlerCode: z.string().max(1_048_576, \"handler code exceeds 1MB limit\"),\n  reindex: z.boolean().optional(),\n});\n\nexport interface DeploySubgraphResponse {\n  action: \"created\" | \"unchanged\" | \"updated\" | \"reindexed\";\n  subgraphId: string;\n  message: string;\n}\n\n// Subgraph API response types\n\nexport interface SubgraphSummary {\n  name: string;\n  version: string;\n  status: string;\n  lastProcessedBlock: number;\n  tables: string[];\n  createdAt: string;\n}\n\nexport interface SubgraphDetail {\n  name: string;\n  version: string;\n  status: string;\n  lastProcessedBlock: number;\n  health: {\n    totalProcessed: number;\n    totalErrors: number;\n    errorRate: number;\n    lastError: string | null;\n    lastErrorAt: string | null;\n  };\n  tables: Record<string, {\n    endpoint: string;\n    columns: Record<string, { type: string; nullable?: boolean }>;\n    rowCount: number;\n    example: string;\n  }>;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ReindexResponse {\n  message: string;\n  fromBlock: number;\n  toBlock: number | string;\n}\n\nexport interface SubgraphQueryParams {\n  sort?: string;\n  order?: string;\n  limit?: number;\n  offset?: number;\n  fields?: string;\n  filters?: Record<string, string>;\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAcO,IAAM,8BAAgE,EAAE,OAAO;AAAA,EACpF,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,uCAAuC,EAAE,IAAI,EAAE;AAAA,EACtF,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC;AAAA,EAClC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAC5B,aAAa,EAAE,OAAO,EAAE,IAAI,SAAW,gCAAgC;AAAA,EACvE,SAAS,EAAE,QAAQ,EAAE,SAAS;AAChC,CAAC;",
+  "debugId": "8C96304B8A3F90B664756E2164756E21",
+  "names": []
+}

package/dist/src/types.js

@@ -1,14 +1,3 @@
-import { createRequire } from "node:module";
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
 
-//# debugId=6E26BDBC1FE19BB464756E2164756E21
+//# debugId=F2B76011AEAE140064756E2164756E21
 //# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "6E26BDBC1FE19BB464756E2164756E21",
+  "debugId": "F2B76011AEAE140064756E2164756E21",
   "names": []
 }

package/migrations/0007_contracts.ts

@@ -0,0 +1,58 @@
+import { type Kysely, sql } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  // Enable pg_trgm for fast ILIKE search
+  await sql`CREATE EXTENSION IF NOT EXISTS pg_trgm`.execute(db);
+
+  await db.schema
+    .createTable("contracts")
+    .addColumn("contract_id", "text", (c) => c.primaryKey())
+    .addColumn("name", "text", (c) => c.notNull())
+    .addColumn("deployer", "text", (c) => c.notNull())
+    .addColumn("deploy_block", "integer", (c) => c.notNull())
+    .addColumn("deploy_tx_id", "text", (c) => c.notNull())
+    .addColumn("call_count", "integer", (c) => c.notNull().defaultTo(0))
+    .addColumn("last_called_at", "timestamptz")
+    .addColumn("abi", "jsonb")
+    .addColumn("abi_fetched_at", "timestamptz")
+    .addColumn("created_at", "timestamptz", (c) => c.notNull().defaultTo(sql`NOW()`))
+    .addColumn("updated_at", "timestamptz", (c) => c.notNull().defaultTo(sql`NOW()`))
+    .execute();
+
+  await db.schema.createIndex("contracts_name_idx").on("contracts").column("name").execute();
+  await db.schema.createIndex("contracts_deployer_idx").on("contracts").column("deployer").execute();
+  await sql`CREATE INDEX contracts_name_trgm_idx ON contracts USING gin(name gin_trgm_ops)`.execute(db);
+
+  // Backfill step 1: insert deployed contracts from transactions
+  await sql`
+    INSERT INTO contracts (contract_id, name, deployer, deploy_block, deploy_tx_id, created_at)
+    SELECT DISTINCT ON (contract_id)
+      contract_id,
+      split_part(contract_id, '.', 2),
+      sender,
+      block_height,
+      tx_id,
+      created_at
+    FROM transactions
+    WHERE type = 'smart_contract' AND contract_id IS NOT NULL
+    ORDER BY contract_id, block_height ASC
+    ON CONFLICT (contract_id) DO NOTHING
+  `.execute(db);
+
+  // Backfill step 2: update call counts from contract_call transactions
+  await sql`
+    UPDATE contracts c
+    SET call_count = sub.cnt, last_called_at = sub.last_call
+    FROM (
+      SELECT contract_id, COUNT(*)::int AS cnt, MAX(created_at) AS last_call
+      FROM transactions
+      WHERE type = 'contract_call' AND contract_id IS NOT NULL
+      GROUP BY contract_id
+    ) sub
+    WHERE c.contract_id = sub.contract_id
+  `.execute(db);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("contracts").ifExists().cascade().execute();
+}

package/migrations/0008_drop_contracts.ts

@@ -0,0 +1,28 @@
+import { type Kysely, sql } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("contracts").ifExists().cascade().execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await sql`CREATE EXTENSION IF NOT EXISTS pg_trgm`.execute(db);
+
+  await db.schema
+    .createTable("contracts")
+    .addColumn("contract_id", "text", (c) => c.primaryKey())
+    .addColumn("name", "text", (c) => c.notNull())
+    .addColumn("deployer", "text", (c) => c.notNull())
+    .addColumn("deploy_block", "integer", (c) => c.notNull())
+    .addColumn("deploy_tx_id", "text", (c) => c.notNull())
+    .addColumn("call_count", "integer", (c) => c.notNull().defaultTo(0))
+    .addColumn("last_called_at", "timestamptz")
+    .addColumn("abi", "jsonb")
+    .addColumn("abi_fetched_at", "timestamptz")
+    .addColumn("created_at", "timestamptz", (c) => c.notNull().defaultTo(sql`NOW()`))
+    .addColumn("updated_at", "timestamptz", (c) => c.notNull().defaultTo(sql`NOW()`))
+    .execute();
+
+  await db.schema.createIndex("contracts_name_idx").on("contracts").column("name").execute();
+  await db.schema.createIndex("contracts_deployer_idx").on("contracts").column("deployer").execute();
+  await sql`CREATE INDEX contracts_name_trgm_idx ON contracts USING gin(name gin_trgm_ops)`.execute(db);
+}

package/migrations/0009_waitlist.ts

@@ -0,0 +1,19 @@
+import type { Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable("waitlist")
+    .addColumn("id", "uuid", (col) =>
+      col.primaryKey().defaultTo(db.fn("gen_random_uuid")),
+    )
+    .addColumn("email", "text", (col) => col.notNull().unique())
+    .addColumn("source", "text", (col) => col.defaultTo("website"))
+    .addColumn("created_at", "timestamptz", (col) =>
+      col.notNull().defaultTo(db.fn("now")),
+    )
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("waitlist").execute();
+}

package/migrations/0010_waitlist_status.ts

@@ -0,0 +1,12 @@
+import type { Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .alterTable("waitlist")
+    .addColumn("status", "text", (col) => col.notNull().defaultTo("pending"))
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.alterTable("waitlist").dropColumn("status").execute();
+}

package/migrations/0011_account_insights.ts

@@ -0,0 +1,63 @@
+import type { Kysely } from "kysely";
+import { sql } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable("account_insights")
+    .addColumn("id", "uuid", (col) =>
+      col.primaryKey().defaultTo(db.fn("gen_random_uuid")),
+    )
+    .addColumn("account_id", "uuid", (col) =>
+      col.notNull().references("accounts.id"),
+    )
+    .addColumn("category", "text", (col) => col.notNull())
+    .addColumn("insight_type", "text", (col) => col.notNull())
+    .addColumn("resource_id", "text")
+    .addColumn("severity", "text", (col) => col.notNull())
+    .addColumn("title", "text", (col) => col.notNull())
+    .addColumn("body", "text", (col) => col.notNull())
+    .addColumn("data", "jsonb")
+    .addColumn("dismissed_at", "timestamptz")
+    .addColumn("expires_at", "timestamptz")
+    .addColumn("created_at", "timestamptz", (col) =>
+      col.notNull().defaultTo(db.fn("now")),
+    )
+    .execute();
+
+  await db.schema
+    .createIndex("idx_account_insights_account")
+    .on("account_insights")
+    .column("account_id")
+    .execute();
+
+  await db.schema
+    .createTable("account_agent_runs")
+    .addColumn("id", "uuid", (col) =>
+      col.primaryKey().defaultTo(db.fn("gen_random_uuid")),
+    )
+    .addColumn("account_id", "uuid", (col) =>
+      col.notNull().references("accounts.id"),
+    )
+    .addColumn("started_at", "timestamptz", (col) =>
+      col.notNull().defaultTo(db.fn("now")),
+    )
+    .addColumn("completed_at", "timestamptz")
+    .addColumn("status", "text", (col) => col.notNull().defaultTo("running"))
+    .addColumn("input_tokens", "integer", (col) => col.defaultTo(0))
+    .addColumn("output_tokens", "integer", (col) => col.defaultTo(0))
+    .addColumn("cost_usd", sql`numeric(10,6)`, (col) => col.defaultTo(0))
+    .addColumn("insights_created", "integer", (col) => col.defaultTo(0))
+    .addColumn("error", "text")
+    .execute();
+
+  await db.schema
+    .createIndex("idx_account_agent_runs_account")
+    .on("account_agent_runs")
+    .column("account_id")
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("account_agent_runs").execute();
+  await db.schema.dropTable("account_insights").execute();
+}

package/migrations/0012_view_health_snapshots.ts

@@ -0,0 +1,29 @@
+import type { Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable("view_health_snapshots")
+    .addColumn("id", "uuid", (col) =>
+      col.primaryKey().defaultTo(db.fn("gen_random_uuid")),
+    )
+    .addColumn("view_id", "uuid", (col) =>
+      col.notNull().references("views.id").onDelete("cascade"),
+    )
+    .addColumn("total_processed", "bigint", (col) => col.notNull())
+    .addColumn("total_errors", "bigint", (col) => col.notNull())
+    .addColumn("last_processed_block", "integer")
+    .addColumn("captured_at", "timestamptz", (col) =>
+      col.notNull().defaultTo(db.fn("now")),
+    )
+    .execute();
+
+  await db.schema
+    .createIndex("idx_view_health_snapshots_view_captured")
+    .on("view_health_snapshots")
+    .columns(["view_id", "captured_at"])
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("view_health_snapshots").execute();
+}

package/migrations/0013_view_processing_stats.ts

@@ -0,0 +1,42 @@
+import type { Kysely } from "kysely";
+import { sql } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable("view_processing_stats")
+    .addColumn("id", "uuid", (col) =>
+      col.primaryKey().defaultTo(db.fn("gen_random_uuid")),
+    )
+    .addColumn("view_name", "text", (col) => col.notNull())
+    .addColumn("api_key_id", "text")
+    .addColumn("bucket_start", "timestamptz")
+    .addColumn("bucket_end", "timestamptz")
+    .addColumn("blocks_processed", "integer")
+    .addColumn("total_time_ms", "integer")
+    .addColumn("handler_time_ms", "integer")
+    .addColumn("flush_time_ms", "integer")
+    .addColumn("max_block_time_ms", "integer")
+    .addColumn("max_handler_time_ms", "integer")
+    .addColumn("avg_ops_per_block", sql`real`)
+    .addColumn("is_catchup", "boolean", (col) => col.defaultTo(false))
+    .addColumn("created_at", "timestamptz", (col) =>
+      col.notNull().defaultTo(db.fn("now")),
+    )
+    .execute();
+
+  await db.schema
+    .createIndex("idx_view_processing_stats_view_bucket")
+    .on("view_processing_stats")
+    .columns(["view_name", "bucket_start"])
+    .execute();
+
+  await db.schema
+    .createIndex("idx_view_processing_stats_api_key")
+    .on("view_processing_stats")
+    .column("api_key_id")
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("view_processing_stats").execute();
+}

package/migrations/0014_view_table_snapshots.ts

@@ -0,0 +1,33 @@
+import type { Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable("view_table_snapshots")
+    .addColumn("id", "uuid", (col) =>
+      col.primaryKey().defaultTo(db.fn("gen_random_uuid")),
+    )
+    .addColumn("view_name", "text", (col) => col.notNull())
+    .addColumn("api_key_id", "text")
+    .addColumn("table_name", "text", (col) => col.notNull())
+    .addColumn("row_count", "bigint")
+    .addColumn("created_at", "timestamptz", (col) =>
+      col.notNull().defaultTo(db.fn("now")),
+    )
+    .execute();
+
+  await db.schema
+    .createIndex("idx_view_table_snapshots_view_table_created")
+    .on("view_table_snapshots")
+    .columns(["view_name", "table_name", "created_at"])
+    .execute();
+
+  await db.schema
+    .createIndex("idx_view_table_snapshots_api_key")
+    .on("view_table_snapshots")
+    .column("api_key_id")
+    .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable("view_table_snapshots").execute();
+}

package/migrations/0015_rename_views_to_subgraphs.ts

@@ -0,0 +1,136 @@
+import type { Kysely } from "kysely";
+import { sql } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+  // Drop old trigger + function
+  await sql`DROP TRIGGER IF EXISTS views_notify_trigger ON "views"`.execute(db);
+  await sql`DROP FUNCTION IF EXISTS notify_view_changes()`.execute(db);
+
+  // Rename tables
+  await sql`ALTER TABLE "views" RENAME TO "subgraphs"`.execute(db);
+  await sql`ALTER TABLE "view_health_snapshots" RENAME TO "subgraph_health_snapshots"`.execute(db);
+  await sql`ALTER TABLE "view_processing_stats" RENAME TO "subgraph_processing_stats"`.execute(db);
+  await sql`ALTER TABLE "view_table_snapshots" RENAME TO "subgraph_table_snapshots"`.execute(db);
+
+  // Rename indexes on subgraphs (formerly views)
+  await sql`ALTER INDEX "views_name_idx" RENAME TO "subgraphs_name_idx"`.execute(db);
+  await sql`ALTER INDEX "views_status_idx" RENAME TO "subgraphs_status_idx"`.execute(db);
+
+  // Rename indexes on subgraph_health_snapshots
+  await sql`ALTER INDEX "idx_view_health_snapshots_view_captured" RENAME TO "idx_subgraph_health_snapshots_subgraph_captured"`.execute(db);
+
+  // Rename indexes on subgraph_processing_stats
+  await sql`ALTER INDEX "idx_view_processing_stats_view_bucket" RENAME TO "idx_subgraph_processing_stats_subgraph_bucket"`.execute(db);
+  await sql`ALTER INDEX "idx_view_processing_stats_api_key" RENAME TO "idx_subgraph_processing_stats_api_key"`.execute(db);
+
+  // Rename indexes on subgraph_table_snapshots
+  await sql`ALTER INDEX "idx_view_table_snapshots_view_table_created" RENAME TO "idx_subgraph_table_snapshots_subgraph_table_created"`.execute(db);
+  await sql`ALTER INDEX "idx_view_table_snapshots_api_key" RENAME TO "idx_subgraph_table_snapshots_api_key"`.execute(db);
+
+  // Rename column view_id → subgraph_id in health snapshots
+  await sql`ALTER TABLE "subgraph_health_snapshots" RENAME COLUMN "view_id" TO "subgraph_id"`.execute(db);
+
+  // Rename column view_name → subgraph_name in processing stats and table snapshots
+  await sql`ALTER TABLE "subgraph_processing_stats" RENAME COLUMN "view_name" TO "subgraph_name"`.execute(db);
+  await sql`ALTER TABLE "subgraph_table_snapshots" RENAME COLUMN "view_name" TO "subgraph_name"`.execute(db);
+
+  // Rename FK constraint (Postgres auto-names it based on original table/column)
+  await sql`ALTER TABLE "subgraph_health_snapshots" RENAME CONSTRAINT "view_health_snapshots_view_id_fkey" TO "subgraph_health_snapshots_subgraph_id_fkey"`.execute(db);
+
+  // Recreate notify trigger with new names
+  await sql`
+    CREATE OR REPLACE FUNCTION notify_subgraph_changes() RETURNS trigger AS $$
+    BEGIN
+      PERFORM pg_notify('subgraph_changes', json_build_object(
+        'operation', TG_OP,
+        'name', COALESCE(NEW.name, OLD.name)
+      )::text);
+      RETURN COALESCE(NEW, OLD);
+    END;
+    $$ LANGUAGE plpgsql
+  `.execute(db);
+
+  await sql`
+    CREATE TRIGGER subgraphs_notify_trigger
+      AFTER INSERT OR UPDATE OR DELETE ON "subgraphs"
+      FOR EACH ROW EXECUTE FUNCTION notify_subgraph_changes()
+  `.execute(db);
+
+  // Rename any existing tenant schemas from view_* to subgraph_*
+  await sql`
+    DO $$
+    DECLARE
+      s record;
+    BEGIN
+      FOR s IN SELECT schema_name FROM information_schema.schemata WHERE schema_name LIKE 'view_%'
+      LOOP
+        EXECUTE format('ALTER SCHEMA %I RENAME TO %I', s.schema_name, 'subgraph_' || substring(s.schema_name from 6));
+      END LOOP;
+    END $$
+  `.execute(db);
+
+  // Update schema_name column in subgraphs table to match new prefix
+  await sql`UPDATE "subgraphs" SET schema_name = 'subgraph_' || substring(schema_name from 6) WHERE schema_name LIKE 'view_%'`.execute(db);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  // Drop new trigger + function
+  await sql`DROP TRIGGER IF EXISTS subgraphs_notify_trigger ON "subgraphs"`.execute(db);
+  await sql`DROP FUNCTION IF EXISTS notify_subgraph_changes()`.execute(db);
+
+  // Revert schema_name column
+  await sql`UPDATE "subgraphs" SET schema_name = 'view_' || substring(schema_name from 10) WHERE schema_name LIKE 'subgraph_%'`.execute(db);
+
+  // Revert tenant schemas
+  await sql`
+    DO $$
+    DECLARE
+      s record;
+    BEGIN
+      FOR s IN SELECT schema_name FROM information_schema.schemata WHERE schema_name LIKE 'subgraph_%'
+      LOOP
+        EXECUTE format('ALTER SCHEMA %I RENAME TO %I', s.schema_name, 'view_' || substring(s.schema_name from 10));
+      END LOOP;
+    END $$
+  `.execute(db);
+
+  // Rename columns back
+  await sql`ALTER TABLE "subgraph_health_snapshots" RENAME CONSTRAINT "subgraph_health_snapshots_subgraph_id_fkey" TO "view_health_snapshots_view_id_fkey"`.execute(db);
+  await sql`ALTER TABLE "subgraph_table_snapshots" RENAME COLUMN "subgraph_name" TO "view_name"`.execute(db);
+  await sql`ALTER TABLE "subgraph_processing_stats" RENAME COLUMN "subgraph_name" TO "view_name"`.execute(db);
+  await sql`ALTER TABLE "subgraph_health_snapshots" RENAME COLUMN "subgraph_id" TO "view_id"`.execute(db);
+
+  // Rename indexes back
+  await sql`ALTER INDEX "idx_subgraph_table_snapshots_api_key" RENAME TO "idx_view_table_snapshots_api_key"`.execute(db);
+  await sql`ALTER INDEX "idx_subgraph_table_snapshots_subgraph_table_created" RENAME TO "idx_view_table_snapshots_view_table_created"`.execute(db);
+  await sql`ALTER INDEX "idx_subgraph_processing_stats_api_key" RENAME TO "idx_view_processing_stats_api_key"`.execute(db);
+  await sql`ALTER INDEX "idx_subgraph_processing_stats_subgraph_bucket" RENAME TO "idx_view_processing_stats_view_bucket"`.execute(db);
+  await sql`ALTER INDEX "idx_subgraph_health_snapshots_subgraph_captured" RENAME TO "idx_view_health_snapshots_view_captured"`.execute(db);
+  await sql`ALTER INDEX "subgraphs_status_idx" RENAME TO "views_status_idx"`.execute(db);
+  await sql`ALTER INDEX "subgraphs_name_idx" RENAME TO "views_name_idx"`.execute(db);
+
+  // Rename tables back
+  await sql`ALTER TABLE "subgraph_table_snapshots" RENAME TO "view_table_snapshots"`.execute(db);
+  await sql`ALTER TABLE "subgraph_processing_stats" RENAME TO "view_processing_stats"`.execute(db);
+  await sql`ALTER TABLE "subgraph_health_snapshots" RENAME TO "view_health_snapshots"`.execute(db);
+  await sql`ALTER TABLE "subgraphs" RENAME TO "views"`.execute(db);
+
+  // Recreate old trigger
+  await sql`
+    CREATE OR REPLACE FUNCTION notify_view_changes() RETURNS trigger AS $$
+    BEGIN
+      PERFORM pg_notify('view_changes', json_build_object(
+        'operation', TG_OP,
+        'name', COALESCE(NEW.name, OLD.name)
+      )::text);
+      RETURN COALESCE(NEW, OLD);
+    END;
+    $$ LANGUAGE plpgsql
+  `.execute(db);
+
+  await sql`
+    CREATE TRIGGER views_notify_trigger
+      AFTER INSERT OR UPDATE OR DELETE ON "views"
+      FOR EACH ROW EXECUTE FUNCTION notify_view_changes()
+  `.execute(db);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@secondlayer/shared",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
@@ -29,9 +29,13 @@
       "types": "./dist/src/db/queries/usage.d.ts",
       "import": "./dist/src/db/queries/usage.js"
     },
-    "./db/queries/views": {
-      "types": "./dist/src/db/queries/views.d.ts",
-      "import": "./dist/src/db/queries/views.js"
+    "./db/queries/subgraphs": {
+      "types": "./dist/src/db/queries/subgraphs.d.ts",
+      "import": "./dist/src/db/queries/subgraphs.js"
+    },
+    "./db/queries/contracts": {
+      "types": "./dist/src/db/queries/contracts.d.ts",
+      "import": "./dist/src/db/queries/contracts.js"
     },
     "./db/jsonb": {
       "types": "./dist/src/db/jsonb.d.ts",
@@ -65,9 +69,9 @@
       "types": "./dist/src/schemas/filters.d.ts",
       "import": "./dist/src/schemas/filters.js"
     },
-    "./schemas/views": {
-      "types": "./dist/src/schemas/views.d.ts",
-      "import": "./dist/src/schemas/views.js"
+    "./schemas/subgraphs": {
+      "types": "./dist/src/schemas/subgraphs.d.ts",
+      "import": "./dist/src/schemas/subgraphs.js"
     },
     "./types": {
       "types": "./dist/src/types.d.ts",
@@ -120,7 +124,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@secondlayer/stacks": "^0.1.0",
+    "@secondlayer/stacks": "^0.2.0",
     "kysely": "0.28.10",
     "kysely-postgres-js": "3.0.0",
     "postgres": "^3.4.6",

package/dist/src/db/queries/views.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/db/jsonb.ts", "../src/db/queries/views.ts"],
-  "sourcesContent": [
-    "import { sql, type RawBuilder } from \"kysely\";\n\n/**\n * Safely encode a JS value as a JSONB literal for Kysely inserts/updates.\n * Kysely + postgres.js double-encodes JSON when using parameterized queries\n * with ::jsonb casts. This uses sql.raw to inline a properly escaped literal.\n */\nexport function jsonb(value: unknown): RawBuilder<unknown> {\n  const escaped = JSON.stringify(value).replace(/'/g, \"''\");\n  return sql`${sql.raw(`'${escaped}'::jsonb`)}`;\n}\n\n/**\n * Safely parse a JSONB value from the database.\n * Handles double-encoded strings where postgres.js returns a JSON string\n * instead of a parsed object.\n */\nexport function parseJsonb<T = unknown>(value: unknown): T {\n  if (typeof value === \"string\") {\n    try {\n      return JSON.parse(value) as T;\n    } catch {\n      return value as T;\n    }\n  }\n  return (value ?? {}) as T;\n}\n",
-    "import { sql, type Kysely } from \"kysely\";\nimport { jsonb } from \"../jsonb.ts\";\nimport type { Database, View } from \"../types.ts\";\n\n/**\n * Convert a view name to its PostgreSQL schema name.\n * With keyPrefix: \"view_{prefix}_{name}\" (tenant-isolated)\n * Without keyPrefix: \"view_{name}\" (backward compat)\n */\nexport function pgSchemaName(viewName: string, keyPrefix?: string): string {\n  const safeName = viewName.replace(/-/g, \"_\");\n  if (!keyPrefix) {\n    return `view_${safeName}`;\n  }\n  const safePrefix = keyPrefix.replace(/^sk-sl_/, \"\").replace(/-/g, \"_\");\n  return `view_${safePrefix}_${safeName}`;\n}\n\nexport async function registerView(\n  db: Kysely<Database>,\n  data: {\n    name: string;\n    version: string;\n    definition: Record<string, unknown>;\n    schemaHash: string;\n    handlerPath: string;\n    apiKeyId?: string;\n    schemaName?: string;\n  },\n): Promise<View> {\n  return await db\n    .insertInto(\"views\")\n    .values({\n      name: data.name,\n      version: data.version,\n      definition: jsonb(data.definition) as any,\n      schema_hash: data.schemaHash,\n      handler_path: data.handlerPath,\n      api_key_id: data.apiKeyId ?? null,\n      schema_name: data.schemaName ?? null,\n    })\n    .onConflict((oc) =>\n      oc.columns([\"name\", \"api_key_id\"]).doUpdateSet({\n        version: data.version,\n        definition: jsonb(data.definition) as any,\n        schema_hash: data.schemaHash,\n        handler_path: data.handlerPath,\n        schema_name: data.schemaName ?? null,\n        updated_at: new Date(),\n      }),\n    )\n    .returningAll()\n    .executeTakeFirstOrThrow();\n}\n\nexport async function getView(db: Kysely<Database>, name: string, apiKeyId?: string): Promise<View | null> {\n  let query = db\n    .selectFrom(\"views\")\n    .selectAll()\n    .where(\"name\", \"=\", name);\n\n  if (apiKeyId) {\n    query = query.where(\"api_key_id\", \"=\", apiKeyId);\n  }\n\n  return (await query.executeTakeFirst()) ?? null;\n}\n\nexport async function listViews(db: Kysely<Database>, apiKeyId?: string): Promise<View[]> {\n  let query = db.selectFrom(\"views\").selectAll();\n  if (apiKeyId) {\n    query = query.where(\"api_key_id\", \"=\", apiKeyId);\n  }\n  return query.execute();\n}\n\nexport async function updateViewStatus(\n  db: Kysely<Database>,\n  name: string,\n  status: string,\n  lastProcessedBlock?: number,\n): Promise<void> {\n  await db\n    .updateTable(\"views\")\n    .set({\n      status,\n      ...(lastProcessedBlock !== undefined ? { last_processed_block: lastProcessedBlock } : {}),\n      updated_at: new Date(),\n    })\n    .where(\"name\", \"=\", name)\n    .execute();\n}\n\nexport async function recordViewProcessed(\n  db: Kysely<Database>,\n  name: string,\n  processed: number,\n  errors: number,\n  lastError?: string,\n): Promise<void> {\n  await db\n    .updateTable(\"views\")\n    .set({\n      total_processed: sql`total_processed + ${processed}`,\n      total_errors: sql`total_errors + ${errors}`,\n      ...(lastError\n        ? { last_error: lastError, last_error_at: new Date() }\n        : {}),\n      updated_at: new Date(),\n    })\n    .where(\"name\", \"=\", name)\n    .execute();\n}\n\nexport async function updateViewHandlerPath(\n  db: Kysely<Database>,\n  name: string,\n  handlerPath: string,\n): Promise<void> {\n  await db\n    .updateTable(\"views\")\n    .set({ handler_path: handlerPath, updated_at: new Date() })\n    .where(\"name\", \"=\", name)\n    .execute();\n}\n\nexport async function deleteView(db: Kysely<Database>, name: string, apiKeyId?: string): Promise<View | null> {\n  const view = await getView(db, name, apiKeyId);\n  if (!view) return null;\n\n  // Use stored schema_name if available, otherwise compute\n  const schemaName = view.schema_name ?? pgSchemaName(name);\n\n  // Drop the view's schema (CASCADE drops all tables within)\n  await sql`DROP SCHEMA IF EXISTS ${sql.raw(`\"${schemaName}\"`)} CASCADE`.execute(db);\n\n  // Remove from registry\n  await db.deleteFrom(\"views\").where(\"id\", \"=\", view.id).execute();\n\n  return view;\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "C19949368802BB4964756E2164756E21",
-  "names": []
-}

package/dist/src/schemas/views.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/schemas/views.ts"],
-  "sourcesContent": [
-    "import { z } from \"zod\";\n\n// ── Deploy View Request ─────────────────────────────────────────────────\n\nexport interface DeployViewRequest {\n  name: string;\n  version?: string;\n  description?: string;\n  sources: string[];\n  schema: Record<string, unknown>;\n  handlerCode: string;\n  reindex?: boolean;\n}\n\nexport const DeployViewRequestSchema: z.ZodType<DeployViewRequest> = z.object({\n  name: z.string().regex(/^[a-z0-9-]+$/, \"lowercase alphanumeric + hyphens only\").max(63),\n  version: z.string().optional(),\n  description: z.string().optional(),\n  sources: z.array(z.string()).min(1),\n  schema: z.record(z.unknown()),\n  handlerCode: z.string().max(1_048_576, \"handler code exceeds 1MB limit\"),\n  reindex: z.boolean().optional(),\n});\n\nexport interface DeployViewResponse {\n  action: \"created\" | \"unchanged\" | \"updated\" | \"reindexed\";\n  viewId: string;\n  message: string;\n}\n\n// View API response types\n\nexport interface ViewSummary {\n  name: string;\n  version: string;\n  status: string;\n  lastProcessedBlock: number;\n  tables: string[];\n  createdAt: string;\n}\n\nexport interface ViewDetail {\n  name: string;\n  version: string;\n  status: string;\n  lastProcessedBlock: number;\n  health: {\n    totalProcessed: number;\n    totalErrors: number;\n    errorRate: number;\n    lastError: string | null;\n    lastErrorAt: string | null;\n  };\n  tables: Record<string, {\n    endpoint: string;\n    columns: Record<string, { type: string; nullable?: boolean }>;\n    rowCount: number;\n    example: string;\n  }>;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ReindexResponse {\n  message: string;\n  fromBlock: number;\n  toBlock: number | string;\n}\n\nexport interface ViewQueryParams {\n  sort?: string;\n  order?: string;\n  limit?: number;\n  offset?: number;\n  fields?: string;\n  filters?: Record<string, string>;\n}\n"
-  ],
-  "mappings": ";;;;;;;;;;;;;AAAA;AAcO,IAAM,0BAAwD,EAAE,OAAO;AAAA,EAC5E,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,uCAAuC,EAAE,IAAI,EAAE;AAAA,EACtF,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC;AAAA,EAClC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,EAC5B,aAAa,EAAE,OAAO,EAAE,IAAI,SAAW,gCAAgC;AAAA,EACvE,SAAS,EAAE,QAAQ,EAAE,SAAS;AAChC,CAAC;",
-  "debugId": "F7D47497A7667C0064756E2164756E21",
-  "names": []
-}