@secondlayer/shared 6.28.1 → 6.30.0

package/dist/src/index.js

@@ -672,6 +672,7 @@ var TABLE_TO_DB = {
   api_keys: "target",
   sessions: "target",
   magic_links: "target",
+  claim_tokens: "target",
   usage_daily: "target",
   usage_snapshots: "target",
   account_insights: "target",
@@ -698,6 +699,8 @@ var TABLE_TO_DB = {
   subgraph_usage_daily: "target",
   subgraph_processing_stats: "target",
   subgraph_table_snapshots: "target",
+  x402_payments: "target",
+  x402_balances: "target",
   service_heartbeats: "both"
 };
 
@@ -864,6 +867,7 @@ var ErrorCodes = {
   AUTHENTICATION_ERROR: "AUTHENTICATION_ERROR",
   AUTHORIZATION_ERROR: "AUTHORIZATION_ERROR",
   RATE_LIMIT_ERROR: "RATE_LIMIT_ERROR",
+  PAYMENT_REQUIRED: "PAYMENT_REQUIRED",
   FORBIDDEN: "FORBIDDEN",
   VERSION_CONFLICT: "VERSION_CONFLICT",
   NOT_FOUND: "NOT_FOUND",
@@ -933,6 +937,12 @@ class RateLimitError extends SecondLayerError {
   }
 }
 
+class PaymentRequiredError extends SecondLayerError {
+  constructor(message, details) {
+    super("PAYMENT_REQUIRED", message, undefined, details);
+  }
+}
+
 class ForbiddenError extends SecondLayerError {
   constructor(message = "Forbidden") {
     super("FORBIDDEN", message);
@@ -963,6 +973,7 @@ class TenantSuspendedError extends SecondLayerError {
 var CODE_TO_STATUS = {
   AUTHENTICATION_ERROR: 401,
   AUTHORIZATION_ERROR: 403,
+  PAYMENT_REQUIRED: 402,
   RATE_LIMIT_ERROR: 429,
   FORBIDDEN: 403,
   NOT_FOUND: 404,
@@ -972,7 +983,10 @@ var CODE_TO_STATUS = {
   NO_TENANT_FOR_PROJECT: 404,
   INSTANCE_EXISTS: 409,
   SUBGRAPH_NOT_FOUND: 404,
-  BYO_BREAKING_CHANGE: 422
+  BYO_BREAKING_CHANGE: 422,
+  PUBLIC_NAME_TAKEN: 409,
+  GHOST_KEY_READ_ONLY: 403,
+  GENESIS_BACKFILL_REQUIRES_PLAN: 403
 };
 function getErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
@@ -1094,7 +1108,8 @@ var DeploySubgraphRequestSchema = z3.object({
   startBlock: z3.number().int().nonnegative().optional(),
   sourceCode: z3.string().max(1048576, "source code exceeds 1MB limit").optional(),
   databaseUrl: z3.string().url().refine((u) => u.startsWith("postgres://") || u.startsWith("postgresql://"), "must be a postgres:// connection string").optional(),
-  dryRun: z3.boolean().optional()
+  dryRun: z3.boolean().optional(),
+  visibility: z3.enum(["public", "private"]).optional()
 });
 
 // src/schemas/subscriptions.ts
@@ -1414,18 +1429,23 @@ function validateSubscriptionFilterForTable(input) {
 // src/subgraphs/spec.ts
 var SYSTEM_COLUMNS = ["_id", "_block_height", "_tx_id", "_created_at"];
 var BASE_QUERY_PARAMS = ["_limit", "_offset", "_sort", "_order", "_fields"];
+var PUBLIC_BASE_QUERY_PARAMS = ["_limit", "cursor", "_order", "_fields"];
 var COMPARISON_OPS = ["neq", "gt", "gte", "lt", "lte"];
+function isPublicRead(detail) {
+  return detail.visibility === "public";
+}
 function generatedAt(options) {
   return options.generatedAt ?? new Date().toISOString();
 }
 function normalizeServerUrl(serverUrl) {
   return (serverUrl ?? "https://api.secondlayer.tools").replace(/\/+$/, "");
 }
-function tablePath(subgraphName, tableName) {
-  return `/api/subgraphs/${subgraphName}/${tableName}`;
+function tablePath(subgraphName, tableName, publicRead) {
+  const base = publicRead ? "/v1/subgraphs" : "/api/subgraphs";
+  return `${base}/${subgraphName}/${tableName}`;
 }
-function countPath(subgraphName, tableName) {
-  return `${tablePath(subgraphName, tableName)}/count`;
+function countPath(subgraphName, tableName, publicRead) {
+  return `${tablePath(subgraphName, tableName, publicRead)}/count`;
 }
 function isTextLike(type) {
   return type === "text" || type === "principal" || type === "timestamp";
@@ -1512,8 +1532,8 @@ function filterNames(table) {
   }
   return result;
 }
-function queryParameters(table) {
-  const params = [...BASE_QUERY_PARAMS];
+function queryParameters(table, publicRead) {
+  const params = publicRead ? [...PUBLIC_BASE_QUERY_PARAMS] : [...BASE_QUERY_PARAMS];
   if (searchableColumns(table).length > 0)
     params.push("_search");
   return params;
@@ -1534,8 +1554,24 @@ function openApiParameter(name2, description, schema = { type: "string" }) {
     schema
   };
 }
-function tableParameters(table) {
-  const parameters = [
+function tableParameters(table, publicRead) {
+  const parameters = publicRead ? [
+    openApiParameter("_limit", "Maximum rows to return.", {
+      type: "integer",
+      default: 50,
+      minimum: 1,
+      maximum: 1000
+    }),
+    openApiParameter("cursor", "Resume token from next_cursor (keyset pagination on _id).", { type: "string" }),
+    openApiParameter("_order", "Sort direction (_id keyset).", {
+      type: "string",
+      enum: ["asc", "desc"],
+      default: "asc"
+    }),
+    openApiParameter("_fields", "Comma-separated columns to include.", {
+      type: "string"
+    })
+  ] : [
     openApiParameter("_limit", "Maximum rows to return.", {
       type: "integer",
       default: 50,
@@ -1589,19 +1625,24 @@ function tableParameters(table) {
 }
 function generateSubgraphAgentSchema(detail, options = {}) {
   const serverUrl = normalizeServerUrl(options.serverUrl);
+  const publicRead = isPublicRead(detail);
   const tables = {};
   for (const [tableName, table] of Object.entries(detail.tables)) {
-    const path = tablePath(detail.name, tableName);
+    const path = tablePath(detail.name, tableName, publicRead);
     tables[tableName] = {
       endpoint: `${serverUrl}${path}`,
-      countEndpoint: `${serverUrl}${countPath(detail.name, tableName)}`,
+      countEndpoint: `${serverUrl}${countPath(detail.name, tableName, publicRead)}`,
+      ...publicRead ? {
+        aggregateEndpoint: `${serverUrl}${path}/aggregate`,
+        streamEndpoint: `${serverUrl}${path}/stream`
+      } : {},
       rowCount: table.rowCount,
       columns: table.columns,
       ...table.indexes ? { indexes: table.indexes } : {},
       ...table.uniqueKeys ? { uniqueKeys: table.uniqueKeys } : {},
       query: {
-        parameters: queryParameters(table),
-        sortable: selectableColumns(table),
+        parameters: queryParameters(table, publicRead),
+        sortable: publicRead ? [] : selectableColumns(table),
         selectable: selectableColumns(table),
         searchable: searchableColumns(table),
         filters: filterNames(table)
@@ -1609,7 +1650,7 @@ function generateSubgraphAgentSchema(detail, options = {}) {
       examples: {
         list: rowExample(table),
         count: { count: table.rowCount },
-        curl: `curl '${serverUrl}${path}?_limit=10&_sort=_block_height&_order=desc'`
+        curl: publicRead ? `curl '${serverUrl}${path}?_limit=10&_order=desc'` : `curl '${serverUrl}${path}?_limit=10&_sort=_block_height&_order=desc'`
       }
     };
   }
@@ -1626,6 +1667,7 @@ function generateSubgraphAgentSchema(detail, options = {}) {
 }
 function generateSubgraphOpenApi(detail, options = {}) {
   const serverUrl = normalizeServerUrl(options.serverUrl);
+  const publicRead = isPublicRead(detail);
   const paths = {};
   const schemas = {};
   for (const [tableName, table] of Object.entries(detail.tables)) {
@@ -1643,44 +1685,62 @@ function generateSubgraphOpenApi(detail, options = {}) {
       required,
       example: rowExample(table)
     };
-    paths[tablePath(detail.name, tableName)] = {
+    const responseSchema = publicRead ? {
+      type: "object",
+      properties: {
+        rows: {
+          type: "array",
+          items: { $ref: `#/components/schemas/${schemaName}` }
+        },
+        next_cursor: { type: ["string", "null"] },
+        tip: {
+          type: "object",
+          properties: {
+            block_height: { type: "integer" },
+            subgraph_height: { type: "integer" },
+            blocks_behind: { type: "integer" }
+          }
+        }
+      }
+    } : {
+      type: "object",
+      properties: {
+        data: {
+          type: "array",
+          items: { $ref: `#/components/schemas/${schemaName}` }
+        },
+        meta: {
+          type: "object",
+          properties: {
+            total: { type: "integer" },
+            limit: { type: "integer" },
+            offset: { type: "integer" }
+          }
+        }
+      }
+    };
+    paths[tablePath(detail.name, tableName, publicRead)] = {
       get: {
         summary: `Query ${detail.name}.${tableName}`,
         operationId: `query_${detail.name.replace(/-/g, "_")}_${tableName}`,
-        parameters: tableParameters(table),
+        parameters: tableParameters(table, publicRead),
         responses: {
           "200": {
             description: "Rows returned from the subgraph table.",
             content: {
               "application/json": {
-                schema: {
-                  type: "object",
-                  properties: {
-                    data: {
-                      type: "array",
-                      items: { $ref: `#/components/schemas/${schemaName}` }
-                    },
-                    meta: {
-                      type: "object",
-                      properties: {
-                        total: { type: "integer" },
-                        limit: { type: "integer" },
-                        offset: { type: "integer" }
-                      }
-                    }
-                  }
-                }
+                schema: responseSchema
               }
             }
           }
         }
       }
     };
-    paths[countPath(detail.name, tableName)] = {
+    paths[countPath(detail.name, tableName, publicRead)] = {
       get: {
         summary: `Count ${detail.name}.${tableName}`,
         operationId: `count_${detail.name.replace(/-/g, "_")}_${tableName}`,
-        parameters: tableParameters(table),
+        parameters: tableParameters(table, publicRead),
         responses: {
           "200": {
             description: "Row count for the filtered table query.",
@@ -1719,17 +1779,19 @@ function generateSubgraphOpenApi(detail, options = {}) {
 }
 function generateSubgraphMarkdown(detail, options = {}) {
   const agent = generateSubgraphAgentSchema(detail, options);
+  const publicRead = isPublicRead(detail);
   const lines = [
     `# ${detail.name} Subgraph API`,
     "",
     `Version: ${detail.version}`,
     detail.schemaHash ? `Schema hash: ${detail.schemaHash}` : undefined,
     `Server: ${agent.serverUrl}`,
+    publicRead ? "Visibility: public — anon reads, no API key. Responses use the `{ rows, next_cursor, tip }` envelope; paginate with `?cursor=<next_cursor>` and `_order=asc|desc` (`_offset`/`_sort` are rejected)." : undefined,
     "",
     detail.description
   ].filter((line) => line !== undefined && line !== "");
   for (const [tableName, table] of Object.entries(agent.tables)) {
-    lines.push("", `## ${tableName}`, "", `GET ${table.endpoint}`, `GET ${table.countEndpoint}`, "", `Rows: ${table.rowCount}`, "", "### Columns", "", "| Column | Type | Attributes |", "| --- | --- | --- |");
+    lines.push("", `## ${tableName}`, "", `GET ${table.endpoint}`, `GET ${table.countEndpoint}`, ...table.aggregateEndpoint ? [`GET ${table.aggregateEndpoint}`] : [], ...table.streamEndpoint ? [`GET ${table.streamEndpoint} (SSE)`] : [], "", `Rows: ${table.rowCount}`, "", "### Columns", "", "| Column | Type | Attributes |", "| --- | --- | --- |");
     for (const [columnName, col] of Object.entries(table.columns)) {
       const attrs = [
         SYSTEM_COLUMNS.includes(columnName) ? "system" : undefined,
@@ -2007,6 +2069,7 @@ export {
   ReplaySubscriptionRequestSchema,
   RateLimitError,
   PrintEventFilterSchema,
+  PaymentRequiredError,
   NotFoundError,
   NftTransferFilterSchema,
   NftMintFilterSchema,
@@ -2034,5 +2097,5 @@ export {
   AuthenticationError
 };
 
-//# debugId=C4E916AE70681E9064756E2164756E21
+//# debugId=4E318E008C33ACC764756E2164756E21
 //# sourceMappingURL=index.js.map