@secondlayer/shared 4.3.4 → 4.4.0

package/dist/src/index.d.ts

@@ -841,8 +841,12 @@ interface SubgraphSyncInfo {
 interface SubgraphDetail {
 	name: string;
 	version: string;
+	schemaHash?: string;
 	status: string;
 	lastProcessedBlock: number;
+	description?: string;
+	sources?: Record<string, unknown>;
+	definition?: Record<string, unknown>;
 	health: {
 		totalProcessed: number
 		totalErrors: number
@@ -856,9 +860,14 @@ interface SubgraphDetail {
 		columns: Record<string, {
 			type: string
 			nullable?: boolean
+			indexed?: boolean
+			searchable?: boolean
+			default?: string | number | boolean
 		}>
 		rowCount: number
 		example: string
+		indexes?: string[][]
+		uniqueKeys?: string[][]
 	}>;
 	createdAt: string;
 	updatedAt: string;
@@ -1036,6 +1045,46 @@ declare function validateSubscriptionFilterForTable(input: {
 	filter?: unknown
 	tables: SubscriptionSchemaTables
 }): string[];
+type SubgraphSpecFormat = "openapi" | "agent" | "markdown";
+interface SubgraphSpecOptions {
+	serverUrl?: string;
+	generatedAt?: string;
+}
+interface SubgraphAgentSchema {
+	name: string;
+	version: string;
+	description?: string;
+	schemaHash?: string;
+	generatedAt: string;
+	serverUrl: string;
+	sources?: Record<string, unknown>;
+	tables: Record<string, {
+		endpoint: string
+		countEndpoint: string
+		rowCount: number
+		columns: SubgraphDetail["tables"][string]["columns"]
+		indexes?: string[][]
+		uniqueKeys?: string[][]
+		query: {
+			parameters: string[]
+			sortable: string[]
+			selectable: string[]
+			searchable: string[]
+			filters: string[]
+		}
+		examples: {
+			list: Record<string, unknown>
+			count: {
+				count: number
+			}
+			curl: string
+		}
+	}>;
+}
+declare function generateSubgraphAgentSchema(detail: SubgraphDetail, options?: SubgraphSpecOptions): SubgraphAgentSchema;
+declare function generateSubgraphOpenApi(detail: SubgraphDetail, options?: SubgraphSpecOptions): Record<string, unknown>;
+declare function generateSubgraphMarkdown(detail: SubgraphDetail, options?: SubgraphSpecOptions): string;
+declare function generateSubgraphSpec(detail: SubgraphDetail, format: SubgraphSpecFormat, options?: SubgraphSpecOptions): Record<string, unknown> | SubgraphAgentSchema | string;
 declare namespace exports_hmac {
 	export { verifySignatureHeader, verifySignature, signPayload, generateSecret, createSignatureHeader };
 }
@@ -1064,4 +1113,4 @@ declare function createSignatureHeader(payload: string, secret: string, timestam
 * Returns true if valid, false otherwise
 */
 declare function verifySignatureHeader(payload: string, header: string, secret: string, toleranceSeconds?: number): boolean;
-export { validateSubscriptionFilterForTable, sql, parseJsonb, logger, jsonb, getTargetDb, getSourceDb, getRawClient, getErrorMessage, getEnv, getDb, formatSubscriptionSchemaErrors, exports_hmac as crypto, closeDb, WaitlistTable, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateProfileRequestSchema, UpdateProfileRequest, UpdateIndexProgress, UpdateEvent, UpdateChatSession, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, TransactionsTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, SessionsTable, Session, SecondLayerError, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, PrintEventFilterSchema, PrintEventFilter, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MagicLinksTable, MagicLink, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertChatSession, InsertChatMessage, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DeadRow, DatabaseError, Database, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, ChatSessionsTable, ChatSession, ChatMessagesTable, ChatMessage, CODE_TO_STATUS, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountAgentRunsTable, AccountAgentRun, Account };
+export { validateSubscriptionFilterForTable, sql, parseJsonb, logger, jsonb, getTargetDb, getSourceDb, getRawClient, getErrorMessage, getEnv, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, exports_hmac as crypto, closeDb, WaitlistTable, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateProfileRequestSchema, UpdateProfileRequest, UpdateIndexProgress, UpdateEvent, UpdateChatSession, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, TransactionsTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphSpecOptions, SubgraphSpecFormat, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, SessionsTable, Session, SecondLayerError, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, PrintEventFilterSchema, PrintEventFilter, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MagicLinksTable, MagicLink, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertChatSession, InsertChatMessage, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DeadRow, DatabaseError, Database, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, ChatSessionsTable, ChatSession, ChatMessagesTable, ChatMessage, CODE_TO_STATUS, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountAgentRunsTable, AccountAgentRun, Account };

package/dist/src/index.js

@@ -596,6 +596,348 @@ function validateSubscriptionFilterForTable(input) {
   }
   return errors;
 }
+// src/subgraphs/spec.ts
+var SYSTEM_COLUMNS = ["_id", "_block_height", "_tx_id", "_created_at"];
+var BASE_QUERY_PARAMS = ["_limit", "_offset", "_sort", "_order", "_fields"];
+var COMPARISON_OPS = ["neq", "gt", "gte", "lt", "lte"];
+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 countPath(subgraphName, tableName) {
+  return `${tablePath(subgraphName, tableName)}/count`;
+}
+function isTextLike(type) {
+  return type === "text" || type === "principal" || type === "timestamp";
+}
+function isComparable(type) {
+  return type === "uint" || type === "int" || type === "bigint" || type === "serial" || type === "timestamp";
+}
+function exampleForColumn(type) {
+  switch (type) {
+    case "uint":
+    case "int":
+    case "bigint":
+      return "1000";
+    case "serial":
+      return 1;
+    case "principal":
+      return "SP000000000000000000002Q6VF78";
+    case "timestamp":
+      return "2026-01-01T00:00:00.000Z";
+    case "boolean":
+      return true;
+    case "jsonb":
+      return { example: true };
+    default:
+      return "example";
+  }
+}
+function openApiSchemaForColumn(col) {
+  let schema;
+  switch (col.type) {
+    case "uint":
+    case "int":
+    case "bigint":
+      schema = { type: "string", pattern: "^-?\\d+(\\.\\d+)?$" };
+      break;
+    case "serial":
+      schema = { type: "integer" };
+      break;
+    case "principal":
+    case "text":
+      schema = { type: "string" };
+      break;
+    case "timestamp":
+      schema = { type: "string", format: "date-time" };
+      break;
+    case "boolean":
+      schema = { type: "boolean" };
+      break;
+    case "jsonb":
+      schema = { type: "object", additionalProperties: true };
+      break;
+    default:
+      schema = {};
+      break;
+  }
+  if (col.nullable) {
+    const type = schema.type;
+    if (typeof type === "string")
+      schema.type = [type, "null"];
+  }
+  return schema;
+}
+function columnEntries(table) {
+  return Object.entries(table.columns);
+}
+function selectableColumns(table) {
+  return columnEntries(table).map(([name2]) => name2);
+}
+function searchableColumns(table) {
+  return columnEntries(table).filter(([, col]) => col.searchable).map(([name2]) => name2);
+}
+function filterNames(table) {
+  const result = [];
+  for (const [name2, col] of columnEntries(table)) {
+    result.push(name2);
+    result.push(`${name2}.neq`);
+    if (isComparable(col.type)) {
+      for (const op of COMPARISON_OPS.filter((op2) => op2 !== "neq")) {
+        result.push(`${name2}.${op}`);
+      }
+    }
+    if (isTextLike(col.type))
+      result.push(`${name2}.like`);
+  }
+  return result;
+}
+function queryParameters(table) {
+  const params = [...BASE_QUERY_PARAMS];
+  if (searchableColumns(table).length > 0)
+    params.push("_search");
+  return params;
+}
+function rowExample(table) {
+  const row = {};
+  for (const [name2, col] of columnEntries(table)) {
+    row[name2] = exampleForColumn(col.type);
+  }
+  return row;
+}
+function openApiParameter(name2, description, schema = { type: "string" }) {
+  return {
+    name: name2,
+    in: "query",
+    required: false,
+    description,
+    schema
+  };
+}
+function tableParameters(table) {
+  const parameters = [
+    openApiParameter("_limit", "Maximum rows to return.", {
+      type: "integer",
+      default: 50,
+      minimum: 1,
+      maximum: 1000
+    }),
+    openApiParameter("_offset", "Rows to skip for pagination.", {
+      type: "integer",
+      default: 0,
+      minimum: 0
+    }),
+    openApiParameter("_sort", "Column to sort by.", {
+      type: "string",
+      enum: selectableColumns(table)
+    }),
+    openApiParameter("_order", "Sort direction.", {
+      type: "string",
+      enum: ["asc", "desc"],
+      default: "asc"
+    }),
+    openApiParameter("_fields", "Comma-separated columns to include.", {
+      type: "string"
+    })
+  ];
+  if (searchableColumns(table).length > 0) {
+    parameters.push(openApiParameter("_search", "Search across searchable columns.", {
+      type: "string"
+    }));
+  }
+  for (const [name2, col] of columnEntries(table)) {
+    parameters.push(openApiParameter(name2, `Filter ${name2} by equality.`, {
+      type: "string"
+    }));
+    parameters.push(openApiParameter(`${name2}.neq`, `Filter ${name2} by inequality.`, {
+      type: "string"
+    }));
+    if (isComparable(col.type)) {
+      for (const op of ["gt", "gte", "lt", "lte"]) {
+        parameters.push(openApiParameter(`${name2}.${op}`, `Filter ${name2} with ${op}.`, {
+          type: "string"
+        }));
+      }
+    }
+    if (isTextLike(col.type)) {
+      parameters.push(openApiParameter(`${name2}.like`, `Case-insensitive contains filter for ${name2}.`, {
+        type: "string"
+      }));
+    }
+  }
+  return parameters;
+}
+function generateSubgraphAgentSchema(detail, options = {}) {
+  const serverUrl = normalizeServerUrl(options.serverUrl);
+  const tables = {};
+  for (const [tableName, table] of Object.entries(detail.tables)) {
+    const path = tablePath(detail.name, tableName);
+    tables[tableName] = {
+      endpoint: `${serverUrl}${path}`,
+      countEndpoint: `${serverUrl}${countPath(detail.name, tableName)}`,
+      rowCount: table.rowCount,
+      columns: table.columns,
+      ...table.indexes ? { indexes: table.indexes } : {},
+      ...table.uniqueKeys ? { uniqueKeys: table.uniqueKeys } : {},
+      query: {
+        parameters: queryParameters(table),
+        sortable: selectableColumns(table),
+        selectable: selectableColumns(table),
+        searchable: searchableColumns(table),
+        filters: filterNames(table)
+      },
+      examples: {
+        list: rowExample(table),
+        count: { count: table.rowCount },
+        curl: `curl '${serverUrl}${path}?_limit=10&_sort=_block_height&_order=desc'`
+      }
+    };
+  }
+  return {
+    name: detail.name,
+    version: detail.version,
+    ...detail.description ? { description: detail.description } : {},
+    ...detail.schemaHash ? { schemaHash: detail.schemaHash } : {},
+    generatedAt: generatedAt(options),
+    serverUrl,
+    ...detail.sources ? { sources: detail.sources } : {},
+    tables
+  };
+}
+function generateSubgraphOpenApi(detail, options = {}) {
+  const serverUrl = normalizeServerUrl(options.serverUrl);
+  const paths = {};
+  const schemas = {};
+  for (const [tableName, table] of Object.entries(detail.tables)) {
+    const schemaName = `${tableName}Row`;
+    const properties = {};
+    const required = [];
+    for (const [columnName, column] of columnEntries(table)) {
+      properties[columnName] = openApiSchemaForColumn(column);
+      if (!column.nullable)
+        required.push(columnName);
+    }
+    schemas[schemaName] = {
+      type: "object",
+      properties,
+      required,
+      example: rowExample(table)
+    };
+    paths[tablePath(detail.name, tableName)] = {
+      get: {
+        summary: `Query ${detail.name}.${tableName}`,
+        operationId: `query_${detail.name.replace(/-/g, "_")}_${tableName}`,
+        parameters: tableParameters(table),
+        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" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    };
+    paths[countPath(detail.name, tableName)] = {
+      get: {
+        summary: `Count ${detail.name}.${tableName}`,
+        operationId: `count_${detail.name.replace(/-/g, "_")}_${tableName}`,
+        parameters: tableParameters(table),
+        responses: {
+          "200": {
+            description: "Row count for the filtered table query.",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: { count: { type: "integer" } },
+                  required: ["count"],
+                  example: { count: table.rowCount }
+                }
+              }
+            }
+          }
+        }
+      }
+    };
+  }
+  return {
+    openapi: "3.1.0",
+    info: {
+      title: `${detail.name} Subgraph API`,
+      version: detail.version,
+      ...detail.description ? { description: detail.description } : {}
+    },
+    servers: [{ url: serverUrl }],
+    paths,
+    components: { schemas },
+    "x-secondlayer-subgraph": detail.name,
+    "x-secondlayer-version": detail.version,
+    "x-secondlayer-schema-hash": detail.schemaHash,
+    "x-secondlayer-generated-at": generatedAt(options),
+    "x-secondlayer-sources": detail.sources ?? {},
+    "x-secondlayer-tables": Object.keys(detail.tables)
+  };
+}
+function generateSubgraphMarkdown(detail, options = {}) {
+  const agent = generateSubgraphAgentSchema(detail, options);
+  const lines = [
+    `# ${detail.name} Subgraph API`,
+    "",
+    `Version: ${detail.version}`,
+    detail.schemaHash ? `Schema hash: ${detail.schemaHash}` : undefined,
+    `Server: ${agent.serverUrl}`,
+    "",
+    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 |", "| --- | --- | --- |");
+    for (const [columnName, col] of Object.entries(table.columns)) {
+      const attrs = [
+        SYSTEM_COLUMNS.includes(columnName) ? "system" : undefined,
+        col.nullable ? "nullable" : undefined,
+        col.indexed ? "indexed" : undefined,
+        col.searchable ? "searchable" : undefined
+      ].filter(Boolean).join(", ");
+      lines.push(`| \`${columnName}\` | \`${col.type}\` | ${attrs || "-"} |`);
+    }
+    lines.push("", "### Query", "", `Parameters: ${table.query.parameters.map((p) => `\`${p}\``).join(", ")}`, `Filters: ${table.query.filters.map((p) => `\`${p}\``).join(", ")}`, "", "### Example", "", "```bash", table.examples.curl, "```");
+  }
+  return `${lines.join(`
+`)}
+`;
+}
+function generateSubgraphSpec(detail, format, options = {}) {
+  if (format === "openapi")
+    return generateSubgraphOpenApi(detail, options);
+  if (format === "agent")
+    return generateSubgraphAgentSchema(detail, options);
+  return generateSubgraphMarkdown(detail, options);
+}
+
 // src/crypto/hmac.ts
 var exports_hmac = {};
 __export(exports_hmac, {
@@ -661,6 +1003,10 @@ export {
   getErrorMessage,
   getEnv,
   getDb,
+  generateSubgraphSpec,
+  generateSubgraphOpenApi,
+  generateSubgraphMarkdown,
+  generateSubgraphAgentSchema,
   formatSubscriptionSchemaErrors,
   exports_hmac as crypto,
   closeDb,
@@ -709,5 +1055,5 @@ export {
   AuthenticationError
 };
 
-//# debugId=710A523C096CF83964756E2164756E21
+//# debugId=F03F167A347C5EE364756E2164756E21
 //# sourceMappingURL=index.js.map