@secondlayer/shared 11.19.3 → 11.21.0

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

@@ -87,7 +87,6 @@ interface EventsArchiveTable {
 	archived_at: Generated<Date>;
 }
 interface VmEventsTable {
-	id: Generated<string>;
 	tx_id: string;
 	block_height: number;
 	ordinal: number;
@@ -97,6 +96,7 @@ interface VmEventsTable {
 }
 interface VmEventsArchiveTable {
 	archive_id: Generated<string>;
+	/** `block_height:ordinal`; rows archived before migration 0153 hold the old uuid. */
 	id: string;
 	tx_id: string;
 	block_height: number;
@@ -107,6 +107,25 @@ interface VmEventsArchiveTable {
 	orphaned_block_hash: string | null;
 	archived_at: Generated<Date>;
 }
+interface StateWritesTable {
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+}
+interface StateWritesArchiveTable {
+	archive_id: Generated<string>;
+	/** `block_height:ordinal`. */
+	id: string;
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
 interface DeadLetterEventsTable {
 	id: Generated<string>;
 	block_height: number;
@@ -768,9 +787,11 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	vm_events: VmEventsTable;
+	state_writes: StateWritesTable;
 	transactions_archive: TransactionsArchiveTable;
 	events_archive: EventsArchiveTable;
 	vm_events_archive: VmEventsArchiveTable;
+	state_writes_archive: StateWritesArchiveTable;
 	dead_letter_events: DeadLetterEventsTable;
 	mempool_transactions: MempoolTransactionsTable;
 	index_progress: IndexProgressTable;
@@ -826,6 +847,8 @@ interface Database {
 	sentinel_accounts: SentinelAccountsTable;
 	waitlists: WaitlistsTable;
 	waitlist_signups: WaitlistSignupsTable;
+	api_failed_requests: ApiFailedRequestsTable;
+	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
 	name: string;
@@ -1034,6 +1057,43 @@ interface WaitlistSignupsTable {
 	answers: Record<string, unknown>;
 	created_at: Generated<Date>;
 }
+/**
+* 24h hosted record of a failed API request, keyed by `request_id` and
+* scoped to the account that made it. `query` is redacted before insert.
+*/
+interface ApiFailedRequestsTable {
+	request_id: string;
+	account_id: string;
+	method: string;
+	path: string;
+	status: number;
+	code: string;
+	message: Generated<string>;
+	query: Record<string, unknown>;
+	origin: string | null;
+	created_at: Generated<Date>;
+}
+/**
+* Hosted problem report. `attempted` is the server's own copy of the failed
+* request (never caller-supplied); `status` starts `new` until classified.
+*/
+interface FeedbackTicketsTable {
+	id: Generated<string>;
+	account_id: string;
+	idempotency_key: string | null;
+	request_id: string | null;
+	intent: string;
+	expected: Record<string, unknown> | null;
+	kind_hint: string | null;
+	evidence: Record<string, unknown> | null;
+	attempted: Record<string, unknown> | null;
+	origin: string;
+	status: Generated<"new" | "classified">;
+	route: string | null;
+	classification: Record<string, unknown> | null;
+	classified_at: Date | null;
+	created_at: Generated<Date>;
+}
 declare function isActiveSubgraphOperationConflict(err: unknown): boolean;
 declare function createSubgraphOperation(db: Kysely<Database>, data: {
 	subgraphId: string

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

@@ -87,7 +87,6 @@ interface EventsArchiveTable {
 	archived_at: Generated<Date>;
 }
 interface VmEventsTable {
-	id: Generated<string>;
 	tx_id: string;
 	block_height: number;
 	ordinal: number;
@@ -97,6 +96,7 @@ interface VmEventsTable {
 }
 interface VmEventsArchiveTable {
 	archive_id: Generated<string>;
+	/** `block_height:ordinal`; rows archived before migration 0153 hold the old uuid. */
 	id: string;
 	tx_id: string;
 	block_height: number;
@@ -107,6 +107,25 @@ interface VmEventsArchiveTable {
 	orphaned_block_hash: string | null;
 	archived_at: Generated<Date>;
 }
+interface StateWritesTable {
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+}
+interface StateWritesArchiveTable {
+	archive_id: Generated<string>;
+	/** `block_height:ordinal`. */
+	id: string;
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
 interface DeadLetterEventsTable {
 	id: Generated<string>;
 	block_height: number;
@@ -768,9 +787,11 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	vm_events: VmEventsTable;
+	state_writes: StateWritesTable;
 	transactions_archive: TransactionsArchiveTable;
 	events_archive: EventsArchiveTable;
 	vm_events_archive: VmEventsArchiveTable;
+	state_writes_archive: StateWritesArchiveTable;
 	dead_letter_events: DeadLetterEventsTable;
 	mempool_transactions: MempoolTransactionsTable;
 	index_progress: IndexProgressTable;
@@ -826,6 +847,8 @@ interface Database {
 	sentinel_accounts: SentinelAccountsTable;
 	waitlists: WaitlistsTable;
 	waitlist_signups: WaitlistSignupsTable;
+	api_failed_requests: ApiFailedRequestsTable;
+	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
 	name: string;
@@ -1034,6 +1057,43 @@ interface WaitlistSignupsTable {
 	answers: Record<string, unknown>;
 	created_at: Generated<Date>;
 }
+/**
+* 24h hosted record of a failed API request, keyed by `request_id` and
+* scoped to the account that made it. `query` is redacted before insert.
+*/
+interface ApiFailedRequestsTable {
+	request_id: string;
+	account_id: string;
+	method: string;
+	path: string;
+	status: number;
+	code: string;
+	message: Generated<string>;
+	query: Record<string, unknown>;
+	origin: string | null;
+	created_at: Generated<Date>;
+}
+/**
+* Hosted problem report. `attempted` is the server's own copy of the failed
+* request (never caller-supplied); `status` starts `new` until classified.
+*/
+interface FeedbackTicketsTable {
+	id: Generated<string>;
+	account_id: string;
+	idempotency_key: string | null;
+	request_id: string | null;
+	intent: string;
+	expected: Record<string, unknown> | null;
+	kind_hint: string | null;
+	evidence: Record<string, unknown> | null;
+	attempted: Record<string, unknown> | null;
+	origin: string;
+	status: Generated<"new" | "classified">;
+	route: string | null;
+	classification: Record<string, unknown> | null;
+	classified_at: Date | null;
+	created_at: Generated<Date>;
+}
 /** Convert a subgraph name to its PostgreSQL schema name. */
 declare function pgSchemaName(subgraphName: string): string;
 /** OSS writes empty account_id — name is the local unique key. */

package/dist/src/db/queries/sync-scope.d.ts

@@ -97,7 +97,6 @@ interface EventsArchiveTable {
 	archived_at: Generated<Date>;
 }
 interface VmEventsTable {
-	id: Generated<string>;
 	tx_id: string;
 	block_height: number;
 	ordinal: number;
@@ -107,6 +106,7 @@ interface VmEventsTable {
 }
 interface VmEventsArchiveTable {
 	archive_id: Generated<string>;
+	/** `block_height:ordinal`; rows archived before migration 0153 hold the old uuid. */
 	id: string;
 	tx_id: string;
 	block_height: number;
@@ -117,6 +117,25 @@ interface VmEventsArchiveTable {
 	orphaned_block_hash: string | null;
 	archived_at: Generated<Date>;
 }
+interface StateWritesTable {
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+}
+interface StateWritesArchiveTable {
+	archive_id: Generated<string>;
+	/** `block_height:ordinal`. */
+	id: string;
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
 interface DeadLetterEventsTable {
 	id: Generated<string>;
 	block_height: number;
@@ -778,9 +797,11 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	vm_events: VmEventsTable;
+	state_writes: StateWritesTable;
 	transactions_archive: TransactionsArchiveTable;
 	events_archive: EventsArchiveTable;
 	vm_events_archive: VmEventsArchiveTable;
+	state_writes_archive: StateWritesArchiveTable;
 	dead_letter_events: DeadLetterEventsTable;
 	mempool_transactions: MempoolTransactionsTable;
 	index_progress: IndexProgressTable;
@@ -836,6 +857,8 @@ interface Database {
 	sentinel_accounts: SentinelAccountsTable;
 	waitlists: WaitlistsTable;
 	waitlist_signups: WaitlistSignupsTable;
+	api_failed_requests: ApiFailedRequestsTable;
+	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
 	name: string;
@@ -1044,6 +1067,43 @@ interface WaitlistSignupsTable {
 	created_at: Generated<Date>;
 }
 /**
+* 24h hosted record of a failed API request, keyed by `request_id` and
+* scoped to the account that made it. `query` is redacted before insert.
+*/
+interface ApiFailedRequestsTable {
+	request_id: string;
+	account_id: string;
+	method: string;
+	path: string;
+	status: number;
+	code: string;
+	message: Generated<string>;
+	query: Record<string, unknown>;
+	origin: string | null;
+	created_at: Generated<Date>;
+}
+/**
+* Hosted problem report. `attempted` is the server's own copy of the failed
+* request (never caller-supplied); `status` starts `new` until classified.
+*/
+interface FeedbackTicketsTable {
+	id: Generated<string>;
+	account_id: string;
+	idempotency_key: string | null;
+	request_id: string | null;
+	intent: string;
+	expected: Record<string, unknown> | null;
+	kind_hint: string | null;
+	evidence: Record<string, unknown> | null;
+	attempted: Record<string, unknown> | null;
+	origin: string;
+	status: Generated<"new" | "classified">;
+	route: string | null;
+	classification: Record<string, unknown> | null;
+	classified_at: Date | null;
+	created_at: Generated<Date>;
+}
+/**
 * The instance's declared sync scope.
 *
 * An instance that starts at height N is not an instance missing the first N

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

@@ -87,7 +87,6 @@ interface EventsArchiveTable {
 	archived_at: Generated<Date>;
 }
 interface VmEventsTable {
-	id: Generated<string>;
 	tx_id: string;
 	block_height: number;
 	ordinal: number;
@@ -97,6 +96,7 @@ interface VmEventsTable {
 }
 interface VmEventsArchiveTable {
 	archive_id: Generated<string>;
+	/** `block_height:ordinal`; rows archived before migration 0153 hold the old uuid. */
 	id: string;
 	tx_id: string;
 	block_height: number;
@@ -107,6 +107,25 @@ interface VmEventsArchiveTable {
 	orphaned_block_hash: string | null;
 	archived_at: Generated<Date>;
 }
+interface StateWritesTable {
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+}
+interface StateWritesArchiveTable {
+	archive_id: Generated<string>;
+	/** `block_height:ordinal`. */
+	id: string;
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
 interface DeadLetterEventsTable {
 	id: Generated<string>;
 	block_height: number;
@@ -768,9 +787,11 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	vm_events: VmEventsTable;
+	state_writes: StateWritesTable;
 	transactions_archive: TransactionsArchiveTable;
 	events_archive: EventsArchiveTable;
 	vm_events_archive: VmEventsArchiveTable;
+	state_writes_archive: StateWritesArchiveTable;
 	dead_letter_events: DeadLetterEventsTable;
 	mempool_transactions: MempoolTransactionsTable;
 	index_progress: IndexProgressTable;
@@ -826,6 +847,8 @@ interface Database {
 	sentinel_accounts: SentinelAccountsTable;
 	waitlists: WaitlistsTable;
 	waitlist_signups: WaitlistSignupsTable;
+	api_failed_requests: ApiFailedRequestsTable;
+	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
 	name: string;
@@ -1035,6 +1058,43 @@ interface WaitlistSignupsTable {
 	created_at: Generated<Date>;
 }
 /**
+* 24h hosted record of a failed API request, keyed by `request_id` and
+* scoped to the account that made it. `query` is redacted before insert.
+*/
+interface ApiFailedRequestsTable {
+	request_id: string;
+	account_id: string;
+	method: string;
+	path: string;
+	status: number;
+	code: string;
+	message: Generated<string>;
+	query: Record<string, unknown>;
+	origin: string | null;
+	created_at: Generated<Date>;
+}
+/**
+* Hosted problem report. `attempted` is the server's own copy of the failed
+* request (never caller-supplied); `status` starts `new` until classified.
+*/
+interface FeedbackTicketsTable {
+	id: Generated<string>;
+	account_id: string;
+	idempotency_key: string | null;
+	request_id: string | null;
+	intent: string;
+	expected: Record<string, unknown> | null;
+	kind_hint: string | null;
+	evidence: Record<string, unknown> | null;
+	attempted: Record<string, unknown> | null;
+	origin: string;
+	status: Generated<"new" | "classified">;
+	route: string | null;
+	classification: Record<string, unknown> | null;
+	classified_at: Date | null;
+	created_at: Generated<Date>;
+}
+/**
 * Webhook CRUD. `signing_secret_enc` is transparently encrypted via
 * `encryptSecret`/`decryptSecret`. Plaintext secrets only leave via the
 * return value of `create` (one-time display) and `rotateSecret`.

package/dist/src/db/schema.d.ts

@@ -86,7 +86,6 @@ interface EventsArchiveTable {
 	archived_at: Generated<Date>;
 }
 interface VmEventsTable {
-	id: Generated<string>;
 	tx_id: string;
 	block_height: number;
 	ordinal: number;
@@ -96,6 +95,7 @@ interface VmEventsTable {
 }
 interface VmEventsArchiveTable {
 	archive_id: Generated<string>;
+	/** `block_height:ordinal`; rows archived before migration 0153 hold the old uuid. */
 	id: string;
 	tx_id: string;
 	block_height: number;
@@ -106,6 +106,25 @@ interface VmEventsArchiveTable {
 	orphaned_block_hash: string | null;
 	archived_at: Generated<Date>;
 }
+interface StateWritesTable {
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+}
+interface StateWritesArchiveTable {
+	archive_id: Generated<string>;
+	/** `block_height:ordinal`. */
+	id: string;
+	block_height: number;
+	ordinal: number;
+	tx_index: number | null;
+	key: string;
+	value_hex: string;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
 interface DeadLetterEventsTable {
 	id: Generated<string>;
 	block_height: number;
@@ -767,9 +786,11 @@ interface Database {
 	transactions: TransactionsTable;
 	events: EventsTable;
 	vm_events: VmEventsTable;
+	state_writes: StateWritesTable;
 	transactions_archive: TransactionsArchiveTable;
 	events_archive: EventsArchiveTable;
 	vm_events_archive: VmEventsArchiveTable;
+	state_writes_archive: StateWritesArchiveTable;
 	dead_letter_events: DeadLetterEventsTable;
 	mempool_transactions: MempoolTransactionsTable;
 	index_progress: IndexProgressTable;
@@ -825,6 +846,8 @@ interface Database {
 	sentinel_accounts: SentinelAccountsTable;
 	waitlists: WaitlistsTable;
 	waitlist_signups: WaitlistSignupsTable;
+	api_failed_requests: ApiFailedRequestsTable;
+	feedback_tickets: FeedbackTicketsTable;
 }
 interface ServiceHeartbeatsTable {
 	name: string;
@@ -939,6 +962,8 @@ type UpdateEvent = Updateable<EventsTable>;
 type VmEvent = Selectable<VmEventsTable>;
 type InsertVmEvent = Insertable<VmEventsTable>;
 type UpdateVmEvent = Updateable<VmEventsTable>;
+type StateWrite = Selectable<StateWritesTable>;
+type InsertStateWrite = Insertable<StateWritesTable>;
 type IndexProgress = Selectable<IndexProgressTable>;
 type InsertIndexProgress = Insertable<IndexProgressTable>;
 type UpdateIndexProgress = Updateable<IndexProgressTable>;
@@ -1096,7 +1121,48 @@ interface WaitlistSignupsTable {
 	answers: Record<string, unknown>;
 	created_at: Generated<Date>;
 }
+/**
+* 24h hosted record of a failed API request, keyed by `request_id` and
+* scoped to the account that made it. `query` is redacted before insert.
+*/
+interface ApiFailedRequestsTable {
+	request_id: string;
+	account_id: string;
+	method: string;
+	path: string;
+	status: number;
+	code: string;
+	message: Generated<string>;
+	query: Record<string, unknown>;
+	origin: string | null;
+	created_at: Generated<Date>;
+}
+type ApiFailedRequest = Selectable<ApiFailedRequestsTable>;
+type InsertApiFailedRequest = Insertable<ApiFailedRequestsTable>;
+/**
+* Hosted problem report. `attempted` is the server's own copy of the failed
+* request (never caller-supplied); `status` starts `new` until classified.
+*/
+interface FeedbackTicketsTable {
+	id: Generated<string>;
+	account_id: string;
+	idempotency_key: string | null;
+	request_id: string | null;
+	intent: string;
+	expected: Record<string, unknown> | null;
+	kind_hint: string | null;
+	evidence: Record<string, unknown> | null;
+	attempted: Record<string, unknown> | null;
+	origin: string;
+	status: Generated<"new" | "classified">;
+	route: string | null;
+	classification: Record<string, unknown> | null;
+	classified_at: Date | null;
+	created_at: Generated<Date>;
+}
+type FeedbackTicket = Selectable<FeedbackTicketsTable>;
+type InsertFeedbackTicket = Insertable<FeedbackTicketsTable>;
 type Waitlist = Selectable<WaitlistsTable>;
 type WaitlistSignup = Selectable<WaitlistSignupsTable>;
 type InsertWaitlistSignup = Insertable<WaitlistSignupsTable>;
-export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, ChainReadCacheTable, ChainReorgsTable, Contract, ContractsTable, CoverageSegmentsTable, Database, DeadLetterEventsTable, DecodedEventsTable, DecoderCheckpointsTable, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContract, InsertEvent, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, NativeClock, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RepairMode, RetryState, RunStatus, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, Subgraph, SubgraphGap, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UsageLedgerRow, UsageLedgerTable, VmEvent, VmEventsArchiveTable, VmEventsTable, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookFormat, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookRuntime, WebhookStatus, WebhooksTable };
+export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, ChainReadCacheTable, ChainReorgsTable, Contract, ContractsTable, CoverageSegmentsTable, Database, DeadLetterEventsTable, DecodedEventsTable, DecoderCheckpointsTable, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, NativeClock, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RepairMode, RetryState, RunStatus, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, Subgraph, SubgraphGap, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UsageLedgerRow, UsageLedgerTable, VmEvent, VmEventsArchiveTable, VmEventsTable, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookFormat, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookRuntime, WebhookStatus, WebhooksTable };

package/dist/src/error-envelope.d.ts

@@ -0,0 +1,48 @@
+/**
+* Pure, dependency-free pieces of the API error envelope: request ids,
+* default codes by status, feedback pointers and query redaction. Shared by
+* the API middleware and the workload gateway so both emit the same shape.
+*/
+/** Default `code` for an error body that set none, keyed by HTTP status. */
+declare const DEFAULT_CODE_BY_STATUS: Record<number, string>;
+/** Where to report a gap: a path on hosted, the issue tracker on self-host. */
+declare const FEEDBACK_URL: {
+	readonly platform: "/v1/feedback"
+	readonly oss: "https://github.com/ryanwaits/secondlayer/issues/new"
+};
+/** One hosted failed-request record (account-scoped, kept 24h). */
+type FailedRequestRecord = {
+	request_id: string
+	account_id: string
+	method: string
+	path: string
+	status: number
+	code: string
+	message: string
+	query: Record<string, unknown>
+	origin: string | null
+};
+/** Incoming `X-Request-Id` values matching this are reused. */
+declare const REQUEST_ID_PATTERN: RegExp;
+/** `req_` plus 24 lowercase hex chars. */
+declare function newRequestId(): string;
+/**
+* Query params safe to store: sensitive keys dropped, values capped at 200
+* chars, and a `{ _truncated, keys }` stub when the result is over 2048 chars.
+*/
+declare function redactQuery(params: URLSearchParams): Record<string, unknown>;
+/**
+* Additive error body: `request_id` always set, `code` only when absent or
+* not a string, `feedback` only when absent (or always with
+* `overrideFeedback`). Returns null when `body` is not an object carrying an
+* `error` key, so callers leave such responses alone.
+*/
+declare function augmentErrorBody(body: unknown, opts: {
+	status: number
+	requestId: string
+	feedbackUrl: string
+	overrideFeedback?: boolean
+}): Record<string, unknown> | null;
+/** `x-sl-origin` header reduced to a known value, else null. */
+declare function normalizeOrigin(header: string | undefined): string | null;
+export { DEFAULT_CODE_BY_STATUS, FEEDBACK_URL, FailedRequestRecord, REQUEST_ID_PATTERN, augmentErrorBody, newRequestId, normalizeOrigin, redactQuery };

package/dist/src/error-envelope.js

@@ -0,0 +1,76 @@
+// src/error-envelope.ts
+var DEFAULT_CODE_BY_STATUS = {
+  400: "VALIDATION_ERROR",
+  401: "AUTHENTICATION_ERROR",
+  402: "PAYMENT_REQUIRED",
+  403: "FORBIDDEN",
+  404: "NOT_FOUND",
+  409: "CONFLICT",
+  410: "GONE",
+  415: "UNSUPPORTED_MEDIA_TYPE",
+  422: "VALIDATION_ERROR",
+  429: "RATE_LIMIT_ERROR",
+  500: "INTERNAL_ERROR",
+  502: "UPSTREAM_ERROR",
+  503: "SERVICE_UNAVAILABLE"
+};
+var FEEDBACK_URL = {
+  platform: "/v1/feedback",
+  oss: "https://github.com/ryanwaits/secondlayer/issues/new"
+};
+var REQUEST_ID_PATTERN = /^[A-Za-z0-9._-]{8,64}$/;
+function newRequestId() {
+  const bytes = crypto.getRandomValues(new Uint8Array(12));
+  let hex = "";
+  for (const b of bytes)
+    hex += b.toString(16).padStart(2, "0");
+  return `req_${hex}`;
+}
+var SENSITIVE_KEY = /token|key|secret|signature|password|auth/i;
+var MAX_VALUE_CHARS = 200;
+var MAX_QUERY_JSON_CHARS = 2048;
+function redactQuery(params) {
+  const out = {};
+  for (const [key, value] of params) {
+    if (SENSITIVE_KEY.test(key))
+      continue;
+    out[key] = value.slice(0, MAX_VALUE_CHARS);
+  }
+  if (JSON.stringify(out).length > MAX_QUERY_JSON_CHARS) {
+    return { _truncated: true, keys: Object.keys(out) };
+  }
+  return out;
+}
+function augmentErrorBody(body, opts) {
+  if (typeof body !== "object" || body === null || Array.isArray(body)) {
+    return null;
+  }
+  if (!("error" in body))
+    return null;
+  const src = body;
+  const next = { ...src, request_id: opts.requestId };
+  if (typeof src.code !== "string") {
+    next.code = DEFAULT_CODE_BY_STATUS[opts.status] ?? "HTTP_ERROR";
+  }
+  if (opts.overrideFeedback || src.feedback === undefined) {
+    next.feedback = { url: opts.feedbackUrl };
+  }
+  return next;
+}
+var KNOWN_ORIGINS = ["cli", "mcp", "session"];
+function normalizeOrigin(header) {
+  const v = header?.toLowerCase();
+  return v !== undefined && KNOWN_ORIGINS.includes(v) ? v : null;
+}
+export {
+  DEFAULT_CODE_BY_STATUS,
+  FEEDBACK_URL,
+  REQUEST_ID_PATTERN,
+  augmentErrorBody,
+  newRequestId,
+  normalizeOrigin,
+  redactQuery
+};
+
+//# debugId=5A36C709A44A1A2864756E2164756E21
+//# sourceMappingURL=error-envelope.js.map