@lunora/server 1.0.0-alpha.183 → 1.0.0-alpha.184

package/dist/index.d.mts

@@ -358,9 +358,9 @@ type ComposedOut<Plugins extends ReadonlyArray<unknown>> = Plugins extends reado
  * `defineSchema` argument so a plugin can ship vector decls alongside its
  * tables.
  */
-interface SchemaExtension<T extends Record<string, TableDefinition> = Record<string, TableDefinition>> {
-  /** Stable key identifying the plugin that owns this extension. */
-  readonly key: string;
+interface SchemaExtension<T extends Record<string, TableDefinition> = Record<string, TableDefinition>, Key extends string = string> {
+  /** Stable key identifying the plugin that owns this extension. Kept literal, so `.extend()` adds exactly `<key>_<table>`. */
+  readonly key: Key;
   /**
    * Extension tables, keyed by **bare** name (e.g. `buckets`). At merge time
    * each is auto-prefixed with `key` (`ratelimit_buckets`) so it can't
@@ -378,10 +378,10 @@ interface SchemaExtension<T extends Record<string, TableDefinition> = Record<str
  * Build a {@link SchemaExtension}. The `key` is a runtime tag (used for
  * error messages on collision) and a type-level brand.
  */
-declare const defineSchemaExtension: <T extends Record<string, TableDefinition>>(key: string, options: {
+declare const defineSchemaExtension: <T extends Record<string, TableDefinition>, const Key extends string = string>(key: Key, options: {
   tables: T;
   vectorIndexes?: Record<string, VectorIndexDefinition>;
-}) => SchemaExtension<T>;
+}) => SchemaExtension<T, Key>;
 /**
  * A plugin packages an optional schema extension and optional middleware.
  * Both are independently usable: an app can install only the schema (e.g.
@@ -423,10 +423,10 @@ interface DefinePluginOptions<TExtension extends Record<string, TableDefinition>
  * 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>;
+  <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn, const Key extends string = string>(key: Key, options: DefinePluginOptions<TExtension, TContextIn, TContextOut> & {
+    extension: SchemaExtension<TExtension, Key>;
   }): Plugin<TExtension, TContextIn, TContextOut> & {
-    readonly extension: SchemaExtension<TExtension>;
+    readonly extension: SchemaExtension<TExtension, Key>;
   };
   <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut>): Plugin<TExtension, TContextIn, TContextOut>;
 }
@@ -1041,6 +1041,8 @@ declare const indexFieldsFromSchema: (schema: Schema) => IndexFieldsByTable;
 declare const defineSchema: <T extends Record<string, TableDefinition>>(tables: T, vectorIndexes?: Record<string, VectorIndexDefinition>, aggregateIndexes?: Record<string, AggregateIndexDefinition>, rankIndexes?: Record<string, RankIndexDefinition>) => ExtendableSchema<T>;
 /** Default lifetime of a cached entry: one hour. */
 declare const DEFAULT_ACTION_CACHE_TTL_MS: number;
+/** The bare extension key and table name. Prefixing makes the merged table `actionCache_entries`. */
+declare const ACTION_CACHE_KEY = "actionCache";
 declare const ACTION_CACHE_BARE_TABLE = "entries";
 /**
  * The prefixed table name the extension produces at merge time. The handlers and
@@ -1162,7 +1164,7 @@ type ActionCacheComponent = {
  */
 declare const actionCacheExtension: SchemaExtension<{
   [ACTION_CACHE_BARE_TABLE]: ReturnType<typeof defineTable>;
-}>;
+}, typeof ACTION_CACHE_KEY>;
 /**
  * Build an action-cache {@link Component} — schema extension, `purgeExpired`, and
  * the `wrap` / `invalidate` / `invalidateAll` helpers — wired to one TTL.
@@ -1397,6 +1399,8 @@ declare const beginDeferredSchedules: (context: DeferredScheduleContext) => ((co
  * secret". Extend it per app rather than relying on this list being complete.
  */
 declare const DEFAULT_REDACTED_FIELDS: ReadonlyArray<string>;
+/** The bare extension key and table name. Prefixing makes the merged table `documentHistory_versions`. */
+declare const DOCUMENT_HISTORY_KEY = "documentHistory";
 declare const DOCUMENT_HISTORY_BARE_TABLE = "versions";
 /** The prefixed table name the extension produces at merge time. */
 declare const DOCUMENT_HISTORY_TABLE: "documentHistory_versions";
@@ -1487,7 +1491,7 @@ type DocumentHistoryComponent = {
  */
 declare const documentHistoryExtension: SchemaExtension<{
   [DOCUMENT_HISTORY_BARE_TABLE]: ReturnType<typeof defineTable>;
-}>;
+}, typeof DOCUMENT_HISTORY_KEY>;
 /**
  * Build a document-history {@link Component} — schema extension, the
  * `.triggers()` recorder, and the `listForDocument` / `vacuum` functions.
@@ -3124,6 +3128,8 @@ interface RegisteredMutator<Args extends ValidatorMap = ValidatorMap, ServerCont
 declare const defineMutator: <Args extends ValidatorMap = ValidatorMap, ServerContext = MutationCtx, ClientTx = unknown, R = unknown>(definition: MutatorDefinition<Args, ServerContext, ClientTx, R>) => RegisteredMutator<Args, ServerContext, ClientTx, R>;
 /** Default time-to-live for a presence row: a heartbeat keeps a member "present" for this long. */
 declare const DEFAULT_TTL_MS = 3e4;
+/** The bare extension key and table name. Prefixing makes the merged table `presence_present`. */
+declare const PRESENCE_KEY = "presence";
 declare const PRESENCE_BARE_TABLE = "present";
 /**
  * The prefixed table name the extension produces at merge time. The handlers
@@ -3241,7 +3247,7 @@ type PresenceComponent = Component<{
  */
 declare const presenceExtension: SchemaExtension<{
   [PRESENCE_BARE_TABLE]: ReturnType<typeof defineTable>;
-}>;
+}, typeof PRESENCE_KEY>;
 /**
  * Build a presence {@link Component} — schema extension + heartbeat / listPresent
  * / sweep functions — wired to a single TTL. Re-export `component.functions`

package/dist/index.d.ts

@@ -358,9 +358,9 @@ type ComposedOut<Plugins extends ReadonlyArray<unknown>> = Plugins extends reado
  * `defineSchema` argument so a plugin can ship vector decls alongside its
  * tables.
  */
-interface SchemaExtension<T extends Record<string, TableDefinition> = Record<string, TableDefinition>> {
-  /** Stable key identifying the plugin that owns this extension. */
-  readonly key: string;
+interface SchemaExtension<T extends Record<string, TableDefinition> = Record<string, TableDefinition>, Key extends string = string> {
+  /** Stable key identifying the plugin that owns this extension. Kept literal, so `.extend()` adds exactly `<key>_<table>`. */
+  readonly key: Key;
   /**
    * Extension tables, keyed by **bare** name (e.g. `buckets`). At merge time
    * each is auto-prefixed with `key` (`ratelimit_buckets`) so it can't
@@ -378,10 +378,10 @@ interface SchemaExtension<T extends Record<string, TableDefinition> = Record<str
  * Build a {@link SchemaExtension}. The `key` is a runtime tag (used for
  * error messages on collision) and a type-level brand.
  */
-declare const defineSchemaExtension: <T extends Record<string, TableDefinition>>(key: string, options: {
+declare const defineSchemaExtension: <T extends Record<string, TableDefinition>, const Key extends string = string>(key: Key, options: {
   tables: T;
   vectorIndexes?: Record<string, VectorIndexDefinition>;
-}) => SchemaExtension<T>;
+}) => SchemaExtension<T, Key>;
 /**
  * A plugin packages an optional schema extension and optional middleware.
  * Both are independently usable: an app can install only the schema (e.g.
@@ -423,10 +423,10 @@ interface DefinePluginOptions<TExtension extends Record<string, TableDefinition>
  * 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>;
+  <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn, const Key extends string = string>(key: Key, options: DefinePluginOptions<TExtension, TContextIn, TContextOut> & {
+    extension: SchemaExtension<TExtension, Key>;
   }): Plugin<TExtension, TContextIn, TContextOut> & {
-    readonly extension: SchemaExtension<TExtension>;
+    readonly extension: SchemaExtension<TExtension, Key>;
   };
   <TExtension extends Record<string, TableDefinition>, TContextIn = unknown, TContextOut = TContextIn>(key: string, options: DefinePluginOptions<TExtension, TContextIn, TContextOut>): Plugin<TExtension, TContextIn, TContextOut>;
 }
@@ -1041,6 +1041,8 @@ declare const indexFieldsFromSchema: (schema: Schema) => IndexFieldsByTable;
 declare const defineSchema: <T extends Record<string, TableDefinition>>(tables: T, vectorIndexes?: Record<string, VectorIndexDefinition>, aggregateIndexes?: Record<string, AggregateIndexDefinition>, rankIndexes?: Record<string, RankIndexDefinition>) => ExtendableSchema<T>;
 /** Default lifetime of a cached entry: one hour. */
 declare const DEFAULT_ACTION_CACHE_TTL_MS: number;
+/** The bare extension key and table name. Prefixing makes the merged table `actionCache_entries`. */
+declare const ACTION_CACHE_KEY = "actionCache";
 declare const ACTION_CACHE_BARE_TABLE = "entries";
 /**
  * The prefixed table name the extension produces at merge time. The handlers and
@@ -1162,7 +1164,7 @@ type ActionCacheComponent = {
  */
 declare const actionCacheExtension: SchemaExtension<{
   [ACTION_CACHE_BARE_TABLE]: ReturnType<typeof defineTable>;
-}>;
+}, typeof ACTION_CACHE_KEY>;
 /**
  * Build an action-cache {@link Component} — schema extension, `purgeExpired`, and
  * the `wrap` / `invalidate` / `invalidateAll` helpers — wired to one TTL.
@@ -1397,6 +1399,8 @@ declare const beginDeferredSchedules: (context: DeferredScheduleContext) => ((co
  * secret". Extend it per app rather than relying on this list being complete.
  */
 declare const DEFAULT_REDACTED_FIELDS: ReadonlyArray<string>;
+/** The bare extension key and table name. Prefixing makes the merged table `documentHistory_versions`. */
+declare const DOCUMENT_HISTORY_KEY = "documentHistory";
 declare const DOCUMENT_HISTORY_BARE_TABLE = "versions";
 /** The prefixed table name the extension produces at merge time. */
 declare const DOCUMENT_HISTORY_TABLE: "documentHistory_versions";
@@ -1487,7 +1491,7 @@ type DocumentHistoryComponent = {
  */
 declare const documentHistoryExtension: SchemaExtension<{
   [DOCUMENT_HISTORY_BARE_TABLE]: ReturnType<typeof defineTable>;
-}>;
+}, typeof DOCUMENT_HISTORY_KEY>;
 /**
  * Build a document-history {@link Component} — schema extension, the
  * `.triggers()` recorder, and the `listForDocument` / `vacuum` functions.
@@ -3124,6 +3128,8 @@ interface RegisteredMutator<Args extends ValidatorMap = ValidatorMap, ServerCont
 declare const defineMutator: <Args extends ValidatorMap = ValidatorMap, ServerContext = MutationCtx, ClientTx = unknown, R = unknown>(definition: MutatorDefinition<Args, ServerContext, ClientTx, R>) => RegisteredMutator<Args, ServerContext, ClientTx, R>;
 /** Default time-to-live for a presence row: a heartbeat keeps a member "present" for this long. */
 declare const DEFAULT_TTL_MS = 3e4;
+/** The bare extension key and table name. Prefixing makes the merged table `presence_present`. */
+declare const PRESENCE_KEY = "presence";
 declare const PRESENCE_BARE_TABLE = "present";
 /**
  * The prefixed table name the extension produces at merge time. The handlers
@@ -3241,7 +3247,7 @@ type PresenceComponent = Component<{
  */
 declare const presenceExtension: SchemaExtension<{
   [PRESENCE_BARE_TABLE]: ReturnType<typeof defineTable>;
-}>;
+}, typeof PRESENCE_KEY>;
 /**
  * Build a presence {@link Component} — schema extension + heartbeat / listPresent
  * / sweep functions — wired to a single TTL. Re-export `component.functions`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/server",
-  "version": "1.0.0-alpha.183",
+  "version": "1.0.0-alpha.184",
   "description": "Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action",
   "keywords": [
     "backend",