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

package/dist/index.d.mts

@@ -558,6 +558,7 @@ interface HttpRouteHandlerOptions<SearchParams extends ArgsValidator, Body exten
 * handler receives. There is no parsed `body` — streams are typically GET, and
 * the raw `request` is exposed if a handler needs to read the body itself.
 * `signal` is tripped when the client disconnects.
+* @experimental Part of the HTTP-SSE stream surface; reconnect/POST-body design questions are still open.
 */
 interface HttpStreamHandlerOptions<SearchParams extends ArgsValidator, Params extends ArgsValidator> {
   ctx: HttpActionCtx;
@@ -604,6 +605,7 @@ interface HttpRouteBuilder<SearchParams extends ArgsValidator, Body extends Args
   * throw, an `event: error` frame is written with `{code, message}` before
   * the stream closes. The chunks are JSON-encoded; `R` is inferred from the
   * handler's yielded type.
+  * @experimental Reconnect/POST-body/wire-fidelity design questions are still open, so the shape may change.
   */
   stream: <R>(handler: (options: HttpStreamHandlerOptions<SearchParams, Params>) => AsyncGenerator<R, void, void> | AsyncIterable<R>) => LunoraRouteHandler;
   /**
@@ -1141,10 +1143,26 @@ interface DefinePluginOptions<TExtension extends Record<string, TableDefinition>
   middleware?: Middleware<TContextIn, TContextOut>;
 }
 /**
+* Call signatures for {@link definePlugin}. When `extension` is supplied the
+* returned plugin's `extension` is typed as PRESENT (not `?`), so the
+* canonical install pattern `defineSchema(...).extend(plugin.extension)`
+* typechecks without a non-null assertion — the shape every scaffold template
+* ships. The bare-options signature keeps `extension` optional for plugins
+* that carry only middleware.
+*/
+interface DefinePluginFunction {
+  <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut> & {
+    extension: SchemaExtension<TExtension>;
+  }): Plugin<TExtension, TContextIn, TContextOut> & {
+    readonly extension: SchemaExtension<TExtension>;
+  };
+  <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut>): Plugin<TExtension, TContextIn, TContextOut>;
+}
+/**
 * Package a schema extension + middleware as a reusable plugin. Either
 * field is optional — `definePlugin("foo", {})` is valid but degenerate.
 */
-declare const definePlugin: <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut>) => Plugin<TExtension, TContextIn, TContextOut>;
+declare const definePlugin: DefinePluginFunction;
 /**
 * Bundle of registered functions a {@link Component} ships. Keys are the
 * function's local name (e.g. `check`, `reset`); the registered function

package/dist/index.d.ts

@@ -558,6 +558,7 @@ interface HttpRouteHandlerOptions<SearchParams extends ArgsValidator, Body exten
 * handler receives. There is no parsed `body` — streams are typically GET, and
 * the raw `request` is exposed if a handler needs to read the body itself.
 * `signal` is tripped when the client disconnects.
+* @experimental Part of the HTTP-SSE stream surface; reconnect/POST-body design questions are still open.
 */
 interface HttpStreamHandlerOptions<SearchParams extends ArgsValidator, Params extends ArgsValidator> {
   ctx: HttpActionCtx;
@@ -604,6 +605,7 @@ interface HttpRouteBuilder<SearchParams extends ArgsValidator, Body extends Args
   * throw, an `event: error` frame is written with `{code, message}` before
   * the stream closes. The chunks are JSON-encoded; `R` is inferred from the
   * handler's yielded type.
+  * @experimental Reconnect/POST-body/wire-fidelity design questions are still open, so the shape may change.
   */
   stream: <R>(handler: (options: HttpStreamHandlerOptions<SearchParams, Params>) => AsyncGenerator<R, void, void> | AsyncIterable<R>) => LunoraRouteHandler;
   /**
@@ -1141,10 +1143,26 @@ interface DefinePluginOptions<TExtension extends Record<string, TableDefinition>
   middleware?: Middleware<TContextIn, TContextOut>;
 }
 /**
+* Call signatures for {@link definePlugin}. When `extension` is supplied the
+* returned plugin's `extension` is typed as PRESENT (not `?`), so the
+* canonical install pattern `defineSchema(...).extend(plugin.extension)`
+* typechecks without a non-null assertion — the shape every scaffold template
+* ships. The bare-options signature keeps `extension` optional for plugins
+* that carry only middleware.
+*/
+interface DefinePluginFunction {
+  <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut> & {
+    extension: SchemaExtension<TExtension>;
+  }): Plugin<TExtension, TContextIn, TContextOut> & {
+    readonly extension: SchemaExtension<TExtension>;
+  };
+  <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut>): Plugin<TExtension, TContextIn, TContextOut>;
+}
+/**
 * Package a schema extension + middleware as a reusable plugin. Either
 * field is optional — `definePlugin("foo", {})` is valid but degenerate.
 */
-declare const definePlugin: <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut>) => Plugin<TExtension, TContextIn, TContextOut>;
+declare const definePlugin: DefinePluginFunction;
 /**
 * Bundle of registered functions a {@link Component} ships. Keys are the
 * function's local name (e.g. `check`, `reset`); the registered function

package/dist/index.mjs

@@ -9,10 +9,10 @@ export { defineIdentity } from './packem_shared/defineIdentity-DiX4zM9x.mjs';
 export { onConnect, onDisconnect } from './packem_shared/onConnect-CIPXKPyw.mjs';
 export { defineMigration } from './packem_shared/defineMigration-Hx01yIht.mjs';
 export { defineMutator } from './packem_shared/defineMutator-EIXAWhs9.mjs';
-export { composePluginMiddleware, defineComponent, definePlugin, defineSchemaExtension, installPlugins, mergeSchemaExtension } from './packem_shared/composePluginMiddleware-CcTj1_v2.mjs';
-export { PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, definePresence, presenceExtension } from './packem_shared/PRESENCE_DEFAULT_TTL_MS-BAD0QPAg.mjs';
+export { composePluginMiddleware, defineComponent, definePlugin, defineSchemaExtension, installPlugins, mergeSchemaExtension } from './packem_shared/composePluginMiddleware-z62dttBo.mjs';
+export { PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, definePresence, presenceExtension } from './packem_shared/PRESENCE_DEFAULT_TTL_MS-CwRGb41u.mjs';
 export { protectPublic } from './packem_shared/protectPublic-BlcGpiRc.mjs';
-export { defineAggregateIndex, defineRankIndex, defineSchema, defineTable, defineVectorIndex } from './packem_shared/defineAggregateIndex-znq4ygKQ.mjs';
+export { defineAggregateIndex, defineRankIndex, defineSchema, defineTable, defineVectorIndex } from './packem_shared/defineAggregateIndex-DCzUQLMi.mjs';
 export { defineShape } from './packem_shared/defineShape-C5scNOrf.mjs';
 export { anyApi } from './types.mjs';
 export { cronJobs } from '@lunora/scheduler';

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

@@ -2,8 +2,8 @@ import { v } from '@lunora/values';
 import { initLunora } from './initLunora-CmMVk4i7.mjs';
 import { LunoraError } from './LunoraError-WbxmrpxR.mjs';
 import { onDisconnect } from './onConnect-CIPXKPyw.mjs';
-import { defineSchemaExtension, defineComponent } from './composePluginMiddleware-CcTj1_v2.mjs';
-import { defineTable } from './defineAggregateIndex-znq4ygKQ.mjs';
+import { defineSchemaExtension, defineComponent } from './composePluginMiddleware-z62dttBo.mjs';
+import { defineTable } from './defineAggregateIndex-DCzUQLMi.mjs';
 
 const DEFAULT_TTL_MS = 3e4;
 const MAX_DATA_BYTES = 4096;

package/dist/packem_shared/{composePluginMiddleware-CcTj1_v2.mjs → composePluginMiddleware-z62dttBo.mjs}

@@ -28,7 +28,7 @@ const defineSchemaExtension = (key, options) => {
     ...options.vectorIndexes ? { vectorIndexes: options.vectorIndexes } : {}
   };
 };
-const definePlugin = (key, options) => {
+const definePlugin = ((key, options) => {
   if (!key) {
     throw new LunoraError$1("INTERNAL", "definePlugin: `key` is required and must be a non-empty string");
   }
@@ -40,7 +40,7 @@ const definePlugin = (key, options) => {
     ...options.extension ? { extension: options.extension } : {},
     ...options.middleware ? { middleware: options.middleware } : {}
   };
-};
+});
 const defineComponent = (key, options) => {
   const plugin = definePlugin(key, {
     ...options.extension ? { extension: options.extension } : {},

package/dist/packem_shared/{defineAggregateIndex-znq4ygKQ.mjs → defineAggregateIndex-DCzUQLMi.mjs}

@@ -1,6 +1,6 @@
 import { LunoraError as LunoraError$1 } from '@lunora/errors';
 import { isOrWrapsFromValidator, v } from '@lunora/values';
-import { mergeSchemaExtension } from './composePluginMiddleware-CcTj1_v2.mjs';
+import { mergeSchemaExtension } from './composePluginMiddleware-z62dttBo.mjs';
 
 const relationBuilder = {
   many: (table, options) => {
@@ -277,10 +277,10 @@ const validateExternalSources = (tables) => {
         `defineSchema: sourced + .shardBy() table "${name}" needs a \`tenantBy\` mapper — without it every tenant's DO would run the same unscoped query and replicate the whole multitenant table (a cross-tenant leak). Add \`tenantBy: (shardKey) => [shardKey]\` binding the shard key into the query's parameters.`
       );
     }
-    if (source.mode === "incremental") {
+    if (source.mode !== void 0 && source.mode !== "full-pull") {
       throw new LunoraError$1(
         "INTERNAL",
-        `defineSchema: table "${name}" uses \`mode: "incremental"\`, which is not yet implemented — only "full-pull" (the default) is supported. Remove \`mode\` or set it to "full-pull".`
+        `defineSchema: table "${name}" uses \`mode: ${JSON.stringify(source.mode)}\` — only "full-pull" (the default) is supported. Remove \`mode\` or set it to "full-pull".`
       );
     }
   }

package/dist/types.d.mts

@@ -28,12 +28,14 @@ type ExternalSourceRefresh = "manual" | {
   everyMs: number;
 };
 /**
-* Delete-detection mode for external-source ingest. `"full-pull"` (default) reads
-* the whole tenant membership each tick and diffs it, so it observes upstream
-* deletes; `"incremental"` pulls only changed rows (cheap) and is blind to deletes
-* unless paired with a soft-delete column or a `reconcileEveryMs` full-pull sweep.
+* Delete-detection mode for external-source ingest. `"full-pull"` (the default and
+* currently the only mode) reads the whole tenant membership each tick and diffs
+* it, so it observes upstream deletes. An `"incremental"` mode (pull only changed
+* rows above the ~10k full-pull cap) is not implemented yet — it needs durable
+* cursor/watermark machinery that does not exist; this alias is the seam it
+* returns through.
 */
-type ExternalSourceMode = "full-pull" | "incremental";
+type ExternalSourceMode = "full-pull";
 /**
 * Config for `.source(...)` (plan 077): declares a table as **materialized from an
 * external Postgres/MySQL behind Cloudflare Hyperdrive**, not written by user
@@ -52,12 +54,10 @@ interface ExternalSourceDefinition {
   idColumn?: string;
   /** Transform an external row into the stored document body. Omit ⇒ every selected column except `idColumn` is copied. */
   map?: (row: Record<string, unknown>) => Record<string, unknown>;
-  /** Delete-detection mode. Defaults to `"full-pull"`. */
+  /** Delete-detection mode. `"full-pull"` (the default) is the only mode today. */
   mode?: ExternalSourceMode;
   /** The full tenant-membership query, with driver-native placeholders (`$1` / `?`). `tenantBy` binds its params. */
   query: string;
-  /** `"incremental"` only: run a full-pull reconcile this often to garbage-collect tombstones the incremental path can't see. */
-  reconcileEveryMs?: number;
   /** Poll cadence, or `"manual"`. Omit ⇒ the runtime's size-scaled default. */
   refresh?: ExternalSourceRefresh;
   /**
@@ -684,6 +684,21 @@ interface ScheduledJob {
   /** Routing hint forwarded so dispatch lands on the right shard. */
   shardKey?: string;
 }
+/**
+* A schedulable durable-workflow reference — the generated `workflows.&lt;name>` /
+* `agents.&lt;name>` object, which carries its `WORKFLOW_*`/`AGENT_*` binding and
+* stable name. Structural mirror of `@lunora/scheduler`'s `WorkflowReference` so
+* `ctx.scheduler` can target a workflow/agent without a dependency on
+* `@lunora/scheduler` / `@lunora/workflow`. A scheduled workflow target starts a
+* fresh instance on fire (the args become its `params`).
+*/
+interface SchedulableWorkflowReference {
+  /** The `WORKFLOW_*`/`AGENT_*` binding name (present on a generated ref). */
+  readonly binding?: string;
+  readonly isLunoraWorkflow: true;
+  /** The workflow/agent export/stable name (present on a generated ref). */
+  readonly name?: string;
+}
 interface Scheduler {
   /** Cancel a pending job by id. `cancelled` is `false` when no such job exists. */
   cancel: (id: string) => Promise<{
@@ -693,8 +708,15 @@ interface Scheduler {
   get: (id: string) => Promise<ScheduledJob | null>;
   /** List all pending scheduled jobs. */
   list: () => Promise<ScheduledJob[]>;
-  runAfter: (delayMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
-  runAt: (timestampMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
+  /**
+  * Schedule a one-shot run `delayMs` from now. `target` is a function path
+  * (`"ns:fn"`) dispatched as a one-shot, or a generated `workflows.&lt;name>` /
+  * `agents.&lt;name>` reference which starts a fresh durable instance on fire
+  * (the args become its `params`).
+  */
+  runAfter: (delayMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
+  /** Like {@link Scheduler.runAfter} but fires at an absolute epoch-ms timestamp. */
+  runAt: (timestampMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
 }
 /**
 * A workflow instance's lifecycle status. Clean public mirror of

package/dist/types.d.ts

@@ -28,12 +28,14 @@ type ExternalSourceRefresh = "manual" | {
   everyMs: number;
 };
 /**
-* Delete-detection mode for external-source ingest. `"full-pull"` (default) reads
-* the whole tenant membership each tick and diffs it, so it observes upstream
-* deletes; `"incremental"` pulls only changed rows (cheap) and is blind to deletes
-* unless paired with a soft-delete column or a `reconcileEveryMs` full-pull sweep.
+* Delete-detection mode for external-source ingest. `"full-pull"` (the default and
+* currently the only mode) reads the whole tenant membership each tick and diffs
+* it, so it observes upstream deletes. An `"incremental"` mode (pull only changed
+* rows above the ~10k full-pull cap) is not implemented yet — it needs durable
+* cursor/watermark machinery that does not exist; this alias is the seam it
+* returns through.
 */
-type ExternalSourceMode = "full-pull" | "incremental";
+type ExternalSourceMode = "full-pull";
 /**
 * Config for `.source(...)` (plan 077): declares a table as **materialized from an
 * external Postgres/MySQL behind Cloudflare Hyperdrive**, not written by user
@@ -52,12 +54,10 @@ interface ExternalSourceDefinition {
   idColumn?: string;
   /** Transform an external row into the stored document body. Omit ⇒ every selected column except `idColumn` is copied. */
   map?: (row: Record<string, unknown>) => Record<string, unknown>;
-  /** Delete-detection mode. Defaults to `"full-pull"`. */
+  /** Delete-detection mode. `"full-pull"` (the default) is the only mode today. */
   mode?: ExternalSourceMode;
   /** The full tenant-membership query, with driver-native placeholders (`$1` / `?`). `tenantBy` binds its params. */
   query: string;
-  /** `"incremental"` only: run a full-pull reconcile this often to garbage-collect tombstones the incremental path can't see. */
-  reconcileEveryMs?: number;
   /** Poll cadence, or `"manual"`. Omit ⇒ the runtime's size-scaled default. */
   refresh?: ExternalSourceRefresh;
   /**
@@ -684,6 +684,21 @@ interface ScheduledJob {
   /** Routing hint forwarded so dispatch lands on the right shard. */
   shardKey?: string;
 }
+/**
+* A schedulable durable-workflow reference — the generated `workflows.&lt;name>` /
+* `agents.&lt;name>` object, which carries its `WORKFLOW_*`/`AGENT_*` binding and
+* stable name. Structural mirror of `@lunora/scheduler`'s `WorkflowReference` so
+* `ctx.scheduler` can target a workflow/agent without a dependency on
+* `@lunora/scheduler` / `@lunora/workflow`. A scheduled workflow target starts a
+* fresh instance on fire (the args become its `params`).
+*/
+interface SchedulableWorkflowReference {
+  /** The `WORKFLOW_*`/`AGENT_*` binding name (present on a generated ref). */
+  readonly binding?: string;
+  readonly isLunoraWorkflow: true;
+  /** The workflow/agent export/stable name (present on a generated ref). */
+  readonly name?: string;
+}
 interface Scheduler {
   /** Cancel a pending job by id. `cancelled` is `false` when no such job exists. */
   cancel: (id: string) => Promise<{
@@ -693,8 +708,15 @@ interface Scheduler {
   get: (id: string) => Promise<ScheduledJob | null>;
   /** List all pending scheduled jobs. */
   list: () => Promise<ScheduledJob[]>;
-  runAfter: (delayMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
-  runAt: (timestampMs: number, functionPath: string, args?: Record<string, unknown>) => Promise<string>;
+  /**
+  * Schedule a one-shot run `delayMs` from now. `target` is a function path
+  * (`"ns:fn"`) dispatched as a one-shot, or a generated `workflows.&lt;name>` /
+  * `agents.&lt;name>` reference which starts a fresh durable instance on fire
+  * (the args become its `params`).
+  */
+  runAfter: (delayMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
+  /** Like {@link Scheduler.runAfter} but fires at an absolute epoch-ms timestamp. */
+  runAt: (timestampMs: number, target: SchedulableWorkflowReference | string, args?: Record<string, unknown>) => Promise<string>;
 }
 /**
 * A workflow instance's lifecycle status. Clean public mirror of

package/package.json

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