syncorejs 0.2.2 → 0.2.3

package/dist/_vendor/core/runtime/functions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"functions.mjs","names":[],"sources":["../../src/runtime/functions.ts"],"sourcesContent":["import {\n  ensureObjectValidator,\n  isValidator,\n  type Infer,\n  type Validator,\n  type ValidatorMap\n} from \"@syncore/schema\";\n\nexport type SyncoreFunctionKind = \"query\" | \"mutation\" | \"action\";\nexport type EmptyArgs = Record<never, never>;\n\n/**\n * A typed reference to a Syncore function.\n *\n * Most app code gets these references from the generated `api` object.\n */\nexport interface FunctionReference<\n  TKind extends SyncoreFunctionKind = SyncoreFunctionKind,\n  TArgs = EmptyArgs,\n  TResult = unknown\n> {\n  kind: TKind;\n  name: string;\n  readonly __args?: TArgs;\n  readonly __result?: TResult;\n}\n\nexport interface SyncoreFunctionDefinition<\n  TKind extends SyncoreFunctionKind,\n  TContext,\n  TArgs,\n  TResult\n> {\n  kind: TKind;\n  argsValidator: Validator<TArgs, TArgs, string>;\n  returnsValidator?: Validator<TResult, TResult, string>;\n  handler: (ctx: TContext, args: TArgs) => Promise<TResult> | TResult;\n}\n\nexport type FunctionArgs<TReference> =\n  TReference extends FunctionReference<\n    SyncoreFunctionKind,\n    infer TArgs,\n    unknown\n  >\n    ? TArgs\n    : never;\n\nexport type FunctionResult<TReference> =\n  TReference extends FunctionReference<\n    SyncoreFunctionKind,\n    unknown,\n    infer TResult\n  >\n    ? TResult\n    : never;\n\nexport type FunctionKindFromDefinition<TDefinition> = TDefinition extends {\n  kind: infer TKind;\n}\n  ? Extract<TKind, SyncoreFunctionKind>\n  : never;\n\nexport type FunctionArgsFromDefinition<TDefinition> = TDefinition extends {\n  argsValidator: Validator<infer TArgs, unknown, string>;\n}\n  ? TArgs\n  : never;\n\nexport type FunctionResultFromDefinition<TDefinition> = TDefinition extends {\n  returnsValidator?: Validator<infer TResult, unknown, string>;\n}\n  ? TResult\n  : never;\n\nexport type FunctionReferenceFor<TDefinition> =\n  FunctionKindFromDefinition<TDefinition> extends never\n    ? never\n    : FunctionReference<\n        FunctionKindFromDefinition<TDefinition>,\n        FunctionArgsFromDefinition<TDefinition>,\n        FunctionResultFromDefinition<TDefinition>\n      >;\n\nexport interface FunctionConfig<TContext, TArgs, TResult> {\n  args: Validator<TArgs, TArgs, string> | ValidatorMap;\n  returns?: Validator<TResult, TResult, string>;\n  handler: (ctx: TContext, args: TArgs) => Promise<TResult> | TResult;\n}\n\nexport type InferArgs<\n  TArgs extends Validator<unknown, unknown, string> | ValidatorMap\n> = TArgs extends Validator<unknown, unknown, string>\n    ? Infer<TArgs>\n    : TArgs extends ValidatorMap\n      ? {\n          [TKey in keyof TArgs]: Infer<TArgs[TKey]>;\n        }\n      : never;\n\nfunction createFunctionDefinition<\n  TKind extends SyncoreFunctionKind,\n  TContext,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap,\n  TResult\n>(\n  kind: TKind,\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<TKind, TContext, InferArgs<TArgsShape>, TResult> {\n  const argsValidator = isValidator(config.args)\n    ? (config.args as Validator<\n        InferArgs<TArgsShape>,\n        InferArgs<TArgsShape>,\n        string\n      >)\n    : (ensureObjectValidator(config.args as ValidatorMap) as unknown as Validator<\n        InferArgs<TArgsShape>,\n        InferArgs<TArgsShape>,\n        string\n      >);\n\n  return {\n    kind,\n    argsValidator,\n    ...(config.returns ? { returnsValidator: config.returns } : {}),\n    handler: config.handler\n  };\n}\n\n/**\n * Define a Syncore query.\n *\n * Queries can read local Syncore state and are available to clients.\n */\nexport function query<\n  TContext = unknown,\n  TValidator extends Validator<unknown, unknown, string> = Validator<\n    unknown,\n    unknown,\n    string\n  >,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, Infer<TValidator>, TResult> & {\n    args: TValidator;\n  }\n): SyncoreFunctionDefinition<\"query\", TContext, Infer<TValidator>, TResult>;\nexport function query<\n  TContext = unknown,\n  TArgsShape extends ValidatorMap = ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\"query\", TContext, InferArgs<TArgsShape>, TResult>;\nexport function query<\n  TContext = unknown,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap =\n    ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"query\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n> {\n  return createFunctionDefinition(\"query\", config);\n}\n\n/**\n * Define a Syncore mutation.\n *\n * Mutations can modify local Syncore state and are available to clients.\n */\nexport function mutation<\n  TContext = unknown,\n  TValidator extends Validator<unknown, unknown, string> = Validator<\n    unknown,\n    unknown,\n    string\n  >,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, Infer<TValidator>, TResult> & {\n    args: TValidator;\n  }\n): SyncoreFunctionDefinition<\"mutation\", TContext, Infer<TValidator>, TResult>;\nexport function mutation<\n  TContext = unknown,\n  TArgsShape extends ValidatorMap = ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"mutation\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n>;\nexport function mutation<\n  TContext = unknown,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap =\n    ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"mutation\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n> {\n  return createFunctionDefinition(\"mutation\", config);\n}\n\n/**\n * Define a Syncore action.\n *\n * Actions can run arbitrary JavaScript and may call other Syncore functions.\n */\nexport function action<\n  TContext = unknown,\n  TValidator extends Validator<unknown, unknown, string> = Validator<\n    unknown,\n    unknown,\n    string\n  >,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, Infer<TValidator>, TResult> & {\n    args: TValidator;\n  }\n): SyncoreFunctionDefinition<\"action\", TContext, Infer<TValidator>, TResult>;\nexport function action<\n  TContext = unknown,\n  TArgsShape extends ValidatorMap = ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"action\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n>;\nexport function action<\n  TContext = unknown,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap =\n    ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"action\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n> {\n  return createFunctionDefinition(\"action\", config);\n}\n\nexport interface RecurringIntervalSchedule {\n  type: \"interval\";\n  seconds?: number;\n  minutes?: number;\n  hours?: number;\n}\n\nexport interface RecurringDailySchedule {\n  type: \"daily\";\n  hour: number;\n  minute: number;\n  timezone?: string;\n}\n\nexport interface RecurringWeeklySchedule {\n  type: \"weekly\";\n  dayOfWeek:\n    | \"sunday\"\n    | \"monday\"\n    | \"tuesday\"\n    | \"wednesday\"\n    | \"thursday\"\n    | \"friday\"\n    | \"saturday\";\n  hour: number;\n  minute: number;\n  timezone?: string;\n}\n\nexport type RecurringSchedule =\n  | RecurringIntervalSchedule\n  | RecurringDailySchedule\n  | RecurringWeeklySchedule;\n\nexport type MisfirePolicy =\n  | { type: \"catch_up\" }\n  | { type: \"skip\" }\n  | { type: \"run_once_if_missed\" }\n  | { type: \"windowed\"; windowMs: number };\n\nexport interface RecurringJobDefinition {\n  name: string;\n  schedule: RecurringSchedule;\n  function: FunctionReference<\"mutation\" | \"action\">;\n  args: Record<string, unknown>;\n  misfirePolicy: MisfirePolicy;\n}\n\nexport class CronJobs {\n  readonly jobs: RecurringJobDefinition[] = [];\n\n  interval(\n    name: string,\n    schedule: Omit<RecurringIntervalSchedule, \"type\">,\n    functionReference: FunctionReference<\"mutation\" | \"action\">,\n    args: Record<string, unknown> = {},\n    misfirePolicy: MisfirePolicy = { type: \"catch_up\" }\n  ): this {\n    this.jobs.push({\n      name,\n      schedule: { type: \"interval\", ...schedule },\n      function: functionReference,\n      args,\n      misfirePolicy\n    });\n    return this;\n  }\n\n  daily(\n    name: string,\n    schedule: Omit<RecurringDailySchedule, \"type\">,\n    functionReference: FunctionReference<\"mutation\" | \"action\">,\n    args: Record<string, unknown> = {},\n    misfirePolicy: MisfirePolicy = { type: \"catch_up\" }\n  ): this {\n    this.jobs.push({\n      name,\n      schedule: { type: \"daily\", ...schedule },\n      function: functionReference,\n      args,\n      misfirePolicy\n    });\n    return this;\n  }\n\n  weekly(\n    name: string,\n    schedule: Omit<RecurringWeeklySchedule, \"type\">,\n    functionReference: FunctionReference<\"mutation\" | \"action\">,\n    args: Record<string, unknown> = {},\n    misfirePolicy: MisfirePolicy = { type: \"catch_up\" }\n  ): this {\n    this.jobs.push({\n      name,\n      schedule: { type: \"weekly\", ...schedule },\n      function: functionReference,\n      args,\n      misfirePolicy\n    });\n    return this;\n  }\n}\n\n/**\n * Create a recurring job registry for Syncore scheduler definitions.\n */\nexport function cronJobs(): CronJobs {\n  return new CronJobs();\n}\n"],"mappings":";;AAoGA,SAAS,yBAMP,MACA,QAG4E;AAa5E,QAAO;EACL;EACA,eAdoB,YAAY,OAAO,KAAK,GACzC,OAAO,OAKP,sBAAsB,OAAO,KAAqB;EASrD,GAAI,OAAO,UAAU,EAAE,kBAAkB,OAAO,SAAS,GAAG,EAAE;EAC9D,SAAS,OAAO;EACjB;;AA8BH,SAAgB,MAMd,QAQA;AACA,QAAO,yBAAyB,SAAS,OAAO;;AAmClD,SAAgB,SAMd,QAQA;AACA,QAAO,yBAAyB,YAAY,OAAO;;AAmCrD,SAAgB,OAMd,QAQA;AACA,QAAO,yBAAyB,UAAU,OAAO;;AAmDnD,IAAa,WAAb,MAAsB;CACpB,OAA0C,EAAE;CAE5C,SACE,MACA,UACA,mBACA,OAAgC,EAAE,EAClC,gBAA+B,EAAE,MAAM,YAAY,EAC7C;AACN,OAAK,KAAK,KAAK;GACb;GACA,UAAU;IAAE,MAAM;IAAY,GAAG;IAAU;GAC3C,UAAU;GACV;GACA;GACD,CAAC;AACF,SAAO;;CAGT,MACE,MACA,UACA,mBACA,OAAgC,EAAE,EAClC,gBAA+B,EAAE,MAAM,YAAY,EAC7C;AACN,OAAK,KAAK,KAAK;GACb;GACA,UAAU;IAAE,MAAM;IAAS,GAAG;IAAU;GACxC,UAAU;GACV;GACA;GACD,CAAC;AACF,SAAO;;CAGT,OACE,MACA,UACA,mBACA,OAAgC,EAAE,EAClC,gBAA+B,EAAE,MAAM,YAAY,EAC7C;AACN,OAAK,KAAK,KAAK;GACb;GACA,UAAU;IAAE,MAAM;IAAU,GAAG;IAAU;GACzC,UAAU;GACV;GACA;GACD,CAAC;AACF,SAAO;;;;;;AAOX,SAAgB,WAAqB;AACnC,QAAO,IAAI,UAAU"}
+{"version":3,"file":"functions.mjs","names":[],"sources":["../../src/runtime/functions.ts"],"sourcesContent":["import {\n  ensureObjectValidator,\n  isValidator,\n  type Infer,\n  type Validator,\n  type ValidatorMap\n} from \"@syncore/schema\";\n\n/**\n * Discriminates the three function kinds Syncore supports.\n *\n * - `\"query\"` — read-only handler that observes local state. Syncore re-runs it\n *   automatically whenever any table it read changes, keeping connected clients\n *   up to date without manual cache invalidation.\n * - `\"mutation\"` — transactional write handler. Runs inside a single SQLite\n *   transaction and automatically invalidates every query that read the tables it\n *   modified.\n * - `\"action\"` — arbitrary async handler that may call external services, invoke\n *   other Syncore functions, or schedule deferred work. Actions do not run inside\n *   a transaction and cannot directly write to the database — they must delegate\n *   writes to mutations.\n */\nexport type SyncoreFunctionKind = \"query\" | \"mutation\" | \"action\";\n\n/**\n * Convenience type representing a function that accepts no arguments.\n *\n * Used as the default `TArgs` for {@link FunctionReference} so that calling\n * `client.query(api.tasks.list)` without a second argument is type-safe.\n */\nexport type EmptyArgs = Record<never, never>;\n\n/**\n * A typed, serialisable handle to a registered Syncore function.\n *\n * `FunctionReference` objects are how you address Syncore functions across the\n * entire API surface: hooks, client calls, scheduler helpers, and `ctx.runQuery`\n * / `ctx.runMutation` inside other functions all accept them. They carry the\n * function's kind and its fully-inferred arg / result types at the type level,\n * but at runtime they hold only the function's string name, making them safe to\n * pass across IPC channels.\n *\n * In almost every case you get references from the auto-generated `api` object\n * rather than constructing them manually:\n *\n * ```ts\n * import { api } from \"../syncore/_generated/api\";\n *\n * // In a React component:\n * const tasks = useQuery(api.tasks.list);\n *\n * // Inside a mutation that calls another function:\n * const id = await ctx.runMutation(api.tasks.create, { title: \"Buy milk\" });\n *\n * // Scheduling deferred work:\n * await ctx.scheduler.runAfter(60_000, api.notifications.send, { userId });\n * ```\n *\n * When you need to type a parameter that accepts a function reference, derive\n * the correct type with {@link FunctionReferenceFor}.\n */\nexport interface FunctionReference<\n  TKind extends SyncoreFunctionKind = SyncoreFunctionKind,\n  TArgs = EmptyArgs,\n  TResult = unknown\n> {\n  kind: TKind;\n  name: string;\n  readonly __args?: TArgs;\n  readonly __result?: TResult;\n}\n\n/**\n * The full definition of a Syncore function as produced by {@link query},\n * {@link mutation}, or {@link action}.\n *\n * This is the value you export from files inside `syncore/functions/`. Syncore\n * stores it in the function registry and uses the validators at runtime to parse\n * incoming arguments and optionally validate return values.\n *\n * You rarely reference this type directly in application code — use\n * {@link FunctionReferenceFor} when you need a type-level handle, or the\n * generated `api` object for runtime usage.\n */\nexport interface SyncoreFunctionDefinition<\n  TKind extends SyncoreFunctionKind,\n  TContext,\n  TArgs,\n  TResult\n> {\n  kind: TKind;\n  argsValidator: Validator<TArgs, TArgs, string>;\n  returnsValidator?: Validator<TResult, TResult, string>;\n  handler: (ctx: TContext, args: TArgs) => Promise<TResult> | TResult;\n}\n\n/**\n * Extracts the argument type from a {@link FunctionReference}.\n *\n * Useful when writing generic helpers that accept a function reference and need\n * to type the corresponding arguments:\n *\n * ```ts\n * async function run<TRef extends FunctionReference<\"mutation\">>(\n *   ref: TRef,\n *   args: FunctionArgs<TRef>\n * ) { ... }\n * ```\n */\nexport type FunctionArgs<TReference> =\n  TReference extends FunctionReference<\n    SyncoreFunctionKind,\n    infer TArgs,\n    unknown\n  >\n    ? TArgs\n    : never;\n\n/**\n * Extracts the result type from a {@link FunctionReference}.\n *\n * ```ts\n * type TaskList = FunctionResult<typeof api.tasks.list>; // Task[]\n * ```\n */\nexport type FunctionResult<TReference> =\n  TReference extends FunctionReference<\n    SyncoreFunctionKind,\n    unknown,\n    infer TResult\n  >\n    ? TResult\n    : never;\n\n/**\n * Extracts the {@link SyncoreFunctionKind} from a function definition object.\n *\n * Used internally by {@link FunctionReferenceFor} and the code generator.\n */\nexport type FunctionKindFromDefinition<TDefinition> = TDefinition extends {\n  kind: infer TKind;\n}\n  ? Extract<TKind, SyncoreFunctionKind>\n  : never;\n\n/**\n * Extracts the validated argument type from a function definition object.\n *\n * Used internally by {@link FunctionReferenceFor} and the code generator.\n */\nexport type FunctionArgsFromDefinition<TDefinition> = TDefinition extends {\n  argsValidator: Validator<infer TArgs, unknown, string>;\n}\n  ? TArgs\n  : never;\n\n/**\n * Extracts the return type from a function definition object.\n *\n * Used internally by {@link FunctionReferenceFor} and the code generator.\n */\nexport type FunctionResultFromDefinition<TDefinition> = TDefinition extends {\n  returnsValidator?: Validator<infer TResult, unknown, string>;\n}\n  ? TResult\n  : never;\n\n/**\n * Derives a fully-typed {@link FunctionReference} from a function definition.\n *\n * Use this when you need a typed reference to a function you have imported\n * directly — for example when writing test helpers or custom wrappers:\n *\n * ```ts\n * import type { create } from \"../syncore/functions/tasks\";\n *\n * type CreateRef = FunctionReferenceFor<typeof create>;\n * // FunctionReference<\"mutation\", { title: string }, string>\n * ```\n *\n * The generated `api` object already exposes `FunctionReferenceFor`-derived\n * values for every exported function, so you rarely need this in application\n * code.\n */\nexport type FunctionReferenceFor<TDefinition> =\n  FunctionKindFromDefinition<TDefinition> extends never\n    ? never\n    : FunctionReference<\n        FunctionKindFromDefinition<TDefinition>,\n        FunctionArgsFromDefinition<TDefinition>,\n        FunctionResultFromDefinition<TDefinition>\n      >;\n\n/**\n * Configuration object accepted by {@link query}, {@link mutation}, and\n * {@link action}.\n *\n * @template TContext - The execution context injected by the runtime\n *   (`QueryCtx`, `MutationCtx`, or `ActionCtx`).\n * @template TArgs   - The validated argument shape after parsing.\n * @template TResult - The return type of the handler.\n */\nexport interface FunctionConfig<TContext, TArgs, TResult> {\n  /**\n   * Schema that validates and types the arguments this function accepts.\n   *\n   * You can pass either a single `Validator` or a plain object (\"validator map\")\n   * whose keys map to individual field validators — both forms are equivalent:\n   *\n   * ```ts\n   * // Validator map (most common)\n   * args: { title: s.string(), done: s.boolean() }\n   *\n   * // Single object validator (same result)\n   * args: s.object({ title: s.string(), done: s.boolean() })\n   * ```\n   */\n  args: Validator<TArgs, TArgs, string> | ValidatorMap;\n\n  /**\n   * Optional schema that validates the value returned by the handler.\n   *\n   * When provided, Syncore validates the return value before sending it to\n   * clients. Omitting `returns` disables return-value validation but does not\n   * affect the TypeScript return type inferred from the handler.\n   */\n  returns?: Validator<TResult, TResult, string>;\n\n  /**\n   * The function body. Receives a typed context object and the validated\n   * arguments and must return (or resolve to) the function's result.\n   */\n  handler: (ctx: TContext, args: TArgs) => Promise<TResult> | TResult;\n}\n\nexport type InferArgs<\n  TArgs extends Validator<unknown, unknown, string> | ValidatorMap\n> = TArgs extends Validator<unknown, unknown, string>\n    ? Infer<TArgs>\n    : TArgs extends ValidatorMap\n      ? {\n          [TKey in keyof TArgs]: Infer<TArgs[TKey]>;\n        }\n      : never;\n\nfunction createFunctionDefinition<\n  TKind extends SyncoreFunctionKind,\n  TContext,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap,\n  TResult\n>(\n  kind: TKind,\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<TKind, TContext, InferArgs<TArgsShape>, TResult> {\n  const argsValidator = isValidator(config.args)\n    ? (config.args as Validator<\n        InferArgs<TArgsShape>,\n        InferArgs<TArgsShape>,\n        string\n      >)\n    : (ensureObjectValidator(config.args as ValidatorMap) as unknown as Validator<\n        InferArgs<TArgsShape>,\n        InferArgs<TArgsShape>,\n        string\n      >);\n\n  return {\n    kind,\n    argsValidator,\n    ...(config.returns ? { returnsValidator: config.returns } : {}),\n    handler: config.handler\n  };\n}\n\n/**\n * Define a Syncore query.\n *\n * Queries are the read layer of Syncore. They run inside a read-only database\n * transaction, may call other queries via `ctx.runQuery`, and are\n * **automatically reactive**: whenever a table that a query read changes,\n * every active subscription to that query is invalidated and re-executed.\n *\n * Export one query per named export in a file under `syncore/functions/`.\n * After running `npx syncorejs codegen` a typed reference will be available\n * on the generated `api` object.\n *\n * ```ts\n * // syncore/functions/tasks.ts\n * import { query } from \"syncorejs\";\n * import { s } from \"syncorejs\";\n * import type { QueryCtx } from \"../_generated/server\";\n *\n * export const list = query({\n *   args: { projectId: s.optional(s.id(\"projects\")) },\n *   handler: async (ctx: QueryCtx, { projectId }) => {\n *     return ctx.db\n *       .query(\"tasks\")\n *       .withIndex(\"by_project\", (q) =>\n *         projectId ? q.eq(\"projectId\", projectId) : q\n *       )\n *       .collect();\n *   },\n * });\n * ```\n *\n * @param config - The {@link FunctionConfig} describing the args schema,\n *   optional return-value schema, and handler function.\n */\nexport function query<\n  TContext = unknown,\n  TValidator extends Validator<unknown, unknown, string> = Validator<\n    unknown,\n    unknown,\n    string\n  >,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, Infer<TValidator>, TResult> & {\n    args: TValidator;\n  }\n): SyncoreFunctionDefinition<\"query\", TContext, Infer<TValidator>, TResult>;\nexport function query<\n  TContext = unknown,\n  TArgsShape extends ValidatorMap = ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\"query\", TContext, InferArgs<TArgsShape>, TResult>;\nexport function query<\n  TContext = unknown,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap =\n    ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"query\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n> {\n  return createFunctionDefinition(\"query\", config);\n}\n\n/**\n * Define a Syncore mutation.\n *\n * Mutations are the write layer of Syncore. Every mutation runs inside an\n * **atomic SQLite transaction**: if the handler throws, all writes are rolled\n * back. After a successful commit Syncore automatically invalidates and\n * re-executes every active query whose read-set overlaps the changed tables.\n *\n * Mutations receive a {@link MutationCtx}, which extends the query context\n * with `ctx.db` write methods and a `ctx.scheduler` for scheduling deferred\n * work.\n *\n * ```ts\n * // syncore/functions/tasks.ts\n * import { mutation } from \"syncorejs\";\n * import { s } from \"syncorejs\";\n * import type { MutationCtx } from \"../_generated/server\";\n *\n * export const create = mutation({\n *   args: { title: s.string() },\n *   returns: s.id(\"tasks\"),\n *   handler: async (ctx: MutationCtx, { title }) => {\n *     return ctx.db.insert(\"tasks\", {\n *       title,\n *       status: \"todo\",\n *       projectId: null,\n *     });\n *   },\n * });\n * ```\n *\n * @param config - The {@link FunctionConfig} describing the args schema,\n *   optional return-value schema, and handler function.\n */\nexport function mutation<\n  TContext = unknown,\n  TValidator extends Validator<unknown, unknown, string> = Validator<\n    unknown,\n    unknown,\n    string\n  >,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, Infer<TValidator>, TResult> & {\n    args: TValidator;\n  }\n): SyncoreFunctionDefinition<\"mutation\", TContext, Infer<TValidator>, TResult>;\nexport function mutation<\n  TContext = unknown,\n  TArgsShape extends ValidatorMap = ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"mutation\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n>;\nexport function mutation<\n  TContext = unknown,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap =\n    ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"mutation\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n> {\n  return createFunctionDefinition(\"mutation\", config);\n}\n\n/**\n * Define a Syncore action.\n *\n * Actions are the escape hatch for work that goes beyond reading and writing\n * the local database. They run **outside** of any transaction, which means\n * they can:\n *\n * - Call external APIs (HTTP, WebSocket, etc.)\n * - Perform CPU-intensive or long-running work\n * - Invoke other Syncore functions via `ctx.runMutation` / `ctx.runQuery`\n * - Schedule deferred jobs via `ctx.scheduler`\n *\n * Because actions are non-transactional, database writes must be delegated to\n * a mutation. This keeps write atomicity in mutations while actions handle\n * side effects.\n *\n * ```ts\n * // syncore/functions/ai.ts\n * import { action } from \"syncorejs\";\n * import { s } from \"syncorejs\";\n * import type { ActionCtx } from \"../_generated/server\";\n * import { api } from \"../_generated/api\";\n *\n * export const summarise = action({\n *   args: { taskId: s.id(\"tasks\") },\n *   handler: async (ctx: ActionCtx, { taskId }) => {\n *     const task = await ctx.runQuery(api.tasks.get, { id: taskId });\n *     const summary = await fetchSummaryFromApi(task.title);\n *     await ctx.runMutation(api.tasks.setSummary, { taskId, summary });\n *   },\n * });\n * ```\n *\n * @param config - The {@link FunctionConfig} describing the args schema,\n *   optional return-value schema, and handler function.\n */\nexport function action<\n  TContext = unknown,\n  TValidator extends Validator<unknown, unknown, string> = Validator<\n    unknown,\n    unknown,\n    string\n  >,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, Infer<TValidator>, TResult> & {\n    args: TValidator;\n  }\n): SyncoreFunctionDefinition<\"action\", TContext, Infer<TValidator>, TResult>;\nexport function action<\n  TContext = unknown,\n  TArgsShape extends ValidatorMap = ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"action\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n>;\nexport function action<\n  TContext = unknown,\n  TArgsShape extends Validator<unknown, unknown, string> | ValidatorMap =\n    ValidatorMap,\n  TResult = unknown\n>(\n  config: FunctionConfig<TContext, InferArgs<TArgsShape>, TResult> & {\n    args: TArgsShape;\n  }\n): SyncoreFunctionDefinition<\n  \"action\",\n  TContext,\n  InferArgs<TArgsShape>,\n  TResult\n> {\n  return createFunctionDefinition(\"action\", config);\n}\n\n/**\n * Runs a recurring job repeatedly at a fixed time interval.\n *\n * At least one of `seconds`, `minutes`, or `hours` must be provided; multiple\n * fields are additive (e.g. `{ hours: 1, minutes: 30 }` fires every 90 minutes).\n *\n * ```ts\n * crons.interval(\"refresh-cache\", { minutes: 15 }, api.cache.refresh);\n * ```\n */\nexport interface RecurringIntervalSchedule {\n  type: \"interval\";\n  /** Number of seconds to add to the interval. */\n  seconds?: number;\n  /** Number of minutes to add to the interval. */\n  minutes?: number;\n  /** Number of hours to add to the interval. */\n  hours?: number;\n}\n\n/**\n * Runs a recurring job once a day at a specific wall-clock time.\n *\n * ```ts\n * crons.daily(\"nightly-report\", { hour: 2, minute: 0 }, api.reports.generate);\n * ```\n */\nexport interface RecurringDailySchedule {\n  type: \"daily\";\n  /** Hour of day to run (0–23, in UTC unless `timezone` is provided). */\n  hour: number;\n  /** Minute of hour to run (0–59). */\n  minute: number;\n  /**\n   * IANA timezone name (e.g. `\"America/New_York\"`). Defaults to UTC when\n   * omitted.\n   */\n  timezone?: string;\n}\n\n/**\n * Runs a recurring job once a week on a specific day and time.\n *\n * ```ts\n * crons.weekly(\n *   \"weekly-digest\",\n *   { dayOfWeek: \"monday\", hour: 9, minute: 0, timezone: \"Europe/London\" },\n *   api.email.weeklyDigest\n * );\n * ```\n */\nexport interface RecurringWeeklySchedule {\n  type: \"weekly\";\n  /** Day of the week on which to fire. */\n  dayOfWeek:\n    | \"sunday\"\n    | \"monday\"\n    | \"tuesday\"\n    | \"wednesday\"\n    | \"thursday\"\n    | \"friday\"\n    | \"saturday\";\n  /** Hour of day to run (0–23, in UTC unless `timezone` is provided). */\n  hour: number;\n  /** Minute of hour to run (0–59). */\n  minute: number;\n  /**\n   * IANA timezone name (e.g. `\"America/New_York\"`). Defaults to UTC when\n   * omitted.\n   */\n  timezone?: string;\n}\n\n/**\n * Union of all supported recurring-schedule shapes.\n *\n * Pass this (or one of its members) to {@link RecurringJobDefinition.schedule}\n * or to the fluent helpers on {@link CronJobs}.\n */\nexport type RecurringSchedule =\n  | RecurringIntervalSchedule\n  | RecurringDailySchedule\n  | RecurringWeeklySchedule;\n\n/**\n * Determines how the scheduler reacts when a job run is missed (e.g. because\n * the runtime was offline when the job was supposed to fire).\n *\n * - `\"catch_up\"` — Run the job once for every missed execution window. Use for\n *   jobs where every run matters (e.g. per-minute metrics collection).\n * - `\"skip\"` — Skip all missed runs and resume on the next scheduled tick.\n *   Safe default when running the job twice in quick succession would be\n *   harmful.\n * - `\"run_once_if_missed\"` — If any runs were missed, execute the job exactly\n *   once to “catch up”, then continue on the normal schedule.\n * - `\"windowed\"` — Catch up, but only within a specific time window. Missed\n *   runs older than `windowMs` milliseconds are discarded.\n *\n * @example\n * ```ts\n * const policy: MisfirePolicy = { type: \"windowed\", windowMs: 5 * 60_000 };\n * ```\n */\nexport type MisfirePolicy =\n  | { type: \"catch_up\" }\n  | { type: \"skip\" }\n  | { type: \"run_once_if_missed\" }\n  | { type: \"windowed\"; windowMs: number };\n\n/**\n * A single entry in the recurring-job registry.\n *\n * You can construct these manually and pass them to `scheduler.recurringJobs`,\n * but the fluent {@link CronJobs} builder is usually more readable.\n */\nexport interface RecurringJobDefinition {\n  /** Unique name used to identify this job in the scheduler and devtools UI. */\n  name: string;\n  /** When and how often this job should run. */\n  schedule: RecurringSchedule;\n  /** The function to invoke. Must be a mutation or action reference. */\n  function: FunctionReference<\"mutation\" | \"action\">;\n  /** Arguments forwarded to the function on every invocation. */\n  args: Record<string, unknown>;\n  /** How to handle missed executions. */\n  misfirePolicy: MisfirePolicy;\n}\n\n/**\n * Fluent builder for declaring the recurring (cron) jobs of a Syncore app.\n *\n * Instantiate with {@link cronJobs} and chain calls to `.interval()`, `.daily()`,\n * or `.weekly()`. Pass the resulting instance's `.jobs` array to\n * `scheduler.recurringJobs` in your runtime options.\n *\n * ```ts\n * // syncore/crons.ts\n * import { cronJobs } from \"syncorejs\";\n * import { api } from \"./_generated/api\";\n *\n * const crons = cronJobs();\n *\n * crons.interval(\"refresh-feed\",  { minutes: 10 }, api.feed.refresh);\n * crons.daily(\"send-digest\",       { hour: 8, minute: 0 }, api.email.digest);\n * crons.weekly(\"weekly-cleanup\",   { dayOfWeek: \"sunday\", hour: 3, minute: 0 }, api.db.vacuum);\n *\n * export default crons;\n * ```\n *\n * Then in your runtime setup:\n * ```ts\n * createNodeSyncoreRuntime({\n *   ...,\n *   scheduler: { recurringJobs: crons.jobs },\n * });\n * ```\n */\nexport class CronJobs {\n  readonly jobs: RecurringJobDefinition[] = [];\n\n  /**\n   * Register a job that fires repeatedly at a fixed time interval.\n   *\n   * @param name           - Unique identifier for this job.\n   * @param schedule       - Interval fields (`seconds`, `minutes`, `hours`).\n   * @param functionReference - Mutation or action to invoke.\n   * @param args           - Arguments forwarded on every invocation.\n   * @param misfirePolicy  - How to handle runs missed while the runtime was\n   *   offline. Defaults to `{ type: \"catch_up\" }`.\n   */\n  interval(\n    name: string,\n    schedule: Omit<RecurringIntervalSchedule, \"type\">,\n    functionReference: FunctionReference<\"mutation\" | \"action\">,\n    args: Record<string, unknown> = {},\n    misfirePolicy: MisfirePolicy = { type: \"catch_up\" }\n  ): this {\n    this.jobs.push({\n      name,\n      schedule: { type: \"interval\", ...schedule },\n      function: functionReference,\n      args,\n      misfirePolicy\n    });\n    return this;\n  }\n\n  /**\n   * Register a job that fires once a day at a given wall-clock time.\n   *\n   * @param name           - Unique identifier for this job.\n   * @param schedule       - `hour` (0–23), `minute` (0–59), optional `timezone`.\n   * @param functionReference - Mutation or action to invoke.\n   * @param args           - Arguments forwarded on every invocation.\n   * @param misfirePolicy  - How to handle runs missed while the runtime was\n   *   offline. Defaults to `{ type: \"catch_up\" }`.\n   */\n  daily(\n    name: string,\n    schedule: Omit<RecurringDailySchedule, \"type\">,\n    functionReference: FunctionReference<\"mutation\" | \"action\">,\n    args: Record<string, unknown> = {},\n    misfirePolicy: MisfirePolicy = { type: \"catch_up\" }\n  ): this {\n    this.jobs.push({\n      name,\n      schedule: { type: \"daily\", ...schedule },\n      function: functionReference,\n      args,\n      misfirePolicy\n    });\n    return this;\n  }\n\n  /**\n   * Register a job that fires once a week on a given day and time.\n   *\n   * @param name           - Unique identifier for this job.\n   * @param schedule       - `dayOfWeek`, `hour` (0–23), `minute` (0–59),\n   *   optional `timezone`.\n   * @param functionReference - Mutation or action to invoke.\n   * @param args           - Arguments forwarded on every invocation.\n   * @param misfirePolicy  - How to handle runs missed while the runtime was\n   *   offline. Defaults to `{ type: \"catch_up\" }`.\n   */\n  weekly(\n    name: string,\n    schedule: Omit<RecurringWeeklySchedule, \"type\">,\n    functionReference: FunctionReference<\"mutation\" | \"action\">,\n    args: Record<string, unknown> = {},\n    misfirePolicy: MisfirePolicy = { type: \"catch_up\" }\n  ): this {\n    this.jobs.push({\n      name,\n      schedule: { type: \"weekly\", ...schedule },\n      function: functionReference,\n      args,\n      misfirePolicy\n    });\n    return this;\n  }\n}\n\n/**\n * Create a new {@link CronJobs} builder for declaring recurring Syncore jobs.\n *\n * @example\n * ```ts\n * // syncore/crons.ts\n * import { cronJobs } from \"syncorejs\";\n * import { api } from \"./_generated/api\";\n *\n * const crons = cronJobs();\n * crons.interval(\"sync\", { minutes: 5 }, api.sync.run);\n * export default crons;\n * ```\n */\nexport function cronJobs(): CronJobs {\n  return new CronJobs();\n}\n"],"mappings":";;AAqPA,SAAS,yBAMP,MACA,QAG4E;CAa5E,OAAO;EACL;EACA,eAdoB,YAAY,OAAO,IAAI,IACxC,OAAO,OAKP,sBAAsB,OAAO,IAAoB;EASpD,GAAI,OAAO,UAAU,EAAE,kBAAkB,OAAO,QAAQ,IAAI,CAAC;EAC7D,SAAS,OAAO;CAClB;AACF;AA0DA,SAAgB,MAMd,QAQA;CACA,OAAO,yBAAyB,SAAS,MAAM;AACjD;AA+DA,SAAgB,SAMd,QAQA;CACA,OAAO,yBAAyB,YAAY,MAAM;AACpD;AAiEA,SAAgB,OAMd,QAQA;CACA,OAAO,yBAAyB,UAAU,MAAM;AAClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+JA,IAAa,WAAb,MAAsB;CACpB,OAA0C,CAAC;;;;;;;;;;;CAY3C,SACE,MACA,UACA,mBACA,OAAgC,CAAC,GACjC,gBAA+B,EAAE,MAAM,WAAW,GAC5C;EACN,KAAK,KAAK,KAAK;GACb;GACA,UAAU;IAAE,MAAM;IAAY,GAAG;GAAS;GAC1C,UAAU;GACV;GACA;EACF,CAAC;EACD,OAAO;CACT;;;;;;;;;;;CAYA,MACE,MACA,UACA,mBACA,OAAgC,CAAC,GACjC,gBAA+B,EAAE,MAAM,WAAW,GAC5C;EACN,KAAK,KAAK,KAAK;GACb;GACA,UAAU;IAAE,MAAM;IAAS,GAAG;GAAS;GACvC,UAAU;GACV;GACA;EACF,CAAC;EACD,OAAO;CACT;;;;;;;;;;;;CAaA,OACE,MACA,UACA,mBACA,OAAgC,CAAC,GACjC,gBAA+B,EAAE,MAAM,WAAW,GAC5C;EACN,KAAK,KAAK,KAAK;GACb;GACA,UAAU;IAAE,MAAM;IAAU,GAAG;GAAS;GACxC,UAAU;GACV;GACA;EACF,CAAC;EACD,OAAO;CACT;AACF;;;;;;;;;;;;;;;AAgBA,SAAgB,WAAqB;CACnC,OAAO,IAAI,SAAS;AACtB"}

package/dist/_vendor/core/runtime/id.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.mts","names":[],"sources":["../../src/runtime/id.ts"],"mappings":";;AAQA;;;;;;;iBAAgB,UAAA,CAAA"}
+{"version":3,"file":"id.d.mts","names":[],"sources":["../../src/runtime/id.ts"],"mappings":";;AAQA;;;;AAA0B;;;iBAAV,UAAA,CAAA"}

package/dist/_vendor/core/runtime/id.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"id.mjs","names":[],"sources":["../../src/runtime/id.ts"],"sourcesContent":["/**\n * Generate a random UUID v4 string.\n *\n * Prefers `crypto.randomUUID()` when available (secure contexts, Node 19+,\n * web workers). Falls back to building a v4 UUID from\n * `crypto.getRandomValues()` for non-secure contexts such as `http://`\n * dev servers.\n */\nexport function generateId(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n\n  // Fallback: build a UUID v4 from getRandomValues.\n  // Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\n  const bytes = new Uint8Array(16);\n  crypto.getRandomValues(bytes);\n\n  // Set version (4) and variant (10xx) bits per RFC 4122.\n  bytes[6] = (bytes[6]! & 0x0f) | 0x40;\n  bytes[8] = (bytes[8]! & 0x3f) | 0x80;\n\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\n    \"\"\n  );\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32)\n  ].join(\"-\");\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,aAAqB;AACnC,KACE,OAAO,WAAW,eAClB,OAAO,OAAO,eAAe,WAE7B,QAAO,OAAO,YAAY;CAK5B,MAAM,QAAQ,IAAI,WAAW,GAAG;AAChC,QAAO,gBAAgB,MAAM;AAG7B,OAAM,KAAM,MAAM,KAAM,KAAQ;AAChC,OAAM,KAAM,MAAM,KAAM,KAAQ;CAEhC,MAAM,MAAM,MAAM,KAAK,QAAQ,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,KACpE,GACD;AAED,QAAO;EACL,IAAI,MAAM,GAAG,EAAE;EACf,IAAI,MAAM,GAAG,GAAG;EAChB,IAAI,MAAM,IAAI,GAAG;EACjB,IAAI,MAAM,IAAI,GAAG;EACjB,IAAI,MAAM,IAAI,GAAG;EAClB,CAAC,KAAK,IAAI"}
+{"version":3,"file":"id.mjs","names":[],"sources":["../../src/runtime/id.ts"],"sourcesContent":["/**\n * Generate a random UUID v4 string.\n *\n * Prefers `crypto.randomUUID()` when available (secure contexts, Node 19+,\n * web workers). Falls back to building a v4 UUID from\n * `crypto.getRandomValues()` for non-secure contexts such as `http://`\n * dev servers.\n */\nexport function generateId(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n\n  // Fallback: build a UUID v4 from getRandomValues.\n  // Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\n  const bytes = new Uint8Array(16);\n  crypto.getRandomValues(bytes);\n\n  // Set version (4) and variant (10xx) bits per RFC 4122.\n  bytes[6] = (bytes[6]! & 0x0f) | 0x40;\n  bytes[8] = (bytes[8]! & 0x3f) | 0x80;\n\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\n    \"\"\n  );\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32)\n  ].join(\"-\");\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,aAAqB;CACnC,IACE,OAAO,WAAW,eAClB,OAAO,OAAO,eAAe,YAE7B,OAAO,OAAO,WAAW;CAK3B,MAAM,QAAQ,IAAI,WAAW,EAAE;CAC/B,OAAO,gBAAgB,KAAK;CAG5B,MAAM,KAAM,MAAM,KAAM,KAAQ;CAChC,MAAM,KAAM,MAAM,KAAM,KAAQ;CAEhC,MAAM,MAAM,MAAM,KAAK,QAAQ,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KACpE,EACF;CAEA,OAAO;EACL,IAAI,MAAM,GAAG,CAAC;EACd,IAAI,MAAM,GAAG,EAAE;EACf,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;CAClB,EAAE,KAAK,GAAG;AACZ"}

package/dist/_vendor/core/runtime/internal/engines/devtoolsEngine.mjs

@@ -1,9 +1,11 @@
 import { devtoolsScopesForEvent } from "./shared.mjs";
 //#region src/runtime/internal/engines/devtoolsEngine.ts
 var DevtoolsEngine = class {
+	deps;
 	recentEvents = [];
 	listeners = /* @__PURE__ */ new Set();
 	invalidationListeners = /* @__PURE__ */ new Set();
+	nextSequence = 1;
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -43,11 +45,15 @@ var DevtoolsEngine = class {
 		for (const listener of this.invalidationListeners) listener(scopeSet);
 	}
 	emit(event) {
-		this.recentEvents.unshift(event);
-		this.recentEvents.splice(24);
-		this.deps.sink?.emit(event);
-		this.notifyScopes(devtoolsScopesForEvent(event));
-		for (const listener of this.listeners) listener(event);
+		const sequencedEvent = {
+			...event,
+			sequence: event.sequence ?? this.nextSequence++
+		};
+		this.recentEvents.push(sequencedEvent);
+		this.recentEvents.splice(0, Math.max(0, this.recentEvents.length - 24));
+		this.deps.sink?.emit(sequencedEvent);
+		this.notifyScopes(devtoolsScopesForEvent(sequencedEvent));
+		for (const listener of this.listeners) listener(sequencedEvent);
 	}
 	async forceRefresh(reason, handlers, meta = {}, scopes = []) {
 		const scopeSet = new Set(scopes);

package/dist/_vendor/core/runtime/internal/engines/devtoolsEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"devtoolsEngine.mjs","names":[],"sources":["../../../../src/runtime/internal/engines/devtoolsEngine.ts"],"sourcesContent":["import type {\n  SyncoreActiveQueryInfo,\n  SyncoreDevtoolsEvent,\n  SyncoreRuntimeSummary\n} from \"@syncore/devtools-protocol\";\nimport type {\n  ImpactScope,\n  DevtoolsLiveQueryScope,\n  DevtoolsLiveQuerySnapshot,\n  DevtoolsSink\n} from \"../../runtime.js\";\nimport { devtoolsScopesForEvent, type DevtoolsEventMeta } from \"./shared.js\";\n\ntype DevtoolsEngineDeps = {\n  runtimeId: string;\n  platform: string;\n  sink?: DevtoolsSink;\n  getActiveQueryInfos: () => SyncoreActiveQueryInfo[];\n  getSchemaTables: () => Promise<DevtoolsLiveQuerySnapshot[\"schemaTables\"]>;\n};\n\nexport class DevtoolsEngine {\n  private readonly recentEvents: SyncoreDevtoolsEvent[] = [];\n  private readonly listeners = new Set<(event: SyncoreDevtoolsEvent) => void>();\n  private readonly invalidationListeners = new Set<\n    (scopes: Set<DevtoolsLiveQueryScope>) => void\n  >();\n\n  constructor(private readonly deps: DevtoolsEngineDeps) {}\n\n  getRuntimeSummary(): SyncoreRuntimeSummary {\n    return {\n      runtimeId: this.deps.runtimeId,\n      platform: this.deps.platform,\n      connectedAt: Date.now(),\n      activeQueryCount: this.deps.getActiveQueryInfos().length,\n      recentEventCount: this.recentEvents.length\n    };\n  }\n\n  getActiveQueryInfos(): SyncoreActiveQueryInfo[] {\n    return this.deps.getActiveQueryInfos();\n  }\n\n  async getLiveSnapshot(): Promise<DevtoolsLiveQuerySnapshot> {\n    return {\n      summary: this.getRuntimeSummary(),\n      activeQueries: this.getActiveQueryInfos(),\n      schemaTables: await this.deps.getSchemaTables()\n    };\n  }\n\n  subscribeEvents(listener: (event: SyncoreDevtoolsEvent) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  subscribeInvalidations(\n    listener: (scopes: Set<DevtoolsLiveQueryScope>) => void\n  ): () => void {\n    this.invalidationListeners.add(listener);\n    return () => {\n      this.invalidationListeners.delete(listener);\n    };\n  }\n\n  notifyScopes(scopes: Iterable<DevtoolsLiveQueryScope>): void {\n    const scopeSet = new Set(scopes);\n    for (const listener of this.invalidationListeners) {\n      listener(scopeSet);\n    }\n  }\n\n  emit(event: SyncoreDevtoolsEvent): void {\n    this.recentEvents.unshift(event);\n    this.recentEvents.splice(24);\n    this.deps.sink?.emit(event);\n    this.notifyScopes(devtoolsScopesForEvent(event));\n    for (const listener of this.listeners) {\n      listener(event);\n    }\n  }\n\n  async forceRefresh(\n    reason: string,\n    handlers: {\n      refreshQueriesForScopes: (\n        scopes: Set<ImpactScope>,\n        reason: string\n      ) => Promise<void>;\n    },\n    meta: DevtoolsEventMeta = {},\n    scopes: Iterable<ImpactScope> = []\n  ): Promise<void> {\n    const scopeSet = new Set(scopes);\n    if (scopeSet.size > 0) {\n      await handlers.refreshQueriesForScopes(scopeSet, reason);\n    }\n    this.notifyScopes(\n      scopeSet.size > 0 ? toDevtoolsScopes(scopeSet) : [\"all\"]\n    );\n    this.emit({\n      type: \"log\",\n      runtimeId: this.deps.runtimeId,\n      level: \"info\",\n      message: reason,\n      timestamp: Date.now(),\n      ...(meta.origin ? { origin: meta.origin } : {})\n    });\n  }\n}\n\nfunction toDevtoolsScopes(\n  scopes: Iterable<ImpactScope>\n): DevtoolsLiveQueryScope[] {\n  const resolved: DevtoolsLiveQueryScope[] = [];\n  for (const scope of scopes) {\n    if (\n      scope.startsWith(\"row:\") ||\n      !(scope.startsWith(\"table:\") || scope.startsWith(\"storage:\")) &&\n        scope !== \"runtime.summary\" &&\n        scope !== \"runtime.activeQueries\" &&\n        scope !== \"schema.tables\" &&\n        scope !== \"scheduler.jobs\"\n    ) {\n      continue;\n    }\n    resolved.push(scope as DevtoolsLiveQueryScope);\n  }\n  return resolved.length > 0 ? resolved : [\"all\"];\n}\n"],"mappings":";;AAqBA,IAAa,iBAAb,MAA4B;CAC1B,eAAwD,EAAE;CAC1D,4BAA6B,IAAI,KAA4C;CAC7E,wCAAyC,IAAI,KAE1C;CAEH,YAAY,MAA2C;AAA1B,OAAA,OAAA;;CAE7B,oBAA2C;AACzC,SAAO;GACL,WAAW,KAAK,KAAK;GACrB,UAAU,KAAK,KAAK;GACpB,aAAa,KAAK,KAAK;GACvB,kBAAkB,KAAK,KAAK,qBAAqB,CAAC;GAClD,kBAAkB,KAAK,aAAa;GACrC;;CAGH,sBAAgD;AAC9C,SAAO,KAAK,KAAK,qBAAqB;;CAGxC,MAAM,kBAAsD;AAC1D,SAAO;GACL,SAAS,KAAK,mBAAmB;GACjC,eAAe,KAAK,qBAAqB;GACzC,cAAc,MAAM,KAAK,KAAK,iBAAiB;GAChD;;CAGH,gBAAgB,UAA6D;AAC3E,OAAK,UAAU,IAAI,SAAS;AAC5B,eAAa;AACX,QAAK,UAAU,OAAO,SAAS;;;CAInC,uBACE,UACY;AACZ,OAAK,sBAAsB,IAAI,SAAS;AACxC,eAAa;AACX,QAAK,sBAAsB,OAAO,SAAS;;;CAI/C,aAAa,QAAgD;EAC3D,MAAM,WAAW,IAAI,IAAI,OAAO;AAChC,OAAK,MAAM,YAAY,KAAK,sBAC1B,UAAS,SAAS;;CAItB,KAAK,OAAmC;AACtC,OAAK,aAAa,QAAQ,MAAM;AAChC,OAAK,aAAa,OAAO,GAAG;AAC5B,OAAK,KAAK,MAAM,KAAK,MAAM;AAC3B,OAAK,aAAa,uBAAuB,MAAM,CAAC;AAChD,OAAK,MAAM,YAAY,KAAK,UAC1B,UAAS,MAAM;;CAInB,MAAM,aACJ,QACA,UAMA,OAA0B,EAAE,EAC5B,SAAgC,EAAE,EACnB;EACf,MAAM,WAAW,IAAI,IAAI,OAAO;AAChC,MAAI,SAAS,OAAO,EAClB,OAAM,SAAS,wBAAwB,UAAU,OAAO;AAE1D,OAAK,aACH,SAAS,OAAO,IAAI,iBAAiB,SAAS,GAAG,CAAC,MAAM,CACzD;AACD,OAAK,KAAK;GACR,MAAM;GACN,WAAW,KAAK,KAAK;GACrB,OAAO;GACP,SAAS;GACT,WAAW,KAAK,KAAK;GACrB,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,QAAQ,GAAG,EAAE;GAC/C,CAAC;;;AAIN,SAAS,iBACP,QAC0B;CAC1B,MAAM,WAAqC,EAAE;AAC7C,MAAK,MAAM,SAAS,QAAQ;AAC1B,MACE,MAAM,WAAW,OAAO,IACxB,EAAE,MAAM,WAAW,SAAS,IAAI,MAAM,WAAW,WAAW,KAC1D,UAAU,qBACV,UAAU,2BACV,UAAU,mBACV,UAAU,iBAEZ;AAEF,WAAS,KAAK,MAAgC;;AAEhD,QAAO,SAAS,SAAS,IAAI,WAAW,CAAC,MAAM"}
+{"version":3,"file":"devtoolsEngine.mjs","names":[],"sources":["../../../../src/runtime/internal/engines/devtoolsEngine.ts"],"sourcesContent":["import type {\n  SyncoreActiveQueryInfo,\n  SyncoreDevtoolsEvent,\n  SyncoreRuntimeSummary\n} from \"@syncore/devtools-protocol\";\nimport type {\n  ImpactScope,\n  DevtoolsLiveQueryScope,\n  DevtoolsLiveQuerySnapshot,\n  DevtoolsSink\n} from \"../../runtime.js\";\nimport { devtoolsScopesForEvent, type DevtoolsEventMeta } from \"./shared.js\";\n\ntype DevtoolsEngineDeps = {\n  runtimeId: string;\n  platform: string;\n  sink?: DevtoolsSink;\n  getActiveQueryInfos: () => SyncoreActiveQueryInfo[];\n  getSchemaTables: () => Promise<DevtoolsLiveQuerySnapshot[\"schemaTables\"]>;\n};\n\nexport class DevtoolsEngine {\n  private readonly recentEvents: SyncoreDevtoolsEvent[] = [];\n  private readonly listeners = new Set<(event: SyncoreDevtoolsEvent) => void>();\n  private readonly invalidationListeners = new Set<\n    (scopes: Set<DevtoolsLiveQueryScope>) => void\n  >();\n  private nextSequence = 1;\n\n  constructor(private readonly deps: DevtoolsEngineDeps) {}\n\n  getRuntimeSummary(): SyncoreRuntimeSummary {\n    return {\n      runtimeId: this.deps.runtimeId,\n      platform: this.deps.platform,\n      connectedAt: Date.now(),\n      activeQueryCount: this.deps.getActiveQueryInfos().length,\n      recentEventCount: this.recentEvents.length\n    };\n  }\n\n  getActiveQueryInfos(): SyncoreActiveQueryInfo[] {\n    return this.deps.getActiveQueryInfos();\n  }\n\n  async getLiveSnapshot(): Promise<DevtoolsLiveQuerySnapshot> {\n    return {\n      summary: this.getRuntimeSummary(),\n      activeQueries: this.getActiveQueryInfos(),\n      schemaTables: await this.deps.getSchemaTables()\n    };\n  }\n\n  subscribeEvents(listener: (event: SyncoreDevtoolsEvent) => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  subscribeInvalidations(\n    listener: (scopes: Set<DevtoolsLiveQueryScope>) => void\n  ): () => void {\n    this.invalidationListeners.add(listener);\n    return () => {\n      this.invalidationListeners.delete(listener);\n    };\n  }\n\n  notifyScopes(scopes: Iterable<DevtoolsLiveQueryScope>): void {\n    const scopeSet = new Set(scopes);\n    for (const listener of this.invalidationListeners) {\n      listener(scopeSet);\n    }\n  }\n\n  emit(event: SyncoreDevtoolsEvent): void {\n    const sequencedEvent = {\n      ...event,\n      sequence: event.sequence ?? this.nextSequence++\n    };\n    this.recentEvents.push(sequencedEvent);\n    this.recentEvents.splice(0, Math.max(0, this.recentEvents.length - 24));\n    this.deps.sink?.emit(sequencedEvent);\n    this.notifyScopes(devtoolsScopesForEvent(sequencedEvent));\n    for (const listener of this.listeners) {\n      listener(sequencedEvent);\n    }\n  }\n\n  async forceRefresh(\n    reason: string,\n    handlers: {\n      refreshQueriesForScopes: (\n        scopes: Set<ImpactScope>,\n        reason: string\n      ) => Promise<unknown>;\n    },\n    meta: DevtoolsEventMeta = {},\n    scopes: Iterable<ImpactScope> = []\n  ): Promise<void> {\n    const scopeSet = new Set(scopes);\n    if (scopeSet.size > 0) {\n      await handlers.refreshQueriesForScopes(scopeSet, reason);\n    }\n    this.notifyScopes(\n      scopeSet.size > 0 ? toDevtoolsScopes(scopeSet) : [\"all\"]\n    );\n    this.emit({\n      type: \"log\",\n      runtimeId: this.deps.runtimeId,\n      level: \"info\",\n      message: reason,\n      timestamp: Date.now(),\n      ...(meta.origin ? { origin: meta.origin } : {})\n    });\n  }\n}\n\nfunction toDevtoolsScopes(\n  scopes: Iterable<ImpactScope>\n): DevtoolsLiveQueryScope[] {\n  const resolved: DevtoolsLiveQueryScope[] = [];\n  for (const scope of scopes) {\n    if (\n      scope.startsWith(\"row:\") ||\n      !(scope.startsWith(\"table:\") || scope.startsWith(\"storage:\")) &&\n        scope !== \"runtime.summary\" &&\n        scope !== \"runtime.activeQueries\" &&\n        scope !== \"schema.tables\" &&\n        scope !== \"scheduler.jobs\"\n    ) {\n      continue;\n    }\n    resolved.push(scope as DevtoolsLiveQueryScope);\n  }\n  return resolved.length > 0 ? resolved : [\"all\"];\n}\n"],"mappings":";;AAqBA,IAAa,iBAAb,MAA4B;CAQG;CAP7B,eAAwD,CAAC;CACzD,4BAA6B,IAAI,IAA2C;CAC5E,wCAAyC,IAAI,IAE3C;CACF,eAAuB;CAEvB,YAAY,MAA2C;EAA1B,KAAA,OAAA;CAA2B;CAExD,oBAA2C;EACzC,OAAO;GACL,WAAW,KAAK,KAAK;GACrB,UAAU,KAAK,KAAK;GACpB,aAAa,KAAK,IAAI;GACtB,kBAAkB,KAAK,KAAK,oBAAoB,EAAE;GAClD,kBAAkB,KAAK,aAAa;EACtC;CACF;CAEA,sBAAgD;EAC9C,OAAO,KAAK,KAAK,oBAAoB;CACvC;CAEA,MAAM,kBAAsD;EAC1D,OAAO;GACL,SAAS,KAAK,kBAAkB;GAChC,eAAe,KAAK,oBAAoB;GACxC,cAAc,MAAM,KAAK,KAAK,gBAAgB;EAChD;CACF;CAEA,gBAAgB,UAA6D;EAC3E,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa;GACX,KAAK,UAAU,OAAO,QAAQ;EAChC;CACF;CAEA,uBACE,UACY;EACZ,KAAK,sBAAsB,IAAI,QAAQ;EACvC,aAAa;GACX,KAAK,sBAAsB,OAAO,QAAQ;EAC5C;CACF;CAEA,aAAa,QAAgD;EAC3D,MAAM,WAAW,IAAI,IAAI,MAAM;EAC/B,KAAK,MAAM,YAAY,KAAK,uBAC1B,SAAS,QAAQ;CAErB;CAEA,KAAK,OAAmC;EACtC,MAAM,iBAAiB;GACrB,GAAG;GACH,UAAU,MAAM,YAAY,KAAK;EACnC;EACA,KAAK,aAAa,KAAK,cAAc;EACrC,KAAK,aAAa,OAAO,GAAG,KAAK,IAAI,GAAG,KAAK,aAAa,SAAS,EAAE,CAAC;EACtE,KAAK,KAAK,MAAM,KAAK,cAAc;EACnC,KAAK,aAAa,uBAAuB,cAAc,CAAC;EACxD,KAAK,MAAM,YAAY,KAAK,WAC1B,SAAS,cAAc;CAE3B;CAEA,MAAM,aACJ,QACA,UAMA,OAA0B,CAAC,GAC3B,SAAgC,CAAC,GAClB;EACf,MAAM,WAAW,IAAI,IAAI,MAAM;EAC/B,IAAI,SAAS,OAAO,GAClB,MAAM,SAAS,wBAAwB,UAAU,MAAM;EAEzD,KAAK,aACH,SAAS,OAAO,IAAI,iBAAiB,QAAQ,IAAI,CAAC,KAAK,CACzD;EACA,KAAK,KAAK;GACR,MAAM;GACN,WAAW,KAAK,KAAK;GACrB,OAAO;GACP,SAAS;GACT,WAAW,KAAK,IAAI;GACpB,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;EAC/C,CAAC;CACH;AACF;AAEA,SAAS,iBACP,QAC0B;CAC1B,MAAM,WAAqC,CAAC;CAC5C,KAAK,MAAM,SAAS,QAAQ;EAC1B,IACE,MAAM,WAAW,MAAM,KACvB,EAAE,MAAM,WAAW,QAAQ,KAAK,MAAM,WAAW,UAAU,MACzD,UAAU,qBACV,UAAU,2BACV,UAAU,mBACV,UAAU,kBAEZ;EAEF,SAAS,KAAK,KAA+B;CAC/C;CACA,OAAO,SAAS,SAAS,IAAI,WAAW,CAAC,KAAK;AAChD"}

package/dist/_vendor/core/runtime/internal/engines/executionEngine.mjs

@@ -1,6 +1,6 @@
 import { toCanonicalComponentFunctionName } from "../../components.mjs";
 import { generateId } from "../../id.mjs";
-import { fieldExpression, normalizeOptionalArgs, omitSystemFields, quoteIdentifier, resolveSearchIndexTableName, splitSchedulerArgs, stableStringify } from "./shared.mjs";
+import { createDevtoolsPreview, fieldExpression, normalizeOptionalArgs, omitSystemFields, quoteIdentifier, resolveSearchIndexTableName, splitSchedulerArgs, stableStringify } from "./shared.mjs";
 import { createEmptyExecutionResult } from "../transactionCoordinator.mjs";
 //#region src/runtime/internal/engines/executionEngine.ts
 const DEFAULT_MISFIRE_POLICY = { type: "catch_up" };
@@ -141,6 +141,9 @@ var RuntimeSearchIndexBuilder = class {
 	}
 };
 var RuntimeQueryBuilder = class {
+	executeQuery;
+	tableName;
+	dependencyCollector;
 	orderDirection = "asc";
 	source = { type: "table" };
 	filterExpression;
@@ -150,10 +153,11 @@ var RuntimeQueryBuilder = class {
 		this.dependencyCollector = dependencyCollector;
 	}
 	withIndex(indexName, builder) {
+		const indexRange = builder?.(new RuntimeIndexRangeBuilder()).build() ?? [];
 		this.source = {
 			type: "index",
 			name: indexName,
-			range: builder?.(new RuntimeIndexRangeBuilder()).build() ?? []
+			range: indexRange
 		};
 		return this;
 	}
@@ -215,6 +219,7 @@ var RuntimeQueryBuilder = class {
 	}
 };
 var ExecutionEngine = class {
+	deps;
 	constructor(deps) {
 		this.deps = deps;
 	}
@@ -233,26 +238,35 @@ var ExecutionEngine = class {
 	async runQuery(reference, args = {}, meta = {}) {
 		const definition = this.resolveFunction(reference, "query");
 		const dependencyCollector = /* @__PURE__ */ new Set();
+		const executionId = meta.executionId ?? generateId();
 		const startedAt = Date.now();
 		const result = await this.invokeFunction(definition, args, {
+			executionId,
 			mutationDepth: 0,
 			changedTables: /* @__PURE__ */ new Set(),
+			documentChanges: [],
 			storageChanges: [],
 			dependencyCollector,
 			componentMetadata: definition.__syncoreComponent
 		});
+		const completedAt = Date.now();
 		this.deps.devtools.emit({
 			type: "query.executed",
 			runtimeId: this.deps.runtimeId,
 			queryId: reference.name,
 			functionName: reference.name,
+			executionId,
+			...meta.parentExecutionId ? { parentExecutionId: meta.parentExecutionId } : {},
 			...definition.__syncoreComponent ? {
 				componentPath: definition.__syncoreComponent.componentPath,
 				componentName: definition.__syncoreComponent.componentName
 			} : {},
 			dependencies: [...dependencyCollector],
-			durationMs: Date.now() - startedAt,
-			timestamp: Date.now(),
+			argsPreview: createDevtoolsPreview(args),
+			resultPreview: createDevtoolsPreview(result),
+			readScopes: [...dependencyCollector],
+			durationMs: completedAt - startedAt,
+			timestamp: completedAt,
 			...meta.origin ? { origin: meta.origin } : {}
 		});
 		return result;
@@ -260,69 +274,100 @@ var ExecutionEngine = class {
 	async runMutation(reference, args = {}, meta = {}) {
 		const definition = this.resolveFunction(reference, "mutation");
 		const mutationId = generateId();
+		const executionId = meta.executionId ?? mutationId;
 		const startedAt = Date.now();
 		const execution = await this.deps.transactionCoordinator.runInTransaction(async (transactionState) => this.invokeFunction(definition, args, {
+			executionId,
 			mutationDepth: 1,
 			changedTables: transactionState.changedTables,
+			documentChanges: transactionState.documentChanges,
 			storageChanges: transactionState.storageChanges,
 			componentMetadata: definition.__syncoreComponent
 		}));
-		await this.finalizeStatefulExecution(mutationId, execution, Date.now() - startedAt);
+		const completedAt = Date.now();
+		const impact = this.collectStatefulExecutionImpact(execution);
 		this.deps.devtools.emit({
 			type: "mutation.committed",
 			runtimeId: this.deps.runtimeId,
 			mutationId,
 			functionName: reference.name,
+			executionId,
+			...meta.parentExecutionId ? { parentExecutionId: meta.parentExecutionId } : {},
 			...definition.__syncoreComponent ? {
 				componentPath: definition.__syncoreComponent.componentPath,
 				componentName: definition.__syncoreComponent.componentName
 			} : {},
 			changedTables: [...execution.changedTables],
-			durationMs: Date.now() - startedAt,
-			timestamp: Date.now(),
+			argsPreview: createDevtoolsPreview(args),
+			resultPreview: createDevtoolsPreview(execution.result),
+			writeScopes: [...impact.changedScopes],
+			changedScopes: [...impact.changedScopes],
+			changedDocumentsPreview: execution.documentChanges,
+			invalidatedQueryIds: impact.invalidatedQueryIds,
+			durationMs: completedAt - startedAt,
+			timestamp: completedAt,
 			...meta.origin ? { origin: meta.origin } : {}
 		});
+		await this.publishStatefulExecutionEffects(executionId, execution, impact.changedScopes);
 		return execution.result;
 	}
 	async runAction(reference, args = {}, meta = {}) {
 		const definition = this.resolveFunction(reference, "action");
 		const actionId = generateId();
+		const executionId = meta.executionId ?? actionId;
 		const startedAt = Date.now();
 		const state = this.deps.transactionCoordinator.createState();
 		try {
 			const result = await this.invokeFunction(definition, args, {
+				executionId,
 				mutationDepth: 0,
 				changedTables: state.changedTables,
+				documentChanges: state.documentChanges,
 				storageChanges: state.storageChanges,
 				componentMetadata: definition.__syncoreComponent
 			});
-			await this.finalizeStatefulExecution(actionId, createEmptyExecutionResult(result, state), Date.now() - startedAt);
+			const completedAt = Date.now();
+			const execution = createEmptyExecutionResult(result, state);
+			const impact = this.collectStatefulExecutionImpact(execution);
 			this.deps.devtools.emit({
 				type: "action.completed",
 				runtimeId: this.deps.runtimeId,
 				actionId,
 				functionName: reference.name,
+				executionId,
+				...meta.parentExecutionId ? { parentExecutionId: meta.parentExecutionId } : {},
 				...definition.__syncoreComponent ? {
 					componentPath: definition.__syncoreComponent.componentPath,
 					componentName: definition.__syncoreComponent.componentName
 				} : {},
-				durationMs: Date.now() - startedAt,
-				timestamp: Date.now(),
+				argsPreview: createDevtoolsPreview(args),
+				resultPreview: createDevtoolsPreview(result),
+				writeScopes: [...impact.changedScopes],
+				changedScopes: [...impact.changedScopes],
+				changedDocumentsPreview: state.documentChanges,
+				invalidatedQueryIds: impact.invalidatedQueryIds,
+				durationMs: completedAt - startedAt,
+				timestamp: completedAt,
 				...meta.origin ? { origin: meta.origin } : {}
 			});
+			await this.publishStatefulExecutionEffects(executionId, execution, impact.changedScopes);
 			return result;
 		} catch (error) {
+			const completedAt = Date.now();
 			this.deps.devtools.emit({
 				type: "action.completed",
 				runtimeId: this.deps.runtimeId,
 				actionId,
 				functionName: reference.name,
+				executionId,
+				...meta.parentExecutionId ? { parentExecutionId: meta.parentExecutionId } : {},
 				...definition.__syncoreComponent ? {
 					componentPath: definition.__syncoreComponent.componentPath,
 					componentName: definition.__syncoreComponent.componentName
 				} : {},
-				durationMs: Date.now() - startedAt,
-				timestamp: Date.now(),
+				argsPreview: createDevtoolsPreview(args),
+				durationMs: completedAt - startedAt,
+				timestamp: completedAt,
 				...meta.origin ? { origin: meta.origin } : {},
 				error: error instanceof Error ? error.message : String(error)
 			});
@@ -331,28 +376,47 @@ var ExecutionEngine = class {
 	}
 	async runDevtoolsMutation(callback, meta = {}) {
 		const mutationId = generateId();
+		const executionId = meta.executionId ?? mutationId;
 		const startedAt = Date.now();
 		const execution = await this.deps.transactionCoordinator.runInTransaction(async (transactionState) => callback({ db: this.createDatabaseWriter({
+			executionId,
 			mutationDepth: 1,
 			changedTables: transactionState.changedTables,
+			documentChanges: transactionState.documentChanges,
 			storageChanges: transactionState.storageChanges
 		}) }));
-		await this.finalizeStatefulExecution(mutationId, execution, Date.now() - startedAt);
+		const completedAt = Date.now();
+		const impact = this.collectStatefulExecutionImpact(execution);
 		this.deps.devtools.emit({
 			type: "mutation.committed",
 			runtimeId: this.deps.runtimeId,
 			mutationId,
 			functionName: "__devtools__/mutation",
+			executionId,
+			...meta.parentExecutionId ? { parentExecutionId: meta.parentExecutionId } : {},
 			changedTables: [...execution.changedTables],
-			durationMs: Date.now() - startedAt,
-			timestamp: Date.now(),
+			argsPreview: createDevtoolsPreview({ source: "dashboard" }),
+			resultPreview: createDevtoolsPreview(execution.result),
+			writeScopes: [...impact.changedScopes],
+			changedScopes: [...impact.changedScopes],
+			changedDocumentsPreview: execution.documentChanges,
+			invalidatedQueryIds: impact.invalidatedQueryIds,
+			durationMs: completedAt - startedAt,
+			timestamp: completedAt,
 			...meta.origin ? { origin: meta.origin } : {}
 		});
+		await this.publishStatefulExecutionEffects(executionId, execution, impact.changedScopes);
 		return execution.result;
 	}
-	async finalizeStatefulExecution(executionId, execution, durationMs) {
+	collectStatefulExecutionImpact(execution) {
 		const changedScopes = collectChangedScopes(execution.changedTables, execution.storageChanges);
-		if (changedScopes.size > 0) await this.deps.reactivity.refreshQueriesForScopes(changedScopes, `Execution ${executionId} touched ${[...changedScopes].join(", ")}`);
+		return {
+			changedScopes,
+			invalidatedQueryIds: changedScopes.size > 0 ? this.deps.reactivity.getInvalidatedQueryIdsForScopes(changedScopes) : []
+		};
+	}
+	async publishStatefulExecutionEffects(executionId, execution, changedScopes) {
+		if (changedScopes.size > 0) await this.deps.reactivity.refreshQueriesForScopes(changedScopes, `Execution ${executionId} touched ${[...changedScopes].join(", ")}`, { executionId });
 		if (execution.changedTables.size > 0) await this.deps.reactivity.publishExternalChange({
 			scope: "database",
 			reason: "commit",
@@ -368,8 +432,10 @@ var ExecutionEngine = class {
 		}, "query");
 		const dependencyCollector = /* @__PURE__ */ new Set();
 		await this.invokeFunction(definition, args, {
+			executionId: generateId(),
 			mutationDepth: 0,
 			changedTables: /* @__PURE__ */ new Set(),
+			documentChanges: [],
 			storageChanges: [],
 			dependencyCollector,
 			componentMetadata: definition.__syncoreComponent
@@ -444,19 +510,21 @@ var ExecutionEngine = class {
 				capabilities: callerMetadata.grantedCapabilities
 			} } : {},
 			scheduler,
-			runQuery: (reference, ...args) => this.runQuery(this.resolveReferenceForCaller(reference, "query", callerMetadata), normalizeOptionalArgs(args)),
+			runQuery: (reference, ...args) => this.runQuery(this.resolveReferenceForCaller(reference, "query", callerMetadata), normalizeOptionalArgs(args), state.executionId ? { parentExecutionId: state.executionId } : {}),
 			runMutation: (reference, ...args) => {
 				const resolvedReference = this.resolveReferenceForCaller(reference, "mutation", callerMetadata);
 				const normalizedArgs = normalizeOptionalArgs(args);
 				if (kind === "mutation") return this.deps.driver.withSavepoint(`sp_${generateId().replace(/-/g, "_")}`, () => this.invokeFunction(this.resolveFunction(resolvedReference, "mutation", callerMetadata), normalizedArgs, {
+					...state.executionId ? { executionId: state.executionId } : {},
 					mutationDepth: state.mutationDepth + 1,
 					changedTables: state.changedTables,
+					documentChanges: state.documentChanges,
 					storageChanges: state.storageChanges,
 					componentMetadata: callerMetadata
 				}));
-				return this.runMutation(resolvedReference, normalizedArgs);
+				return this.runMutation(resolvedReference, normalizedArgs, state.executionId ? { parentExecutionId: state.executionId } : {});
 			},
-			runAction: (reference, ...args) => this.runAction(this.resolveReferenceForCaller(reference, "action", callerMetadata), normalizeOptionalArgs(args))
+			runAction: (reference, ...args) => this.runAction(this.resolveReferenceForCaller(reference, "action", callerMetadata), normalizeOptionalArgs(args), state.executionId ? { parentExecutionId: state.executionId } : {})
 		};
 	}
 	createDatabaseReader(state) {
@@ -496,6 +564,17 @@ var ExecutionEngine = class {
 					_json: json
 				});
 				state.changedTables.add(scopedTableName);
+				state.documentChanges.push({
+					table: scopedTableName,
+					id,
+					operation: "insert",
+					fields: Object.keys(validated),
+					afterPreview: createDevtoolsPreview({
+						_id: id,
+						_creationTime: creationTime,
+						...validated
+					})
+				});
 				return id;
 			},
 			patch: async (tableName, id, value) => {
@@ -512,21 +591,45 @@ var ExecutionEngine = class {
 				const row = await this.deps.driver.get(`SELECT _id, _creationTime, _json FROM ${quoteIdentifier(scopedTableName)} WHERE _id = ?`, [id]);
 				if (row) await this.deps.schema.syncSearchIndexes(scopedTableName, row);
 				state.changedTables.add(scopedTableName);
+				state.documentChanges.push({
+					table: scopedTableName,
+					id,
+					operation: "patch",
+					fields: Object.keys(value),
+					beforePreview: createDevtoolsPreview(current),
+					afterPreview: createDevtoolsPreview(row ? this.deps.schema.deserializeDocument(scopedTableName, row) : validated)
+				});
 			},
 			replace: async (tableName, id, value) => {
 				const scopedTableName = this.resolveTableName(tableName, state.componentMetadata);
 				const validated = this.deps.schema.validateDocument(scopedTableName, value);
+				const current = await reader.get(tableName, id);
 				await this.deps.driver.run(`UPDATE ${quoteIdentifier(scopedTableName)} SET _json = ? WHERE _id = ?`, [stableStringify(validated), id]);
 				const row = await this.deps.driver.get(`SELECT _id, _creationTime, _json FROM ${quoteIdentifier(scopedTableName)} WHERE _id = ?`, [id]);
 				if (!row) throw new Error(`Document "${id}" does not exist in "${scopedTableName}".`);
 				await this.deps.schema.syncSearchIndexes(scopedTableName, row);
 				state.changedTables.add(scopedTableName);
+				state.documentChanges.push({
+					table: scopedTableName,
+					id,
+					operation: "replace",
+					fields: Object.keys(validated),
+					...current ? { beforePreview: createDevtoolsPreview(current) } : {},
+					afterPreview: createDevtoolsPreview(this.deps.schema.deserializeDocument(scopedTableName, row))
+				});
 			},
 			delete: async (tableName, id) => {
 				const scopedTableName = this.resolveTableName(tableName, state.componentMetadata);
+				const current = await reader.get(tableName, id);
 				await this.deps.driver.run(`DELETE FROM ${quoteIdentifier(scopedTableName)} WHERE _id = ?`, [id]);
 				await this.deps.schema.removeSearchIndexes(scopedTableName, id);
 				state.changedTables.add(scopedTableName);
+				state.documentChanges.push({
+					table: scopedTableName,
+					id,
+					operation: "delete",
+					...current ? { beforePreview: createDevtoolsPreview(current) } : {}
+				});
 			}
 		};
 	}