syncorejs 0.2.1 → 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  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>;\n  returnsValidator?: Validator<TResult>;\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>;\n}\n  ? TArgs\n  : never;\n\nexport type FunctionResultFromDefinition<TDefinition> = TDefinition extends {\n  returnsValidator?: Validator<infer TResult>;\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> | ValidatorMap;\n  returns?: Validator<TResult>;\n  handler: (ctx: TContext, args: TArgs) => Promise<TResult> | TResult;\n}\n\nexport type InferArgs<TArgs extends Validator<unknown> | ValidatorMap> =\n  TArgs extends Validator<unknown>\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> | 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  return {\n    kind,\n    argsValidator: ensureObjectValidator(config.args) as Validator<\n      InferArgs<TArgsShape>\n    >,\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> = Validator<unknown>,\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> | ValidatorMap = 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> = Validator<unknown>,\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> | 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> {\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> = Validator<unknown>,\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> | 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> {\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":";;AAkGA,SAAS,yBAMP,MACA,QAG4E;AAC5E,QAAO;EACL;EACA,eAAe,sBAAsB,OAAO,KAAK;EAGjD,GAAI,OAAO,UAAU,EAAE,kBAAkB,OAAO,SAAS,GAAG,EAAE;EAC9D,SAAS,OAAO;EACjB;;AA0BH,SAAgB,MAKd,QAQA;AACA,QAAO,yBAAyB,SAAS,OAAO;;AA+BlD,SAAgB,SAKd,QAQA;AACA,QAAO,yBAAyB,YAAY,OAAO;;AA+BrD,SAAgB,OAKd,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

@@ -0,0 +1,83 @@
+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;
+	}
+	getRuntimeSummary() {
+		return {
+			runtimeId: this.deps.runtimeId,
+			platform: this.deps.platform,
+			connectedAt: Date.now(),
+			activeQueryCount: this.deps.getActiveQueryInfos().length,
+			recentEventCount: this.recentEvents.length
+		};
+	}
+	getActiveQueryInfos() {
+		return this.deps.getActiveQueryInfos();
+	}
+	async getLiveSnapshot() {
+		return {
+			summary: this.getRuntimeSummary(),
+			activeQueries: this.getActiveQueryInfos(),
+			schemaTables: await this.deps.getSchemaTables()
+		};
+	}
+	subscribeEvents(listener) {
+		this.listeners.add(listener);
+		return () => {
+			this.listeners.delete(listener);
+		};
+	}
+	subscribeInvalidations(listener) {
+		this.invalidationListeners.add(listener);
+		return () => {
+			this.invalidationListeners.delete(listener);
+		};
+	}
+	notifyScopes(scopes) {
+		const scopeSet = new Set(scopes);
+		for (const listener of this.invalidationListeners) listener(scopeSet);
+	}
+	emit(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);
+		if (scopeSet.size > 0) await handlers.refreshQueriesForScopes(scopeSet, reason);
+		this.notifyScopes(scopeSet.size > 0 ? toDevtoolsScopes(scopeSet) : ["all"]);
+		this.emit({
+			type: "log",
+			runtimeId: this.deps.runtimeId,
+			level: "info",
+			message: reason,
+			timestamp: Date.now(),
+			...meta.origin ? { origin: meta.origin } : {}
+		});
+	}
+};
+function toDevtoolsScopes(scopes) {
+	const resolved = [];
+	for (const scope of scopes) {
+		if (scope.startsWith("row:") || !(scope.startsWith("table:") || scope.startsWith("storage:")) && scope !== "runtime.summary" && scope !== "runtime.activeQueries" && scope !== "schema.tables" && scope !== "scheduler.jobs") continue;
+		resolved.push(scope);
+	}
+	return resolved.length > 0 ? resolved : ["all"];
+}
+//#endregion
+export { DevtoolsEngine };
+
+//# sourceMappingURL=devtoolsEngine.mjs.map

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

@@ -0,0 +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  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"}