toilscript 0.1.33 → 0.1.34

package/dist/importmap.json

@@ -1,7 +1,7 @@
 {
   "imports": {
-    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.33/dist/toilscript.js",
-    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.33/dist/cli.js",
+    "toilscript": "https://cdn.jsdelivr.net/npm/toilscript@0.1.34/dist/toilscript.js",
+    "toilscript/cli": "https://cdn.jsdelivr.net/npm/toilscript@0.1.34/dist/cli.js",
     "binaryen": "https://cdn.jsdelivr.net/npm/binaryen@130.0.0-nightly.20260609/index.js",
     "long": "https://cdn.jsdelivr.net/npm/long@5.3.2/index.js"
   }

package/dist/toilscript.generated.d.ts

@@ -2962,6 +2962,15 @@ declare module "types:toilscript/src/parser" {
         ratelimitRouteCounter: number;
         /** An array of parsed sources. */
         sources: Source[];
+        /** A `@data` value type's generated field reads (the `decodeFrom` body, `__o.`
+         *  form) keyed by class name, captured so `finish()` can regenerate `decodeInto`
+         *  with a `@migrate` version-dispatch prefix. */
+        toildbCodecReads: Map<string, string>;
+        /** A `@data` value type's declaration, keyed by class name (to find/replace its
+         *  `decodeInto` member when weaving migrations). */
+        toildbCodecClasses: Map<string, ClassDeclaration>;
+        /** Guards `weaveDataMigrations` so it runs exactly once (before element creation). */
+        toildbWoven: boolean;
         /** Current overridden module name. */
         currentModuleName: string | null;
         /** Compiler options. */
@@ -2984,6 +2993,9 @@ declare module "types:toilscript/src/parser" {
         getDependee(dependent: string): string | null;
         /** Finishes parsing. */
         finish(): void;
+        weaveDataMigrations(): void;
+        /** Replace `newType`'s generated `decodeInto` with a version-dispatching one. */
+        private weaveDecodeInto;
         private checkToilDbKinds;
         /** Map every `@database` class (incl. inside namespaces) to its
          *  collection-name -> handle-family-name. */
@@ -4270,6 +4282,43 @@ declare module "types:toilscript/src/program" {
 }
 declare module "types:toilscript/src/dbcatalog" {
     import { Program } from "types:toilscript/src/program";
+    import { Source } from "types:toilscript/src/ast";
+    import { ClassDeclaration } from "types:toilscript/src/ast";
+    /** FNV-1a 32-bit hash, matching `dataTypeId` in the parser. */
+    export function fnv1a(name: string): number;
+    /** One field of a `@data` value type, in declaration order. */
+    export class FieldLayout {
+        name: string;
+        typeName: string;
+        isArray: boolean;
+    }
+    /**
+     * `schema_version`: a hash over the ORDERED field layout (name, type, is_array),
+     * NOT the value-type name. Adding, removing, retyping, or REORDERING a field
+     * changes it - so the runtime can tell a compatible (append-only) change from a
+     * breaking one, instead of silently misreading old rows. (Flat, like toildb's
+     * `SchemaDescriptor::layout_hash`: a change to a NESTED `@data` type's own fields
+     * does not bump the parent - that lands with recursive layouts later.)
+     */
+    export function layoutHash(fields: FieldLayout[]): number;
+    /** Extract the encoded field layout of a `@data` class, in declaration order,
+     *  mirroring `injectDataCodec` (skip static; `Array<T>` -> element + array flag;
+     *  else scalar/string/`Uint8Array`/nested-`@data` by its type name). */
+    export function dataFields(cls: ClassDeclaration): FieldLayout[];
+    /** A `@migrate` free function `fn(old: OldType): NewType`. `oldVersion` is the
+     *  layout hash of `OldType` - i.e. the `schema_version` the old rows were written
+     *  under - so a read can dispatch on it and run the transform (lazy migration). */
+    export class DataMigration {
+        oldType: string;
+        newType: string;
+        fnName: string;
+        oldVersion: number;
+    }
+    /** Every `@migrate` function across the (non-library) sources. `layouts` maps a
+     *  `@data` class name to its field layout, for the old-version hash. A migration
+     *  whose param/return is not a single named type, or whose old type has no
+     *  layout, is skipped. */
+    export function collectMigrations(sources: Source[], layouts: Map<string, FieldLayout[]>): DataMigration[];
     /**
      * Build the `toildb.catalog` section bytes, or `null` if the program declares
      * no `@database`.
@@ -7883,7 +7932,8 @@ declare module "types:toilscript/src/ast" {
         Action = 34,
         Job = 35,
         Derive = 36,
-        Admin = 37
+        Migrate = 37,
+        Admin = 38
     }
     export namespace DecoratorKind {
         /** Returns the kind of the specified decorator name node. Defaults to {@link DecoratorKind.CUSTOM}. */