@lunora/server 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Validator, Infer, ValidatorMap, InferValidatorMap, v } from '@lunora/values';
 export { type ColumnValidator, type Id, type Infer, ValidationError, type Validator, type ValidatorKind, v } from '@lunora/values';
-import { ArgsValidator, InferArgs, RegisteredAction, ActionCtx, MutationCtx, RegisteredMutation, QueryCtx, RegisteredQuery, RegisteredStream, FunctionKind, Secrets, LifecycleEvent, RegisteredLifecycleHook, TableDefinition, RegisteredFunction, VectorIndexDefinition, Schema, AggregateOp, DurableObjectJurisdiction, RelationDefinition, GlobalBackend, OnDeleteAction, ExternalSourceDefinition, TriggerBuilder, TriggerDefinition, VectorEmbedder, VectorMetric, AggregateIndexDefinition, RankIndexDefinition } from "./types.mjs";
+import { ArgsValidator, InferArgs, RegisteredAction, X402ProcedureConfig, ActionCtx, MutationCtx, RegisteredMutation, QueryCtx, RegisteredQuery, RegisteredStream, FunctionKind, Secrets, LifecycleEvent, RegisteredLifecycleHook, TableDefinition, RegisteredFunction, VectorIndexDefinition, Schema, AggregateOp, DurableObjectJurisdiction, RelationDefinition, GlobalBackend, OnDeleteAction, ExternalSourceDefinition, TriggerBuilder, TriggerDefinition, VectorEmbedder, VectorMetric, AggregateIndexDefinition, RankIndexDefinition } from "./types.mjs";
 export { type AnyApi, type AuthState, type CachePurge, type DatabaseReader, type DatabaseWriter, type FunctionVisibility, type IndexDefinition, type IndexRangeBuilder, type LifecycleEventKind, type LunoraLogger, type PaginationOptions, type PaginationResult, type RankSortKey, type ReadOnlyStorage, type ScheduledFunctionDoc, type ScheduledJob, type Scheduler, type SearchFilterBuilder, type SearchIndexDefinition, type ShardMode, type Storage, type StorageMetadata, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemTableName, type TableReader, type TableVectorIndex, type TriggerAggregateOptions, type TriggerCtx, type TriggerDatabase, type TriggerDeleteEvent, type TriggerEvent, type TriggerGroupByEntry, type TriggerGroupByOptions, type TriggerHandler, type TriggerInsertEvent, type TriggerOp, type TriggerQueryArgs, type TriggerQueryPage, type TriggerRankOptions, type TriggerRankPageOptions, type TriggerRankResult, type TriggerRow, type TriggerTiming, type TriggerUpdateEvent, type VectorMatch, type VectorMatches, type VectorQueryInput, type VectorRecord, type VectorSearch, type VectorSearchReader, type VectorUpsertInput, type WorkflowCreateOptions, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceStatus, type WorkflowStatusResult, type Workflows, anyApi } from "./types.mjs";
 import { LunoraError as LunoraError$1, LunoraErrorCode } from '@lunora/errors';
 export type { LunoraErrorCode } from '@lunora/errors';
@@ -85,6 +85,13 @@ interface QueryBuilder<Context, Args extends ArgsValidator, Output = undefined>
     signal: AbortSignal;
   }) => AsyncGenerator<R, void, void> | AsyncIterable<R>) => RegisteredStream<Args, R>;
   use: <ContextOut>(middleware: Middleware<Context, ContextOut>) => QueryBuilder<ContextOut, Args, Output>;
+  /**
+  * Mark this query as paid. The origin worker answers an unpaid client RPC
+  * with HTTP 402, verifies + settles the x402 payment, then dispatches. `price`
+  * is USD (a number of dollars or a `"0.01"`/`"$0.01"` string); the network,
+  * recipient, and facilitator come from the worker-level x402 charge config.
+  */
+  x402: (config: X402ProcedureConfig) => QueryBuilder<Context, Args, Output>;
 }
 interface MutationBuilder<Context, Args extends ArgsValidator, Output = undefined> {
   readonly __lunoraProcedure: "mutation";
@@ -98,6 +105,13 @@ interface MutationBuilder<Context, Args extends ArgsValidator, Output = undefine
   }) => Output | Promise<Output>) => RegisteredMutation<Args, Output>;
   output: <V extends Validator>(validator: V) => MutationBuilder<Context, Args, Infer<V>>;
   use: <ContextOut>(middleware: Middleware<Context, ContextOut>) => MutationBuilder<ContextOut, Args, Output>;
+  /**
+  * Mark this mutation as paid. The origin worker answers an unpaid client RPC
+  * with HTTP 402, verifies + settles the x402 payment, then dispatches. `price`
+  * is USD (a number of dollars or a `"0.01"`/`"$0.01"` string); the network,
+  * recipient, and facilitator come from the worker-level x402 charge config.
+  */
+  x402: (config: X402ProcedureConfig) => MutationBuilder<Context, Args, Output>;
 }
 interface ActionBuilder<Context, Args extends ArgsValidator, Output = undefined> {
   readonly __lunoraProcedure: "action";
@@ -111,6 +125,13 @@ interface ActionBuilder<Context, Args extends ArgsValidator, Output = undefined>
   input: <A extends ArgsValidator>(validators: A) => ActionBuilder<Context, A & Args, Output>;
   output: <V extends Validator>(validator: V) => ActionBuilder<Context, Args, Infer<V>>;
   use: <ContextOut>(middleware: Middleware<Context, ContextOut>) => ActionBuilder<ContextOut, Args, Output>;
+  /**
+  * Mark this action as paid. The origin worker answers an unpaid client RPC
+  * with HTTP 402, verifies + settles the x402 payment, then dispatches. `price`
+  * is USD (a number of dollars or a `"0.01"`/`"$0.01"` string); the network,
+  * recipient, and facilitator come from the worker-level x402 charge config.
+  */
+  x402: (config: X402ProcedureConfig) => ActionBuilder<Context, Args, Output>;
 }
 /**
 * Internal builder variants. Identical to their public counterparts but carry
@@ -842,12 +863,14 @@ interface QueryArgs$1 {
   baseWhere?: unknown;
   cursor?: null | string;
   limit?: number;
+  orderBy?: ReadonlyArray<Record<string, unknown>>;
   where?: unknown;
   with?: Record<string, unknown>;
 }
 interface AggregateArgs$1 {
   field?: string;
   op: string;
+  where?: unknown;
 }
 interface GroupByArgs$1 {
   agg?: {
@@ -855,6 +878,7 @@ interface GroupByArgs$1 {
     op: string;
   };
   by: ReadonlyArray<string>;
+  where?: unknown;
 }
 interface TableReaderLike$1 {
   collect: () => Promise<Record<string, unknown>[]>;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Validator, Infer, ValidatorMap, InferValidatorMap, v } from '@lunora/values';
 export { type ColumnValidator, type Id, type Infer, ValidationError, type Validator, type ValidatorKind, v } from '@lunora/values';
-import { ArgsValidator, InferArgs, RegisteredAction, ActionCtx, MutationCtx, RegisteredMutation, QueryCtx, RegisteredQuery, RegisteredStream, FunctionKind, Secrets, LifecycleEvent, RegisteredLifecycleHook, TableDefinition, RegisteredFunction, VectorIndexDefinition, Schema, AggregateOp, DurableObjectJurisdiction, RelationDefinition, GlobalBackend, OnDeleteAction, ExternalSourceDefinition, TriggerBuilder, TriggerDefinition, VectorEmbedder, VectorMetric, AggregateIndexDefinition, RankIndexDefinition } from "./types.js";
+import { ArgsValidator, InferArgs, RegisteredAction, X402ProcedureConfig, ActionCtx, MutationCtx, RegisteredMutation, QueryCtx, RegisteredQuery, RegisteredStream, FunctionKind, Secrets, LifecycleEvent, RegisteredLifecycleHook, TableDefinition, RegisteredFunction, VectorIndexDefinition, Schema, AggregateOp, DurableObjectJurisdiction, RelationDefinition, GlobalBackend, OnDeleteAction, ExternalSourceDefinition, TriggerBuilder, TriggerDefinition, VectorEmbedder, VectorMetric, AggregateIndexDefinition, RankIndexDefinition } from "./types.js";
 export { type AnyApi, type AuthState, type CachePurge, type DatabaseReader, type DatabaseWriter, type FunctionVisibility, type IndexDefinition, type IndexRangeBuilder, type LifecycleEventKind, type LunoraLogger, type PaginationOptions, type PaginationResult, type RankSortKey, type ReadOnlyStorage, type ScheduledFunctionDoc, type ScheduledJob, type Scheduler, type SearchFilterBuilder, type SearchIndexDefinition, type ShardMode, type Storage, type StorageMetadata, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemTableName, type TableReader, type TableVectorIndex, type TriggerAggregateOptions, type TriggerCtx, type TriggerDatabase, type TriggerDeleteEvent, type TriggerEvent, type TriggerGroupByEntry, type TriggerGroupByOptions, type TriggerHandler, type TriggerInsertEvent, type TriggerOp, type TriggerQueryArgs, type TriggerQueryPage, type TriggerRankOptions, type TriggerRankPageOptions, type TriggerRankResult, type TriggerRow, type TriggerTiming, type TriggerUpdateEvent, type VectorMatch, type VectorMatches, type VectorQueryInput, type VectorRecord, type VectorSearch, type VectorSearchReader, type VectorUpsertInput, type WorkflowCreateOptions, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceStatus, type WorkflowStatusResult, type Workflows, anyApi } from "./types.js";
 import { LunoraError as LunoraError$1, LunoraErrorCode } from '@lunora/errors';
 export type { LunoraErrorCode } from '@lunora/errors';
@@ -85,6 +85,13 @@ interface QueryBuilder<Context, Args extends ArgsValidator, Output = undefined>
     signal: AbortSignal;
   }) => AsyncGenerator<R, void, void> | AsyncIterable<R>) => RegisteredStream<Args, R>;
   use: <ContextOut>(middleware: Middleware<Context, ContextOut>) => QueryBuilder<ContextOut, Args, Output>;
+  /**
+  * Mark this query as paid. The origin worker answers an unpaid client RPC
+  * with HTTP 402, verifies + settles the x402 payment, then dispatches. `price`
+  * is USD (a number of dollars or a `"0.01"`/`"$0.01"` string); the network,
+  * recipient, and facilitator come from the worker-level x402 charge config.
+  */
+  x402: (config: X402ProcedureConfig) => QueryBuilder<Context, Args, Output>;
 }
 interface MutationBuilder<Context, Args extends ArgsValidator, Output = undefined> {
   readonly __lunoraProcedure: "mutation";
@@ -98,6 +105,13 @@ interface MutationBuilder<Context, Args extends ArgsValidator, Output = undefine
   }) => Output | Promise<Output>) => RegisteredMutation<Args, Output>;
   output: <V extends Validator>(validator: V) => MutationBuilder<Context, Args, Infer<V>>;
   use: <ContextOut>(middleware: Middleware<Context, ContextOut>) => MutationBuilder<ContextOut, Args, Output>;
+  /**
+  * Mark this mutation as paid. The origin worker answers an unpaid client RPC
+  * with HTTP 402, verifies + settles the x402 payment, then dispatches. `price`
+  * is USD (a number of dollars or a `"0.01"`/`"$0.01"` string); the network,
+  * recipient, and facilitator come from the worker-level x402 charge config.
+  */
+  x402: (config: X402ProcedureConfig) => MutationBuilder<Context, Args, Output>;
 }
 interface ActionBuilder<Context, Args extends ArgsValidator, Output = undefined> {
   readonly __lunoraProcedure: "action";
@@ -111,6 +125,13 @@ interface ActionBuilder<Context, Args extends ArgsValidator, Output = undefined>
   input: <A extends ArgsValidator>(validators: A) => ActionBuilder<Context, A & Args, Output>;
   output: <V extends Validator>(validator: V) => ActionBuilder<Context, Args, Infer<V>>;
   use: <ContextOut>(middleware: Middleware<Context, ContextOut>) => ActionBuilder<ContextOut, Args, Output>;
+  /**
+  * Mark this action as paid. The origin worker answers an unpaid client RPC
+  * with HTTP 402, verifies + settles the x402 payment, then dispatches. `price`
+  * is USD (a number of dollars or a `"0.01"`/`"$0.01"` string); the network,
+  * recipient, and facilitator come from the worker-level x402 charge config.
+  */
+  x402: (config: X402ProcedureConfig) => ActionBuilder<Context, Args, Output>;
 }
 /**
 * Internal builder variants. Identical to their public counterparts but carry
@@ -842,12 +863,14 @@ interface QueryArgs$1 {
   baseWhere?: unknown;
   cursor?: null | string;
   limit?: number;
+  orderBy?: ReadonlyArray<Record<string, unknown>>;
   where?: unknown;
   with?: Record<string, unknown>;
 }
 interface AggregateArgs$1 {
   field?: string;
   op: string;
+  where?: unknown;
 }
 interface GroupByArgs$1 {
   agg?: {
@@ -855,6 +878,7 @@ interface GroupByArgs$1 {
     op: string;
   };
   by: ReadonlyArray<string>;
+  where?: unknown;
 }
 interface TableReaderLike$1 {
   collect: () => Promise<Record<string, unknown>[]>;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { default as asBucketStorage } from './packem_shared/asBucketStorage-Cnxd9y2q.mjs';
-export { initLunora } from './packem_shared/initLunora-sQUqaejx.mjs';
+export { initLunora } from './packem_shared/initLunora-CmMVk4i7.mjs';
 export { createSecrets } from './packem_shared/createSecrets-DwaR2rNG.mjs';
 export { LunoraEnvError, defineEnv, redactSecrets } from './packem_shared/LunoraEnvError-BGmd1Qs0.mjs';
 export { LunoraError } from './packem_shared/LunoraError-WbxmrpxR.mjs';
@@ -10,7 +10,7 @@ export { onConnect, onDisconnect } from './packem_shared/onConnect-CIPXKPyw.mjs'
 export { defineMigration } from './packem_shared/defineMigration-Hx01yIht.mjs';
 export { defineMutator } from './packem_shared/defineMutator-EIXAWhs9.mjs';
 export { composePluginMiddleware, defineComponent, definePlugin, defineSchemaExtension, installPlugins, mergeSchemaExtension } from './packem_shared/composePluginMiddleware-CcTj1_v2.mjs';
-export { PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, definePresence, presenceExtension } from './packem_shared/PRESENCE_DEFAULT_TTL_MS-BtPCiNLW.mjs';
+export { PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, definePresence, presenceExtension } from './packem_shared/PRESENCE_DEFAULT_TTL_MS-BAD0QPAg.mjs';
 export { protectPublic } from './packem_shared/protectPublic-BlcGpiRc.mjs';
 export { defineAggregateIndex, defineRankIndex, defineSchema, defineTable, defineVectorIndex } from './packem_shared/defineAggregateIndex-znq4ygKQ.mjs';
 export { defineShape } from './packem_shared/defineShape-C5scNOrf.mjs';
@@ -20,7 +20,7 @@ export { ValidationError, v } from '@lunora/values';
 export { buildRlsReadRegistry, composeShapeReadWhere } from './packem_shared/buildRlsReadRegistry-D54vUQe4.mjs';
 export { createPolicyDsl, definePermission, definePolicies, definePolicy, defineRole } from './packem_shared/createPolicyDsl-By3QB4he.mjs';
 export { defineStorageRule, defineStorageRules } from './packem_shared/defineStorageRule-B5nL4Z1P.mjs';
-export { mask } from './packem_shared/mask-BT1YgRbF.mjs';
+export { mask } from './packem_shared/mask-DSBtA3qp.mjs';
 export { rls } from './packem_shared/rls-B_ZWgslr.mjs';
 export { storageRules } from './packem_shared/storageRules-6QxzDOcx.mjs';
 

package/dist/packem_shared/{PRESENCE_DEFAULT_TTL_MS-BtPCiNLW.mjs → PRESENCE_DEFAULT_TTL_MS-BAD0QPAg.mjs}

@@ -1,5 +1,5 @@
 import { v } from '@lunora/values';
-import { initLunora } from './initLunora-sQUqaejx.mjs';
+import { initLunora } from './initLunora-CmMVk4i7.mjs';
 import { LunoraError } from './LunoraError-WbxmrpxR.mjs';
 import { onDisconnect } from './onConnect-CIPXKPyw.mjs';
 import { defineSchemaExtension, defineComponent } from './composePluginMiddleware-CcTj1_v2.mjs';
@@ -32,7 +32,7 @@ const definePresence = (options = {}) => {
   }).mutation(async ({ args, ctx: context }) => {
     const lastSeen = Date.now();
     const userId = context.auth.userId ?? void 0;
-    if (args.data !== void 0 && JSON.stringify(args.data).length > MAX_DATA_BYTES) {
+    if (args.data !== void 0 && new TextEncoder().encode(JSON.stringify(args.data)).length > MAX_DATA_BYTES) {
       throw new LunoraError("BAD_REQUEST", `presence data exceeds the ${String(MAX_DATA_BYTES)}-byte limit`);
     }
     const existing = await context.db.query(PRESENCE_TABLE).withIndex("byRoomSession", (q) => q.eq("roomId", args.roomId).eq("sessionId", args.sessionId)).first();

package/dist/packem_shared/{initLunora-sQUqaejx.mjs → initLunora-CmMVk4i7.mjs}

@@ -57,7 +57,8 @@ const makeBuilder = (kind, state, visibility) => {
         handler: makeHandler(state.args, state.middlewares, userHandler, state.output),
         kind,
         ...rls ? { rls } : {},
-        ...visibility ? { visibility } : {}
+        ...visibility ? { visibility } : {},
+        ...state.x402 ? { x402: state.x402 } : {}
       };
     },
     output: (validator) => makeBuilder(kind, { ...state, output: validator }, visibility),
@@ -73,11 +74,17 @@ const makeBuilder = (kind, state, visibility) => {
           handler: makeStreamHandler(state.args, state.middlewares, userHandler),
           kind: "stream",
           ...rls ? { rls } : {},
-          ...visibility ? { visibility } : {}
+          ...visibility ? { visibility } : {},
+          ...state.x402 ? { x402: state.x402 } : {}
         };
       }
     } : {},
-    use: (middleware) => makeBuilder(kind, { ...state, middlewares: [...state.middlewares, middleware] }, visibility)
+    use: (middleware) => makeBuilder(kind, { ...state, middlewares: [...state.middlewares, middleware] }, visibility),
+    // `.x402({ price })` marks a public procedure as paid. It's public-only:
+    // internal functions are server-to-server (cron/scheduler/`ctx.run*`) and
+    // never reachable via a client RPC, so there's nothing to charge. Omitting
+    // it on internal builders keeps the runtime shape aligned with the types.
+    ...visibility ? {} : { x402: (config) => makeBuilder(kind, { ...state, x402: config }, visibility) }
   };
 };
 const initLunora = {

package/dist/packem_shared/{mask-BT1YgRbF.mjs → mask-DSBtA3qp.mjs}

@@ -191,32 +191,54 @@ const wrapDatabase = (base, perTable, context) => {
       }
     }
   };
+  const assertOrderByAllowed = (tableName, orderBy, method) => {
+    const columns = perTable.get(tableName);
+    if (!columns || !Array.isArray(orderBy)) {
+      return;
+    }
+    for (const entry of orderBy) {
+      if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+        for (const field of Object.keys(entry)) {
+          if (field in columns) {
+            throw new LunoraError("MASK_UNSUPPORTED", `${method}() ordering "${tableName}" by masked column "${field}" is not supported`);
+          }
+        }
+      }
+    }
+  };
   const wrapped = {
     ...base,
     aggregate(tableName, options) {
       assertReductionAllowed(tableName, [options.field], "aggregate");
+      assertWhereAllowed(tableName, options.where, "aggregate");
       return base.aggregate(tableName, options);
     },
     count(tableName, whereOrArgs) {
       const wrapper = whereOrArgs && typeof whereOrArgs === "object" && !Array.isArray(whereOrArgs) ? whereOrArgs : void 0;
       const where = wrapper && ("where" in wrapper || "baseWhere" in wrapper || "restrictsCounts" in wrapper) ? wrapper.where : whereOrArgs;
       assertWhereAllowed(tableName, where, "count");
+      if (wrapper) {
+        assertWhereAllowed(tableName, wrapper.baseWhere, "count");
+      }
       return base.count(tableName, whereOrArgs);
     },
     async findFirst(tableName, args) {
       assertWhereAllowed(tableName, args?.where, "findFirst");
+      assertOrderByAllowed(tableName, args?.orderBy, "findFirst");
       const row = await base.findFirst(tableName, args);
       const columns = perTable.get(tableName);
       return row && columns ? maskRow(row, columns, context) : row;
     },
     async findFirstOrThrow(tableName, args) {
       assertWhereAllowed(tableName, args?.where, "findFirstOrThrow");
+      assertOrderByAllowed(tableName, args?.orderBy, "findFirstOrThrow");
       const row = await base.findFirstOrThrow(tableName, args);
       const columns = perTable.get(tableName);
       return columns ? maskRow(row, columns, context) : row;
     },
     async findMany(tableName, args) {
       assertWhereAllowed(tableName, args?.where, "findMany");
+      assertOrderByAllowed(tableName, args?.orderBy, "findMany");
       const page = await base.findMany(tableName, args);
       const columns = perTable.get(tableName);
       return columns ? maskPage(page, columns, context) : page;
@@ -231,6 +253,7 @@ const wrapDatabase = (base, perTable, context) => {
     },
     groupBy(tableName, options) {
       assertReductionAllowed(tableName, [...options.by, options.agg?.field], "groupBy");
+      assertWhereAllowed(tableName, options.where, "groupBy");
       return base.groupBy(tableName, options);
     },
     query(tableName) {

package/dist/types.d.mts

@@ -284,6 +284,22 @@ type FunctionKind = "action" | "mutation" | "query" | "stream";
 * back-compat with functions registered before visibility existed.
 */
 type FunctionVisibility = "internal" | "public";
+/**
+* x402 payment tag attached by the `.x402({ price })` builder modifier. Marks a
+* public procedure as paid: the origin worker answers an unpaid client RPC with
+* HTTP 402, verifies + settles the payment, and only then dispatches to the
+* shard. The runtime reads only `price` from here — the network, recipient, and
+* facilitator live in the worker-level x402 charge config, so `@lunora/runtime`
+* never has to import `@lunora/x402` (and its viem/solana deps).
+*/
+interface X402ProcedureConfig {
+  /**
+  * USD-denominated price: a number of dollars (`0.01`) or a decimal string
+  * (`"0.01"`, or the `"$0.01"` shorthand). Resolved to the network
+  * stablecoin's base units (USDC has 6 decimals) at challenge time.
+  */
+  readonly price: number | string;
+}
 interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKind> {
   readonly args: A;
   readonly handler: (context: unknown, args: InferArgs<A>) => Promise<R> | R;
@@ -296,6 +312,12 @@ interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKi
   */
   readonly lifecycle?: LifecycleEventKind;
   readonly visibility?: FunctionVisibility;
+  /**
+  * Set by the `.x402({ price })` builder modifier. Marks the procedure as paid
+  * so the origin worker gates it behind an x402 402-challenge before dispatch.
+  * Absent on unpaid functions.
+  */
+  readonly x402?: X402ProcedureConfig;
 }
 type RegisteredQuery<A extends ArgsValidator, R> = RegisteredFunction<A, R, "query">;
 type RegisteredMutation<A extends ArgsValidator, R> = RegisteredFunction<A, R, "mutation">;
@@ -1249,4 +1271,4 @@ interface ActionCtx {
 */
 type AnyApi = Record<string, Record<string, RegisteredFunction<ArgsValidator, unknown, FunctionKind>>>;
 declare const anyApi: AnyApi;
-export { type ActionCtx, type AggregateIndexDefinition, type AggregateOp, type AnyApi, type ArgsValidator, type AuthState, type CachePurge, type DatabaseReader, type DatabaseWriter, type DurableObjectJurisdiction, type ExternalSourceDefinition, type ExternalSourceMode, type ExternalSourceRefresh, type FunctionKind, type FunctionVisibility, type GlobalBackend, type IndexDefinition, type IndexRangeBuilder, type InferArgs, type LifecycleEvent, type LifecycleEventKind, type LunoraLogger, type MutationCtx, type OnDeleteAction, type PaginationOptions, type PaginationResult, type QueryCtx, type RankIndexDefinition, type RankSortKey, type ReadOnlyStorage, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMutation, type RegisteredQuery, type RegisteredStream, type RelationDefinition, type ScheduledFunctionDoc, type ScheduledJob, type Scheduler, type Schema, type SearchFilterBuilder, type SearchIndexDefinition, type Secrets, type SecretsStoreSecretLike, type ShardMode, type Storage, type StorageMetadata, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemTableName, type TableDefinition, type TableReader, type TableVectorIndex, type TriggerAggregateOptions, type TriggerBuilder, type TriggerCtx, type TriggerDatabase, type TriggerDefinition, type TriggerDeleteEvent, type TriggerEvent, type TriggerGroupByEntry, type TriggerGroupByOptions, type TriggerHandler, type TriggerInsertEvent, type TriggerOp, type TriggerQueryArgs, type TriggerQueryPage, type TriggerRankOptions, type TriggerRankPageOptions, type TriggerRankResult, type TriggerRow, type TriggerTiming, type TriggerUpdateEvent, type VectorEmbedder, type VectorIndexDefinition, type VectorMatch, type VectorMatches, type VectorMetric, type VectorQueryInput, type VectorRecord, type VectorSearch, type VectorSearchReader, type VectorUpsertInput, type WorkflowCreateOptions, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceStatus, type WorkflowStatusResult, type Workflows, anyApi };
+export { type ActionCtx, type AggregateIndexDefinition, type AggregateOp, type AnyApi, type ArgsValidator, type AuthState, type CachePurge, type DatabaseReader, type DatabaseWriter, type DurableObjectJurisdiction, type ExternalSourceDefinition, type ExternalSourceMode, type ExternalSourceRefresh, type FunctionKind, type FunctionVisibility, type GlobalBackend, type IndexDefinition, type IndexRangeBuilder, type InferArgs, type LifecycleEvent, type LifecycleEventKind, type LunoraLogger, type MutationCtx, type OnDeleteAction, type PaginationOptions, type PaginationResult, type QueryCtx, type RankIndexDefinition, type RankSortKey, type ReadOnlyStorage, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMutation, type RegisteredQuery, type RegisteredStream, type RelationDefinition, type ScheduledFunctionDoc, type ScheduledJob, type Scheduler, type Schema, type SearchFilterBuilder, type SearchIndexDefinition, type Secrets, type SecretsStoreSecretLike, type ShardMode, type Storage, type StorageMetadata, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemTableName, type TableDefinition, type TableReader, type TableVectorIndex, type TriggerAggregateOptions, type TriggerBuilder, type TriggerCtx, type TriggerDatabase, type TriggerDefinition, type TriggerDeleteEvent, type TriggerEvent, type TriggerGroupByEntry, type TriggerGroupByOptions, type TriggerHandler, type TriggerInsertEvent, type TriggerOp, type TriggerQueryArgs, type TriggerQueryPage, type TriggerRankOptions, type TriggerRankPageOptions, type TriggerRankResult, type TriggerRow, type TriggerTiming, type TriggerUpdateEvent, type VectorEmbedder, type VectorIndexDefinition, type VectorMatch, type VectorMatches, type VectorMetric, type VectorQueryInput, type VectorRecord, type VectorSearch, type VectorSearchReader, type VectorUpsertInput, type WorkflowCreateOptions, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceStatus, type WorkflowStatusResult, type Workflows, type X402ProcedureConfig, anyApi };

package/dist/types.d.ts

@@ -284,6 +284,22 @@ type FunctionKind = "action" | "mutation" | "query" | "stream";
 * back-compat with functions registered before visibility existed.
 */
 type FunctionVisibility = "internal" | "public";
+/**
+* x402 payment tag attached by the `.x402({ price })` builder modifier. Marks a
+* public procedure as paid: the origin worker answers an unpaid client RPC with
+* HTTP 402, verifies + settles the payment, and only then dispatches to the
+* shard. The runtime reads only `price` from here — the network, recipient, and
+* facilitator live in the worker-level x402 charge config, so `@lunora/runtime`
+* never has to import `@lunora/x402` (and its viem/solana deps).
+*/
+interface X402ProcedureConfig {
+  /**
+  * USD-denominated price: a number of dollars (`0.01`) or a decimal string
+  * (`"0.01"`, or the `"$0.01"` shorthand). Resolved to the network
+  * stablecoin's base units (USDC has 6 decimals) at challenge time.
+  */
+  readonly price: number | string;
+}
 interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKind> {
   readonly args: A;
   readonly handler: (context: unknown, args: InferArgs<A>) => Promise<R> | R;
@@ -296,6 +312,12 @@ interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKi
   */
   readonly lifecycle?: LifecycleEventKind;
   readonly visibility?: FunctionVisibility;
+  /**
+  * Set by the `.x402({ price })` builder modifier. Marks the procedure as paid
+  * so the origin worker gates it behind an x402 402-challenge before dispatch.
+  * Absent on unpaid functions.
+  */
+  readonly x402?: X402ProcedureConfig;
 }
 type RegisteredQuery<A extends ArgsValidator, R> = RegisteredFunction<A, R, "query">;
 type RegisteredMutation<A extends ArgsValidator, R> = RegisteredFunction<A, R, "mutation">;
@@ -1249,4 +1271,4 @@ interface ActionCtx {
 */
 type AnyApi = Record<string, Record<string, RegisteredFunction<ArgsValidator, unknown, FunctionKind>>>;
 declare const anyApi: AnyApi;
-export { type ActionCtx, type AggregateIndexDefinition, type AggregateOp, type AnyApi, type ArgsValidator, type AuthState, type CachePurge, type DatabaseReader, type DatabaseWriter, type DurableObjectJurisdiction, type ExternalSourceDefinition, type ExternalSourceMode, type ExternalSourceRefresh, type FunctionKind, type FunctionVisibility, type GlobalBackend, type IndexDefinition, type IndexRangeBuilder, type InferArgs, type LifecycleEvent, type LifecycleEventKind, type LunoraLogger, type MutationCtx, type OnDeleteAction, type PaginationOptions, type PaginationResult, type QueryCtx, type RankIndexDefinition, type RankSortKey, type ReadOnlyStorage, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMutation, type RegisteredQuery, type RegisteredStream, type RelationDefinition, type ScheduledFunctionDoc, type ScheduledJob, type Scheduler, type Schema, type SearchFilterBuilder, type SearchIndexDefinition, type Secrets, type SecretsStoreSecretLike, type ShardMode, type Storage, type StorageMetadata, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemTableName, type TableDefinition, type TableReader, type TableVectorIndex, type TriggerAggregateOptions, type TriggerBuilder, type TriggerCtx, type TriggerDatabase, type TriggerDefinition, type TriggerDeleteEvent, type TriggerEvent, type TriggerGroupByEntry, type TriggerGroupByOptions, type TriggerHandler, type TriggerInsertEvent, type TriggerOp, type TriggerQueryArgs, type TriggerQueryPage, type TriggerRankOptions, type TriggerRankPageOptions, type TriggerRankResult, type TriggerRow, type TriggerTiming, type TriggerUpdateEvent, type VectorEmbedder, type VectorIndexDefinition, type VectorMatch, type VectorMatches, type VectorMetric, type VectorQueryInput, type VectorRecord, type VectorSearch, type VectorSearchReader, type VectorUpsertInput, type WorkflowCreateOptions, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceStatus, type WorkflowStatusResult, type Workflows, anyApi };
+export { type ActionCtx, type AggregateIndexDefinition, type AggregateOp, type AnyApi, type ArgsValidator, type AuthState, type CachePurge, type DatabaseReader, type DatabaseWriter, type DurableObjectJurisdiction, type ExternalSourceDefinition, type ExternalSourceMode, type ExternalSourceRefresh, type FunctionKind, type FunctionVisibility, type GlobalBackend, type IndexDefinition, type IndexRangeBuilder, type InferArgs, type LifecycleEvent, type LifecycleEventKind, type LunoraLogger, type MutationCtx, type OnDeleteAction, type PaginationOptions, type PaginationResult, type QueryCtx, type RankIndexDefinition, type RankSortKey, type ReadOnlyStorage, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMutation, type RegisteredQuery, type RegisteredStream, type RelationDefinition, type ScheduledFunctionDoc, type ScheduledJob, type Scheduler, type Schema, type SearchFilterBuilder, type SearchIndexDefinition, type Secrets, type SecretsStoreSecretLike, type ShardMode, type Storage, type StorageMetadata, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemTableName, type TableDefinition, type TableReader, type TableVectorIndex, type TriggerAggregateOptions, type TriggerBuilder, type TriggerCtx, type TriggerDatabase, type TriggerDefinition, type TriggerDeleteEvent, type TriggerEvent, type TriggerGroupByEntry, type TriggerGroupByOptions, type TriggerHandler, type TriggerInsertEvent, type TriggerOp, type TriggerQueryArgs, type TriggerQueryPage, type TriggerRankOptions, type TriggerRankPageOptions, type TriggerRankResult, type TriggerRow, type TriggerTiming, type TriggerUpdateEvent, type VectorEmbedder, type VectorIndexDefinition, type VectorMatch, type VectorMatches, type VectorMetric, type VectorQueryInput, type VectorRecord, type VectorSearch, type VectorSearchReader, type VectorUpsertInput, type WorkflowCreateOptions, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceStatus, type WorkflowStatusResult, type Workflows, type X402ProcedureConfig, anyApi };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/server",
-  "version": "1.0.0-alpha.21",
+  "version": "1.0.0-alpha.23",
   "description": "Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action",
   "keywords": [
     "backend",
@@ -62,9 +62,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.3",
-    "@lunora/scheduler": "1.0.0-alpha.7",
-    "@lunora/values": "1.0.0-alpha.6",
+    "@lunora/errors": "1.0.0-alpha.4",
+    "@lunora/scheduler": "1.0.0-alpha.8",
+    "@lunora/values": "1.0.0-alpha.7",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.28"
   },