@secondlayer/shared 6.14.1 → 6.16.0

package/dist/src/index.d.ts

@@ -635,6 +635,7 @@ interface Database {
 	subscriptions: SubscriptionsTable;
 	subscription_outbox: SubscriptionOutboxTable;
 	subscription_deliveries: SubscriptionDeliveriesTable;
+	trigger_evaluator_state: TriggerEvaluatorStateTable;
 	decoded_events: DecodedEventsTable;
 	l2_decoder_checkpoints: L2DecoderCheckpointsTable;
 	chain_reorgs: ChainReorgsTable;
@@ -803,6 +804,10 @@ type UpdateChatSession = Updateable<ChatSessionsTable>;
 type ChatMessage = Selectable<ChatMessagesTable>;
 type InsertChatMessage = Insertable<ChatMessagesTable>;
 type SubscriptionStatus = "active" | "paused" | "error";
+/** Polymorphic subscription mode: `subgraph` reacts to processed table rows;
+*  `chain` reacts to raw chain events matched directly off the Index/Streams
+*  clock (no subgraph). See migration 0088. */
+type SubscriptionKind = "subgraph" | "chain";
 type SubscriptionFormat = "standard-webhooks" | "inngest" | "trigger" | "cloudflare" | "cloudevents" | "raw";
 type SubscriptionRuntime = "inngest" | "trigger" | "cloudflare" | "node";
 interface SubscriptionsTable {
@@ -811,8 +816,15 @@ interface SubscriptionsTable {
 	project_id: string | null;
 	name: string;
 	status: ColumnType<SubscriptionStatus, SubscriptionStatus | undefined, SubscriptionStatus>;
-	subgraph_name: string;
-	table_name: string;
+	kind: ColumnType<SubscriptionKind, SubscriptionKind | undefined, SubscriptionKind>;
+	/** Null for chain subscriptions (CHECK subscriptions_kind_shape). */
+	subgraph_name: string | null;
+	/** Null for chain subscriptions (CHECK subscriptions_kind_shape). */
+	table_name: string | null;
+	/** Chain-trigger filter array (the `SubgraphFilter` shape, JSON). Null for
+	*  subgraph subscriptions. Typed loosely here to avoid a shared→subgraphs
+	*  import cycle; the Zod schema in schemas/subscriptions.ts owns the shape. */
+	triggers: unknown | null;
 	filter: Generated<unknown>;
 	format: ColumnType<SubscriptionFormat, SubscriptionFormat | undefined, SubscriptionFormat>;
 	runtime: SubscriptionRuntime | null;
@@ -837,8 +849,11 @@ type OutboxStatus = "pending" | "delivered" | "dead";
 interface SubscriptionOutboxTable {
 	id: Generated<string>;
 	subscription_id: string;
-	subgraph_name: string;
-	table_name: string;
+	kind: ColumnType<SubscriptionKind, SubscriptionKind | undefined, SubscriptionKind>;
+	/** Null for chain-subscription rows. */
+	subgraph_name: string | null;
+	/** Null for chain-subscription rows. */
+	table_name: string | null;
 	block_height: number | bigint;
 	tx_id: string | null;
 	row_pk: unknown;
@@ -874,6 +889,14 @@ interface SubscriptionDeliveriesTable {
 }
 type SubscriptionDelivery = Selectable<SubscriptionDeliveriesTable>;
 type InsertSubscriptionDelivery = Insertable<SubscriptionDeliveriesTable>;
+/** Single-row (id always TRUE) high-water mark for the chain-trigger evaluator.
+*  One loop serves all chain subscriptions, so the cursor is global. */
+interface TriggerEvaluatorStateTable {
+	id: Generated<boolean>;
+	last_processed_block: ColumnType<bigint, bigint | number | undefined, bigint | number>;
+	updated_at: Generated<Date>;
+}
+type TriggerEvaluatorState = Selectable<TriggerEvaluatorStateTable>;
 interface EnvSchemaOutput {
 	DATABASE_URL?: string;
 	/**
@@ -1293,6 +1316,8 @@ declare const CreateSubscriptionRequestSchema: z4.ZodType<ParsedCreateSubscripti
 declare const UpdateSubscriptionRequestSchema: z4.ZodType<UpdateSubscriptionRequest>;
 declare const ReplaySubscriptionRequestSchema: z4.ZodType<ReplaySubscriptionRequest>;
 type SubscriptionStatus2 = (typeof SUBSCRIPTION_STATUSES)[number];
+/** Polymorphic subscription mode (mirrors db/types `SubscriptionKind`). */
+type SubscriptionKind2 = "subgraph" | "chain";
 type SubscriptionFormat2 = (typeof SUBSCRIPTION_FORMATS)[number];
 type SubscriptionRuntime2 = (typeof SUBSCRIPTION_RUNTIMES)[number];
 type SubscriptionFilterPrimitive = string | number | boolean;
@@ -1313,12 +1338,82 @@ type SubscriptionFilterOperator = {
 };
 type SubscriptionFilterClause = SubscriptionFilterPrimitive | SubscriptionFilterOperator;
 type SubscriptionFilter = Record<string, SubscriptionFilterClause>;
+/** Non-negative integer amount over JSON (string for uint128 safety, or number). */
+type ChainTriggerAmount = string | number;
+interface TraitScoped {
+	trait?: string;
+}
+/** JSON mirror of the subgraph runtime's `SubgraphFilter` union. */
+type ChainTrigger = {
+	type: "stx_transfer"
+	sender?: string
+	recipient?: string
+	minAmount?: ChainTriggerAmount
+	maxAmount?: ChainTriggerAmount
+} | {
+	type: "stx_mint"
+	recipient?: string
+	minAmount?: ChainTriggerAmount
+} | {
+	type: "stx_burn"
+	sender?: string
+	minAmount?: ChainTriggerAmount
+} | {
+	type: "stx_lock"
+	lockedAddress?: string
+	minAmount?: ChainTriggerAmount
+} | ({
+	type: "ft_transfer"
+	assetIdentifier?: string
+	sender?: string
+	recipient?: string
+	minAmount?: ChainTriggerAmount
+} & TraitScoped) | ({
+	type: "ft_mint"
+	assetIdentifier?: string
+	recipient?: string
+	minAmount?: ChainTriggerAmount
+} & TraitScoped) | ({
+	type: "ft_burn"
+	assetIdentifier?: string
+	sender?: string
+	minAmount?: ChainTriggerAmount
+} & TraitScoped) | ({
+	type: "nft_transfer"
+	assetIdentifier?: string
+	sender?: string
+	recipient?: string
+} & TraitScoped) | ({
+	type: "nft_mint"
+	assetIdentifier?: string
+	recipient?: string
+} & TraitScoped) | ({
+	type: "nft_burn"
+	assetIdentifier?: string
+	sender?: string
+} & TraitScoped) | ({
+	type: "contract_call"
+	contractId?: string
+	functionName?: string
+	caller?: string
+} & TraitScoped) | {
+	type: "contract_deploy"
+	deployer?: string
+	contractName?: string
+} | ({
+	type: "print_event"
+	contractId?: string
+	topic?: string
+} & TraitScoped);
 interface CreateSubscriptionRequest {
 	name: string;
-	subgraphName: string;
-	tableName: string;
-	url: string;
+	/** Subgraph mode. */
+	subgraphName?: string;
+	tableName?: string;
 	filter?: SubscriptionFilter;
+	/** Chain mode. */
+	triggers?: ChainTrigger[];
+	url: string;
 	format?: SubscriptionFormat2;
 	runtime?: SubscriptionRuntime2 | null;
 	authConfig?: Record<string, unknown>;
@@ -1351,8 +1446,11 @@ interface SubscriptionSummary {
 	id: string;
 	name: string;
 	status: SubscriptionStatus2;
-	subgraphName: string;
-	tableName: string;
+	kind: SubscriptionKind2;
+	/** Null for chain subscriptions. */
+	subgraphName: string | null;
+	/** Null for chain subscriptions. */
+	tableName: string | null;
 	format: SubscriptionFormat2;
 	runtime: SubscriptionRuntime2 | null;
 	url: string;
@@ -1363,6 +1461,8 @@ interface SubscriptionSummary {
 }
 interface SubscriptionDetail extends SubscriptionSummary {
 	filter: Record<string, unknown>;
+	/** Chain-trigger filters (chain subscriptions only). */
+	triggers: ChainTrigger[] | null;
 	authConfig: Record<string, unknown>;
 	maxRetries: number;
 	timeoutMs: number;
@@ -1558,4 +1658,4 @@ declare function publicKeyPemFromPrivate(privateKeyPem: string): string;
 declare function ed25519KeyId(publicKeyPem: string): string;
 declare function signEd25519(payload: string, privateKey: KeyObject): string;
 declare function verifyEd25519(payload: string, signatureBase64: string, publicKey: KeyObject): boolean;
-export { validateSubscriptionFilterForTable, sql, parseJsonb, logger, jsonb, getTargetDb, getSourceDb, getRawClientFor, getRawClient, getErrorMessage, getEnv, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, finalizedBurnHeight, encodeStreamsCursor, exports_ed25519 as ed25519, decodeStreamsCursor, exports_hmac as crypto, closeDb, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateChatSession, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, TransactionsTable, TransactionsArchiveTable, 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, SubgraphResourceWarning, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, StreamsCursor, SessionsTable, Session, ServiceHeartbeatsTable, SecondLayerError, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcEventsTable, SbtcEventTopic, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, PrintEventFilterSchema, PrintEventFilter, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, L2DecoderCheckpointsTable, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertChatSession, InsertChatMessage, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventsArchiveTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, EMPTY_RANGE_EVENT_INDEX_SENTINEL, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DecodedEventsTable, DeadRow, DeadLetterEventsTable, DatabaseError, Database, DEFAULT_BTC_CONFIRMATIONS, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractsTable, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, Contract, ChatSessionsTable, ChatSession, ChatMessagesTable, ChatMessage, ChainReorgsTable, CODE_TO_STATUS, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountAgentRunsTable, AccountAgentRun, Account };
+export { validateSubscriptionFilterForTable, sql, parseJsonb, logger, jsonb, getTargetDb, getSourceDb, getRawClientFor, getRawClient, getErrorMessage, getEnv, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, finalizedBurnHeight, encodeStreamsCursor, exports_ed25519 as ed25519, decodeStreamsCursor, exports_hmac as crypto, closeDb, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateChatSession, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphSpecOptions, SubgraphSpecFormat, SubgraphResourceWarning, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, StreamsCursor, SessionsTable, Session, ServiceHeartbeatsTable, SecondLayerError, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcEventsTable, SbtcEventTopic, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, PrintEventFilterSchema, PrintEventFilter, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, L2DecoderCheckpointsTable, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertChatSession, InsertChatMessage, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventsArchiveTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, EMPTY_RANGE_EVENT_INDEX_SENTINEL, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DecodedEventsTable, DeadRow, DeadLetterEventsTable, DatabaseError, Database, DEFAULT_BTC_CONFIRMATIONS, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractsTable, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, Contract, ChatSessionsTable, ChatSession, ChatMessagesTable, ChatMessage, ChainReorgsTable, CODE_TO_STATUS, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountAgentRunsTable, AccountAgentRun, Account };

package/dist/src/index.js

@@ -542,18 +542,137 @@ var SubscriptionFilterClauseSchema = z4.union([
   SubscriptionFilterOperatorSchema
 ]);
 var SubscriptionFilterSchema = z4.record(z4.string().min(1), SubscriptionFilterClauseSchema);
+var CHAIN_TRIGGER_TYPES = [
+  "stx_transfer",
+  "stx_mint",
+  "stx_burn",
+  "stx_lock",
+  "ft_transfer",
+  "ft_mint",
+  "ft_burn",
+  "nft_transfer",
+  "nft_mint",
+  "nft_burn",
+  "contract_call",
+  "contract_deploy",
+  "print_event"
+];
+var triggerAmount = z4.union([
+  z4.string().trim().regex(/^\d+$/, "must be a non-negative integer string"),
+  z4.number().int().nonnegative()
+]);
+var triggerPattern = z4.string().trim().min(1);
+var trait = z4.string().trim().min(1);
+var ChainTriggerSchema = z4.discriminatedUnion("type", [
+  z4.object({
+    type: z4.literal("stx_transfer"),
+    sender: triggerPattern.optional(),
+    recipient: triggerPattern.optional(),
+    minAmount: triggerAmount.optional(),
+    maxAmount: triggerAmount.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("stx_mint"),
+    recipient: triggerPattern.optional(),
+    minAmount: triggerAmount.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("stx_burn"),
+    sender: triggerPattern.optional(),
+    minAmount: triggerAmount.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("stx_lock"),
+    lockedAddress: triggerPattern.optional(),
+    minAmount: triggerAmount.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("ft_transfer"),
+    assetIdentifier: triggerPattern.optional(),
+    sender: triggerPattern.optional(),
+    recipient: triggerPattern.optional(),
+    minAmount: triggerAmount.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("ft_mint"),
+    assetIdentifier: triggerPattern.optional(),
+    recipient: triggerPattern.optional(),
+    minAmount: triggerAmount.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("ft_burn"),
+    assetIdentifier: triggerPattern.optional(),
+    sender: triggerPattern.optional(),
+    minAmount: triggerAmount.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("nft_transfer"),
+    assetIdentifier: triggerPattern.optional(),
+    sender: triggerPattern.optional(),
+    recipient: triggerPattern.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("nft_mint"),
+    assetIdentifier: triggerPattern.optional(),
+    recipient: triggerPattern.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("nft_burn"),
+    assetIdentifier: triggerPattern.optional(),
+    sender: triggerPattern.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("contract_call"),
+    contractId: triggerPattern.optional(),
+    functionName: triggerPattern.optional(),
+    caller: triggerPattern.optional(),
+    trait: trait.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("contract_deploy"),
+    deployer: triggerPattern.optional(),
+    contractName: triggerPattern.optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("print_event"),
+    contractId: triggerPattern.optional(),
+    topic: triggerPattern.optional(),
+    trait: trait.optional()
+  }).strict()
+]);
+var ChainTriggersSchema = z4.array(ChainTriggerSchema).min(1).max(50);
 var CreateSubscriptionRequestSchema = z4.object({
   name,
-  subgraphName: resourceName,
-  tableName: resourceName,
-  url: webhookUrl,
+  subgraphName: resourceName.optional(),
+  tableName: resourceName.optional(),
   filter: SubscriptionFilterSchema.optional(),
+  triggers: ChainTriggersSchema.optional(),
+  url: webhookUrl,
   format: SubscriptionFormatSchema.default("standard-webhooks"),
   runtime: SubscriptionRuntimeSchema.nullable().optional(),
   authConfig: z4.record(z4.string(), z4.unknown()).optional(),
   maxRetries: z4.number().int().min(0).max(100).optional(),
   timeoutMs: z4.number().int().min(100).max(300000).optional(),
   concurrency: z4.number().int().min(1).max(100).optional()
+}).refine((v) => {
+  const subgraphMode = v.subgraphName !== undefined || v.tableName !== undefined;
+  const chainMode = v.triggers !== undefined;
+  if (chainMode && subgraphMode)
+    return false;
+  if (chainMode)
+    return true;
+  return v.subgraphName !== undefined && v.tableName !== undefined;
+}, {
+  message: "provide either { subgraphName, tableName } for a subgraph subscription OR { triggers } for a chain subscription — not both"
+}).refine((v) => v.filter === undefined || v.triggers === undefined, {
+  message: "`filter` applies to subgraph subscriptions; chain subscriptions use `triggers`",
+  path: ["filter"]
 });
 var UpdateSubscriptionRequestSchema = z4.object({
   name: name.optional(),
@@ -576,6 +695,60 @@ var ReplaySubscriptionRequestSchema = z4.object({
   message: "fromBlock must be less than or equal to toBlock",
   path: ["toBlock"]
 });
+var on = {
+  stxTransfer: (f = {}) => ({
+    type: "stx_transfer",
+    ...f
+  }),
+  stxMint: (f = {}) => ({
+    type: "stx_mint",
+    ...f
+  }),
+  stxBurn: (f = {}) => ({
+    type: "stx_burn",
+    ...f
+  }),
+  stxLock: (f = {}) => ({
+    type: "stx_lock",
+    ...f
+  }),
+  ftTransfer: (f = {}) => ({
+    type: "ft_transfer",
+    ...f
+  }),
+  ftMint: (f = {}) => ({
+    type: "ft_mint",
+    ...f
+  }),
+  ftBurn: (f = {}) => ({
+    type: "ft_burn",
+    ...f
+  }),
+  nftTransfer: (f = {}) => ({
+    type: "nft_transfer",
+    ...f
+  }),
+  nftMint: (f = {}) => ({
+    type: "nft_mint",
+    ...f
+  }),
+  nftBurn: (f = {}) => ({
+    type: "nft_burn",
+    ...f
+  }),
+  contractCall: (f = {}) => ({
+    type: "contract_call",
+    ...f
+  }),
+  contractDeploy: (f = {}) => ({
+    type: "contract_deploy",
+    ...f
+  }),
+  printEvent: (f = {}) => ({
+    type: "print_event",
+    ...f
+  })
+};
 var SCALAR_COLUMN_TYPES = new Set([
   "text",
   "uint",
@@ -1176,5 +1349,5 @@ export {
   AuthenticationError
 };
 
-//# debugId=51EF7A86676E2EB064756E2164756E21
+//# debugId=4BE5ABD7435A3A0E64756E2164756E21
 //# sourceMappingURL=index.js.map