@secondlayer/shared 7.7.0 → 7.9.0

package/dist/src/db/queries/instance.js

@@ -0,0 +1,92 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/db/queries/instance.ts
+var INSTANCE_NETWORKS = ["mainnet", "testnet", "devnet"];
+
+class InstanceNetworkMismatchError extends Error {
+  existing;
+  requested;
+  name = "InstanceNetworkMismatchError";
+  constructor(existing, requested) {
+    super(`instance network is ${existing}; cannot change to ${requested}`);
+    this.existing = existing;
+    this.requested = requested;
+  }
+}
+
+class InvalidInstanceNetworkError extends Error {
+  value;
+  name = "InvalidInstanceNetworkError";
+  constructor(value) {
+    super(`instance network must be mainnet, testnet, or devnet (got ${value})`);
+    this.value = value;
+  }
+}
+function parseInstanceNetwork(value) {
+  const network = value.trim().toLowerCase();
+  if (INSTANCE_NETWORKS.includes(network)) {
+    return network;
+  }
+  throw new InvalidInstanceNetworkError(value);
+}
+function instanceNetworkFromEnv(env = process.env) {
+  return parseInstanceNetwork(env.STACKS_NETWORK ?? env.NETWORK ?? "mainnet");
+}
+async function getInstance(db) {
+  const row = await db.selectFrom("instances").select(["id", "network", "created_at"]).executeTakeFirst();
+  return row ? toInstance(row) : null;
+}
+async function ensureInstance(db, input) {
+  const existing = await getInstance(db);
+  if (existing) {
+    if (existing.network !== input.network) {
+      throw new InstanceNetworkMismatchError(existing.network, input.network);
+    }
+    return existing;
+  }
+  try {
+    const inserted = await db.insertInto("instances").values({ network: input.network }).returning(["id", "network", "created_at"]).executeTakeFirstOrThrow();
+    return toInstance(inserted);
+  } catch {
+    const raced = await getInstance(db);
+    if (!raced)
+      throw new Error("failed to create instance");
+    if (raced.network !== input.network) {
+      throw new InstanceNetworkMismatchError(raced.network, input.network);
+    }
+    return raced;
+  }
+}
+function toInstance(row) {
+  return {
+    id: row.id,
+    network: parseInstanceNetwork(row.network),
+    created_at: row.created_at
+  };
+}
+export {
+  parseInstanceNetwork,
+  instanceNetworkFromEnv,
+  getInstance,
+  ensureInstance,
+  InvalidInstanceNetworkError,
+  InstanceNetworkMismatchError,
+  INSTANCE_NETWORKS
+};
+
+//# debugId=52C8BB0A1418347D64756E2164756E21
+//# sourceMappingURL=instance.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/db/queries/instance.ts"],
+  "sourcesContent": [
+    "import type { Kysely } from \"kysely\";\nimport type { Database } from \"../types.ts\";\n\nexport const INSTANCE_NETWORKS = [\"mainnet\", \"testnet\", \"devnet\"] as const;\nexport type InstanceNetwork = (typeof INSTANCE_NETWORKS)[number];\n\nexport type InstanceRow = {\n\tid: string;\n\tnetwork: InstanceNetwork;\n\tcreated_at: Date;\n};\n\nexport class InstanceNetworkMismatchError extends Error {\n\treadonly name = \"InstanceNetworkMismatchError\";\n\tconstructor(\n\t\treadonly existing: InstanceNetwork,\n\t\treadonly requested: InstanceNetwork,\n\t) {\n\t\tsuper(`instance network is ${existing}; cannot change to ${requested}`);\n\t}\n}\n\nexport class InvalidInstanceNetworkError extends Error {\n\treadonly name = \"InvalidInstanceNetworkError\";\n\tconstructor(readonly value: string) {\n\t\tsuper(\n\t\t\t`instance network must be mainnet, testnet, or devnet (got ${value})`,\n\t\t);\n\t}\n}\n\nexport function parseInstanceNetwork(value: string): InstanceNetwork {\n\tconst network = value.trim().toLowerCase();\n\tif ((INSTANCE_NETWORKS as readonly string[]).includes(network)) {\n\t\treturn network as InstanceNetwork;\n\t}\n\tthrow new InvalidInstanceNetworkError(value);\n}\n\n/** STACKS_NETWORK, then NETWORK, then mainnet. */\nexport function instanceNetworkFromEnv(\n\tenv: NodeJS.ProcessEnv = process.env,\n): InstanceNetwork {\n\treturn parseInstanceNetwork(env.STACKS_NETWORK ?? env.NETWORK ?? \"mainnet\");\n}\n\nexport async function getInstance(\n\tdb: Kysely<Database>,\n): Promise<InstanceRow | null> {\n\tconst row = await db\n\t\t.selectFrom(\"instances\")\n\t\t.select([\"id\", \"network\", \"created_at\"])\n\t\t.executeTakeFirst();\n\treturn row ? toInstance(row) : null;\n}\n\n/**\n * Return the singleton instance, creating it on first call.\n * A second call with a different network is refused — the network is\n * immutable for the life of the database.\n */\nexport async function ensureInstance(\n\tdb: Kysely<Database>,\n\tinput: { network: InstanceNetwork },\n): Promise<InstanceRow> {\n\tconst existing = await getInstance(db);\n\tif (existing) {\n\t\tif (existing.network !== input.network) {\n\t\t\tthrow new InstanceNetworkMismatchError(existing.network, input.network);\n\t\t}\n\t\treturn existing;\n\t}\n\ttry {\n\t\tconst inserted = await db\n\t\t\t.insertInto(\"instances\")\n\t\t\t.values({ network: input.network })\n\t\t\t.returning([\"id\", \"network\", \"created_at\"])\n\t\t\t.executeTakeFirstOrThrow();\n\t\treturn toInstance(inserted);\n\t} catch {\n\t\t// Lost the singleton race — the other writer won.\n\t\tconst raced = await getInstance(db);\n\t\tif (!raced) throw new Error(\"failed to create instance\");\n\t\tif (raced.network !== input.network) {\n\t\t\tthrow new InstanceNetworkMismatchError(raced.network, input.network);\n\t\t}\n\t\treturn raced;\n\t}\n}\n\nfunction toInstance(row: {\n\tid: string;\n\tnetwork: string;\n\tcreated_at: Date;\n}): InstanceRow {\n\treturn {\n\t\tid: row.id,\n\t\tnetwork: parseInstanceNetwork(row.network),\n\t\tcreated_at: row.created_at,\n\t};\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AAGO,IAAM,oBAAoB,CAAC,WAAW,WAAW,QAAQ;AAAA;AASzD,MAAM,qCAAqC,MAAM;AAAA,EAG7C;AAAA,EACA;AAAA,EAHD,OAAO;AAAA,EAChB,WAAW,CACD,UACA,WACR;AAAA,IACD,MAAM,uBAAuB,8BAA8B,WAAW;AAAA,IAH7D;AAAA,IACA;AAAA;AAIX;AAAA;AAEO,MAAM,oCAAoC,MAAM;AAAA,EAEjC;AAAA,EADZ,OAAO;AAAA,EAChB,WAAW,CAAU,OAAe;AAAA,IACnC,MACC,6DAA6D,QAC9D;AAAA,IAHoB;AAAA;AAKtB;AAEO,SAAS,oBAAoB,CAAC,OAAgC;AAAA,EACpE,MAAM,UAAU,MAAM,KAAK,EAAE,YAAY;AAAA,EACzC,IAAK,kBAAwC,SAAS,OAAO,GAAG;AAAA,IAC/D,OAAO;AAAA,EACR;AAAA,EACA,MAAM,IAAI,4BAA4B,KAAK;AAAA;AAIrC,SAAS,sBAAsB,CACrC,MAAyB,QAAQ,KACf;AAAA,EAClB,OAAO,qBAAqB,IAAI,kBAAkB,IAAI,WAAW,SAAS;AAAA;AAG3E,eAAsB,WAAW,CAChC,IAC8B;AAAA,EAC9B,MAAM,MAAM,MAAM,GAChB,WAAW,WAAW,EACtB,OAAO,CAAC,MAAM,WAAW,YAAY,CAAC,EACtC,iBAAiB;AAAA,EACnB,OAAO,MAAM,WAAW,GAAG,IAAI;AAAA;AAQhC,eAAsB,cAAc,CACnC,IACA,OACuB;AAAA,EACvB,MAAM,WAAW,MAAM,YAAY,EAAE;AAAA,EACrC,IAAI,UAAU;AAAA,IACb,IAAI,SAAS,YAAY,MAAM,SAAS;AAAA,MACvC,MAAM,IAAI,6BAA6B,SAAS,SAAS,MAAM,OAAO;AAAA,IACvE;AAAA,IACA,OAAO;AAAA,EACR;AAAA,EACA,IAAI;AAAA,IACH,MAAM,WAAW,MAAM,GACrB,WAAW,WAAW,EACtB,OAAO,EAAE,SAAS,MAAM,QAAQ,CAAC,EACjC,UAAU,CAAC,MAAM,WAAW,YAAY,CAAC,EACzC,wBAAwB;AAAA,IAC1B,OAAO,WAAW,QAAQ;AAAA,IACzB,MAAM;AAAA,IAEP,MAAM,QAAQ,MAAM,YAAY,EAAE;AAAA,IAClC,IAAI,CAAC;AAAA,MAAO,MAAM,IAAI,MAAM,2BAA2B;AAAA,IACvD,IAAI,MAAM,YAAY,MAAM,SAAS;AAAA,MACpC,MAAM,IAAI,6BAA6B,MAAM,SAAS,MAAM,OAAO;AAAA,IACpE;AAAA,IACA,OAAO;AAAA;AAAA;AAIT,SAAS,UAAU,CAAC,KAIJ;AAAA,EACf,OAAO;AAAA,IACN,IAAI,IAAI;AAAA,IACR,SAAS,qBAAqB,IAAI,OAAO;AAAA,IACzC,YAAY,IAAI;AAAA,EACjB;AAAA;",
+  "debugId": "52C8BB0A1418347D64756E2164756E21",
+  "names": []
+}

package/dist/src/db/queries/integrity.d.ts

@@ -191,6 +191,12 @@ interface ApiKeysTable {
 	revoked_at: Date | null;
 	created_at: Generated<Date>;
 }
+/** Singleton self-host / publisher identity. Network is immutable. */
+interface InstancesTable {
+	id: Generated<string>;
+	network: string;
+	created_at: Generated<Date>;
+}
 interface AccountsTable {
 	id: Generated<string>;
 	/** NULL for unclaimed ghost accounts (anonymous self-serve keys). */
@@ -733,6 +739,7 @@ interface Database {
 	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
+	instances: InstancesTable;
 	accounts: AccountsTable;
 	sessions: SessionsTable;
 	magic_links: MagicLinksTable;

package/dist/src/db/queries/subgraph-gaps.d.ts

@@ -191,6 +191,12 @@ interface ApiKeysTable {
 	revoked_at: Date | null;
 	created_at: Generated<Date>;
 }
+/** Singleton self-host / publisher identity. Network is immutable. */
+interface InstancesTable {
+	id: Generated<string>;
+	network: string;
+	created_at: Generated<Date>;
+}
 interface AccountsTable {
 	id: Generated<string>;
 	/** NULL for unclaimed ghost accounts (anonymous self-serve keys). */
@@ -733,6 +739,7 @@ interface Database {
 	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
+	instances: InstancesTable;
 	accounts: AccountsTable;
 	sessions: SessionsTable;
 	magic_links: MagicLinksTable;

package/dist/src/db/queries/subgraph-operations.d.ts

@@ -191,6 +191,12 @@ interface ApiKeysTable {
 	revoked_at: Date | null;
 	created_at: Generated<Date>;
 }
+/** Singleton self-host / publisher identity. Network is immutable. */
+interface InstancesTable {
+	id: Generated<string>;
+	network: string;
+	created_at: Generated<Date>;
+}
 interface AccountsTable {
 	id: Generated<string>;
 	/** NULL for unclaimed ghost accounts (anonymous self-serve keys). */
@@ -733,6 +739,7 @@ interface Database {
 	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
+	instances: InstancesTable;
 	accounts: AccountsTable;
 	sessions: SessionsTable;
 	magic_links: MagicLinksTable;

package/dist/src/db/queries/subgraphs.d.ts

@@ -192,6 +192,12 @@ interface ApiKeysTable {
 	revoked_at: Date | null;
 	created_at: Generated<Date>;
 }
+/** Singleton self-host / publisher identity. Network is immutable. */
+interface InstancesTable {
+	id: Generated<string>;
+	network: string;
+	created_at: Generated<Date>;
+}
 interface AccountsTable {
 	id: Generated<string>;
 	/** NULL for unclaimed ghost accounts (anonymous self-serve keys). */
@@ -734,6 +740,7 @@ interface Database {
 	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
 	api_keys: ApiKeysTable;
+	instances: InstancesTable;
 	accounts: AccountsTable;
 	sessions: SessionsTable;
 	magic_links: MagicLinksTable;
@@ -1025,6 +1032,8 @@ declare function resolveSubgraphRawClient(subgraph: Subgraph): ReturnType<typeof
 * Platform-mode deploys use `pgSchemaNameFor(accountId, name)`.
 */
 declare function pgSchemaName(subgraphName: string): string;
+/** OSS writes empty account_id — name is the local unique key. */
+declare function localSubgraphAccountId(accountId?: string): string;
 /**
 * Account-scoped schema name. Matches migration 0028's rename pattern:
 *   subgraph_{first8charsOfAccountId, dashes-as-underscores}_{name}
@@ -1131,4 +1140,4 @@ declare function recordLiveProgress(db: Kysely<Database>, name: string, lastProc
 *  forward write between the rewind and the fork block's reprocess. Do not
 *  call this from the live catch-up path. */
 declare function rewindLiveProgress(db: Kysely<Database>, name: string, lastProcessedBlock: number): Promise<void>;
-export { updateSubgraphVisibility, updateSubgraphStatus, updateSubgraphHandlerPath, updateSubgraphExpiry, subgraphDatabaseUrl, rewindLiveProgress, resolveSubgraphRawClient, resolveSubgraphDb, registerSubgraph, recordSubgraphProcessed, recordLiveProgress, recordLiveError, pgSchemaNameFor, pgSchemaName, listSubgraphs, isByoSubgraph, getSubgraph, findPublicSubgraphByName, encryptDatabaseUrl, deleteSubgraph };
+export { updateSubgraphVisibility, updateSubgraphStatus, updateSubgraphHandlerPath, updateSubgraphExpiry, subgraphDatabaseUrl, rewindLiveProgress, resolveSubgraphRawClient, resolveSubgraphDb, registerSubgraph, recordSubgraphProcessed, recordLiveProgress, recordLiveError, pgSchemaNameFor, pgSchemaName, localSubgraphAccountId, listSubgraphs, isByoSubgraph, getSubgraph, findPublicSubgraphByName, encryptDatabaseUrl, deleteSubgraph };

package/dist/src/db/queries/subgraphs.js

@@ -138,6 +138,22 @@ class Logger {
 }
 var logger = new Logger;
 
+// src/mode.ts
+var VALID_MODES = ["oss", "platform"];
+function getInstanceMode() {
+  const raw = process.env.INSTANCE_MODE?.trim().toLowerCase();
+  if (raw && VALID_MODES.includes(raw)) {
+    return raw;
+  }
+  return "oss";
+}
+function isPlatformMode() {
+  return getInstanceMode() === "platform";
+}
+function isOssMode() {
+  return getInstanceMode() === "oss";
+}
+
 // src/db/jsonb.ts
 import { sql } from "kysely";
 function jsonb(value) {
@@ -723,6 +739,7 @@ var TABLE_TO_DB = {
   bns_marketplace_events: "source",
   bns_names: "source",
   bns_namespaces: "source",
+  instances: "target",
   accounts: "target",
   api_keys: "target",
   sessions: "target",
@@ -785,10 +802,17 @@ function evictIfNeeded() {
   const evicted = lruEntry;
   evicted.db.destroy().catch(() => {}).then(() => evicted.rawClient.end({ timeout: 5 })).catch(() => {});
 }
+function applicationDatabaseUrl() {
+  return process.env.DATABASE_URL || DEFAULT_URL;
+}
 function resolveSourceUrl() {
+  if (!isPlatformMode())
+    return applicationDatabaseUrl();
   return process.env.SOURCE_DATABASE_URL || process.env.DATABASE_URL || DEFAULT_URL;
 }
 function resolveTargetUrl() {
+  if (!isPlatformMode())
+    return applicationDatabaseUrl();
   return process.env.TARGET_DATABASE_URL || process.env.DATABASE_URL || DEFAULT_URL;
 }
 function describeDbUrl(url) {
@@ -927,22 +951,6 @@ async function closeDb() {
   }
   pools.clear();
 }
-// src/mode.ts
-var VALID_MODES = ["oss", "platform"];
-function getInstanceMode() {
-  const raw = process.env.INSTANCE_MODE?.trim().toLowerCase();
-  if (raw && VALID_MODES.includes(raw)) {
-    return raw;
-  }
-  return "oss";
-}
-function isPlatformMode() {
-  return getInstanceMode() === "platform";
-}
-function isOssMode() {
-  return getInstanceMode() === "oss";
-}
-
 // src/crypto/secrets.ts
 import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
 import {
@@ -1090,6 +1098,11 @@ function pgSchemaName(subgraphName) {
   const safeName = subgraphName.replace(/-/g, "_");
   return `subgraph_${safeName}`;
 }
+function localSubgraphAccountId(accountId) {
+  if (!isPlatformMode())
+    return "";
+  return accountId ?? "";
+}
 function pgSchemaNameFor(accountId, subgraphName) {
   if (!accountId)
     return pgSchemaName(subgraphName);
@@ -1098,19 +1111,21 @@ function pgSchemaNameFor(accountId, subgraphName) {
   return `subgraph_${accountPrefix}_${safeName}`;
 }
 async function registerSubgraph(db, data) {
-  return await db.insertInto("subgraphs").values({
+  const accountId = localSubgraphAccountId(data.accountId);
+  const values = {
     name: data.name,
     version: data.version,
     definition: jsonb(data.definition),
     schema_hash: data.schemaHash,
     handler_path: data.handlerPath,
-    account_id: data.accountId ?? "",
+    account_id: accountId,
     handler_code: data.handlerCode ?? null,
     source_code: data.sourceCode ?? null,
     schema_name: data.schemaName ?? null,
     start_block: data.startBlock ?? 0,
     database_url_enc: data.databaseUrlEnc ?? null
-  }).onConflict((oc) => oc.columns(["name", "account_id"]).doUpdateSet({
+  };
+  const updateSet = {
     version: data.version,
     definition: jsonb(data.definition),
     schema_hash: data.schemaHash,
@@ -1121,18 +1136,26 @@ async function registerSubgraph(db, data) {
     start_block: data.startBlock ?? 0,
     database_url_enc: data.databaseUrlEnc ?? null,
     updated_at: new Date
-  })).returningAll().executeTakeFirstOrThrow();
+  };
+  if (!isPlatformMode()) {
+    const existing = await db.selectFrom("subgraphs").select("id").where("name", "=", data.name).executeTakeFirst();
+    if (existing) {
+      return await db.updateTable("subgraphs").set({ ...updateSet, account_id: "" }).where("id", "=", existing.id).returningAll().executeTakeFirstOrThrow();
+    }
+    return await db.insertInto("subgraphs").values(values).returningAll().executeTakeFirstOrThrow();
+  }
+  return await db.insertInto("subgraphs").values(values).onConflict((oc) => oc.columns(["name", "account_id"]).doUpdateSet(updateSet)).returningAll().executeTakeFirstOrThrow();
 }
 async function getSubgraph(db, name, accountId) {
   let query = db.selectFrom("subgraphs").selectAll().where("name", "=", name);
-  if (accountId !== undefined) {
+  if (isPlatformMode() && accountId !== undefined) {
     query = query.where("account_id", "=", accountId);
   }
   return await query.executeTakeFirst() ?? null;
 }
 async function listSubgraphs(db, accountId) {
   let query = db.selectFrom("subgraphs").selectAll();
-  if (accountId !== undefined) {
+  if (isPlatformMode() && accountId !== undefined) {
     query = query.where("account_id", "=", accountId);
   }
   return query.execute();
@@ -1224,6 +1247,7 @@ export {
   recordLiveError,
   pgSchemaNameFor,
   pgSchemaName,
+  localSubgraphAccountId,
   listSubgraphs,
   isByoSubgraph,
   getSubgraph,
@@ -1232,5 +1256,5 @@ export {
   deleteSubgraph
 };
 
-//# debugId=16E379E05D51917964756E2164756E21
+//# debugId=BD59655AE696BBAF64756E2164756E21
 //# sourceMappingURL=subgraphs.js.map