cloesce 0.0.5-unstable.4 → 0.0.5-unstable.6

package/dist/router/wasm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../../src/router/wasm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAS,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;IAC3B,cAAc,IAAI,MAAM,CAAC;IACzB,cAAc,IAAI,MAAM,CAAC;IACzB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,OAAO,CACL,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAEX,YAAY,CACV,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAEX,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,IAAI;IACL,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;gBAFV,IAAI,EAAE,cAAc,EACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM;IAEpB,IAAI;IAIJ;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,YAAY;CAQnE;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,IAAI,CAAC,EAAE,WAAW,CAAC,QAAQ,GAC1B,OAAO,CAAC,cAAc,CAAC,CAmBzB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,EAClC,IAAI,EAAE,YAAY,EAAE,EACpB,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EACrC,IAAI,EAAE,UAAU,CAAC,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC9B,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,eAAe,GAAG,IAAI,GACnD,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CA0DrB"}
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../../src/router/wasm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAKtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;IAC3B,cAAc,IAAI,MAAM,CAAC;IACzB,cAAc,IAAI,MAAM,CAAC;IACzB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,YAAY,CACV,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAEX,YAAY,CACV,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAEX,GAAG,CACD,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;CACZ;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,IAAI;IACL,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IAHpB,OAAO;IAMP,IAAI;IAIJ;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,YAAY;CASnE;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,IAAI,CAAC,EAAE,WAAW,CAAC,QAAQ,GAC1B,OAAO,CAAC,cAAc,CAAC,CA2BzB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,EAClC,IAAI,EAAE,YAAY,EAAE,EACpB,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB"}

package/dist/router/wasm.js

@@ -1,10 +1,6 @@
-import { RuntimeContainer } from "./router.js";
-// Requires the ORM binary to have been built
+import { Either } from "../common.js";
+// NOTE: Requires the ORM binary to have been built
 import mod from "../orm.wasm";
-import { Either } from "../ui/common.js";
-/**
- * RAII for wasm memory
- */
 export class WasmResource {
     wasm;
     ptr;
@@ -18,9 +14,12 @@ export class WasmResource {
         this.wasm.dealloc(this.ptr, this.len);
     }
     /**
-     * Copies a value from TS memory to WASM memory. A subsequent `free` is necessary.
+     * Copies a value from TS memory to WASM memory.
+     *
+     * A subsequent call to `free` is necessary.
      */
     static fromString(str, wasm) {
+        // TODO: Would be interesting to optimize this to avoid the intermediate copy
         const encoder = new TextEncoder();
         const bytes = encoder.encode(str);
         const ptr = wasm.alloc(bytes.length);
@@ -36,7 +35,10 @@ export async function loadOrmWasm(ast, wasm) {
     const modelMeta = WasmResource.fromString(JSON.stringify(ast.models), wasmInstance.exports);
     if (wasmInstance.exports.set_meta_ptr(modelMeta.ptr, modelMeta.len) != 0) {
         modelMeta.free();
-        throw Error("The WASM Module failed to load due to an invalid CIDL");
+        const resPtr = wasmInstance.exports.get_return_ptr();
+        const resLen = wasmInstance.exports.get_return_len();
+        const errorMsg = new TextDecoder().decode(new Uint8Array(wasmInstance.exports.memory.buffer, resPtr, resLen));
+        throw Error(`"The WASM Module failed to load due to an invalid CIDL: ${errorMsg}`);
     }
     // Intentionally leak `modelMeta`, it should exist for the programs lifetime.
     return wasmInstance.exports;
@@ -63,44 +65,3 @@ export function invokeOrmWasm(fn, args, wasm) {
             wasm.dealloc(resPtr, resLen);
     }
 }
-/**
- * Calls the object relational mapping function to turn a row of SQL records into
- * an instantiated object.
- */
-export function mapSql(ctor, records, includeTree) {
-    const { ast, constructorRegistry, wasm } = RuntimeContainer.get();
-    const args = [
-        WasmResource.fromString(ctor.name, wasm),
-        WasmResource.fromString(JSON.stringify(records), wasm),
-        WasmResource.fromString(JSON.stringify(includeTree), wasm),
-    ];
-    const jsonResults = invokeOrmWasm(wasm.map_sql, args, wasm);
-    if (jsonResults.isLeft())
-        return jsonResults;
-    const parsed = JSON.parse(jsonResults.value);
-    return Either.right(parsed.map((obj) => instantiateDepthFirst(obj, ast.models[ctor.name], includeTree)));
-    // TODO: Lazy instantiation via Proxy?
-    function instantiateDepthFirst(m, meta, includeTree) {
-        m = Object.assign(new constructorRegistry[meta.name](), m);
-        if (!includeTree) {
-            return m;
-        }
-        for (const navProp of meta.navigation_properties) {
-            const nestedIncludeTree = includeTree[navProp.var_name];
-            if (!nestedIncludeTree)
-                continue;
-            const nestedMeta = ast.models[navProp.model_name];
-            // One to Many, Many to Many
-            if (Array.isArray(m[navProp.var_name])) {
-                for (let i = 0; i < m[navProp.var_name].length; i++) {
-                    m[navProp.var_name][i] = instantiateDepthFirst(m[navProp.var_name][i], nestedMeta, nestedIncludeTree);
-                }
-            }
-            // One to one
-            else if (m[navProp.var_name]) {
-                m[navProp.var_name] = instantiateDepthFirst(m[navProp.var_name], nestedMeta, nestedIncludeTree);
-            }
-        }
-        return m;
-    }
-}

package/dist/ui/backend.d.ts

@@ -1,63 +1,111 @@
-import { D1Database } from "@cloudflare/workers-types/experimental/index.js";
-import { DeepPartial, Either, KeysOfType } from "./common.js";
-import { CrudKind } from "../ast.js";
+import { CrudKind, MediaType } from "../ast.js";
 /**
  * cloesce/backend
  */
-export { CloesceApp, DependencyContainer as DependencyInjector, } from "../router/router.js";
+export { CloesceApp, DependencyContainer } from "../router/router.js";
 export type { MiddlewareFn, ResultMiddlewareFn } from "../router/router.js";
-export { HttpResult, Either, Stream } from "./common.js";
-export type { DeepPartial } from "./common.js";
 export type { CrudKind } from "../ast.js";
+export { Orm } from "../router/orm.js";
+export { R2ObjectBody } from "@cloudflare/workers-types";
 /**
- * Marks a class as a D1-backed SQL model.
+ * Base class for a Cloudflare KV model or navigation property.
  *
- * Classes annotated with `@D1` are compiled into:
- *  - a D1 table definition (via `cloesce migrate`)
- *  - backend API endpoints (Workers)
- *  - a frontend client API
- *  - Cloudflare Wrangler configurations
+ * Consists of a `key`, `value`, and optional `metadata`.
  *
- * Each `@D1` class must define exactly one `@PrimaryKey`.
+ * @template V The type of the value stored in the KValue. Note that KV is schema-less,
+ * so this type is not enforced at runtime, but serves as the type the client expects.
  *
- * Example:
- *```ts
- *  ＠D1
- *  export class Horse {
- *    ＠PrimaryKey id: number;
- *    name: string;
- *  }
- * ```
+ * @remarks
+ * - The `key` is a string that uniquely identifies the entry in the KV store.
+ * - The `value` is of generic type `V`, allowing flexibility in the type of data stored.
+ * - `V` must be serializable to JSON.
+ * - The `metadata` can hold any additional information associated with the KV entry.
  */
-export declare const D1: ClassDecorator;
-export declare const Service: ClassDecorator;
+export declare class KValue<V> {
+    key: string;
+    raw: unknown | null;
+    metadata: unknown | null;
+    get value(): V | null;
+}
 /**
- * Marks a class as a plain serializable object.
+ * The result of a Workers endpoint.
  *
- * `@PlainOldObject` types represent data that can be safely
- * returned from a model method or API endpoint without being
- * treated as a database model.
+ * @param ok True if `status` < 400
+ * @param status The HTTP Status of a Workers request
+ * @param headers All headers that the result is to be sent with or was received with
+ * @param data JSON data yielded from a request, undefined if the request was not `ok`.
+ * @param message An error text set if the request was not `ok`.
  *
- * Example:
+ * @remarks If `status` is 204 `data` will always be undefined.
+ *
+ */
+export declare class HttpResult<T = unknown> {
+    ok: boolean;
+    status: number;
+    headers: Headers;
+    data?: T | undefined;
+    message?: string | undefined;
+    mediaType?: MediaType | undefined;
+    constructor(ok: boolean, status: number, headers: Headers, data?: T | undefined, message?: string | undefined, mediaType?: MediaType | undefined);
+    static ok<T>(status: number, data?: T, init?: HeadersInit): HttpResult;
+    static fail(status: number, message?: string, init?: HeadersInit): HttpResult<never>;
+    toResponse(): Response;
+    setMediaType(mediaType: MediaType): this;
+}
+type DeepPartialInner<T> = T extends (infer U)[] ? DeepPartialInner<U>[] : T extends object ? {
+    [K in keyof T]?: DeepPartialInner<T[K]>;
+} : T | (null extends T ? null : never);
+/**
+ * Recursively makes all properties of a type optional — including nested objects and arrays.
+ *
+ * Similar to TypeScript's built-in `Partial<T>`, but applies the transformation deeply across
+ * all nested structures. Useful for defining "patch" or "update" objects where only a subset
+ * of properties may be provided.
+ *
+ * **Apart of the Cloesce method grammar**, meaning the type can be apart of method parameters
+ * or return types and the generated workers and client API will act accordingly.
+ *
+ * @template T
+ * The target type to make deeply partial.
+ *
+ * @remarks
+ * - **Objects:** All properties become optional, and their values are recursively wrapped in `DeepPartial`.
+ * - **Arrays:** Arrays are preserved, but their elements are recursively made partial.
+ * - **Scalars:** Primitive values (string, number, boolean, etc.) remain unchanged.
+ * - **Nullable types:** If `null` is assignable to the type, it remains allowed.
+ *
+ * @example
  * ```ts
- * ＠PlainOldObject
- * export class CatStuff {
- *   catFacts: string[];
- *   catNames: string[];
+ * class User {
+ *   id: string;
+ *   profile: {
+ *     name: string;
+ *     age: number;
+ *   };
+ *   tags: string[];
  * }
  *
- * // in a method...
- * foo(): CatStuff {
- *   return {
- *    catFacts: ["cats sleep 16 hours a day"],
- *   catNames: ["Whiskers", "Fluffy"]
- *  };
- *
- * // which generates an API like:
- * async function foo(): Promise<HttpResult<CatStuff>> { ... }
+ * // The resulting type:
+ * // {
+ * //   id?: string;
+ * //   profile?: { name?: string; age?: number };
+ * //   tags?: (string | undefined)[];
+ * // }
+ * type PartialUser = DeepPartial<User>;
+ *
+ * const patch: PartialUser = {
+ *   profile: { age: 30 } // ok
+ * };
  * ```
  */
-export declare const PlainOldObject: ClassDecorator;
+export type DeepPartial<T> = DeepPartialInner<T> & {
+    __brand?: "Partial";
+};
+export type KeysOfType<T, U> = {
+    [K in keyof T]: T[K] extends U ? (K extends string ? K : never) : never;
+}[keyof T];
+export declare const Model: (_kinds?: CrudKind[]) => ClassDecorator;
+export declare const Service: ClassDecorator;
 /**
  * Declares a Wrangler environment definition.
  *
@@ -97,6 +145,9 @@ export declare const WranglerEnv: ClassDecorator;
  * ```
  */
 export declare const PrimaryKey: PropertyDecorator;
+export declare const KeyParam: PropertyDecorator;
+export declare const KV: (_keyFormat?: string, _namespaceBinding?: string) => PropertyDecorator;
+export declare const R2: (_keyFormat?: string, _bucketBinding?: string) => PropertyDecorator;
 /**
  * Exposes a class method as an HTTP GET endpoint.
  * The method will appear in both backend and generated client APIs.
@@ -122,100 +173,8 @@ export declare const PATCH: MethodDecorator;
  * The method will appear in both backend and generated client APIs.
  */
 export declare const DELETE: MethodDecorator;
-/**
- * Declares a static property as a data source.
- *
- * Data sources describe SQL left joins related to each
- * models navigation properties.
- *
- * Example:
- * ```ts
- * ＠D1
- * export class Dog {
- *   ＠PrimaryKey
- *   id: number;
- *
- *   name: string;
- * }
- *
- * ＠D1
- * export class Person {
- *   ＠PrimaryKey
- *   id: number;
- *
- *   @ForeignKey(Dog)
- *   dogId: number;
- *
- *   @OneToOne("dogId")
- *   dog: Dog | undefined;
- *
- *   ＠DataSource
- *   static readonly default: IncludeTree<Person> = {
- *     dog: {}, // join Dog table when querying Person with `default` data source
- *   };
- * }
- *
- * // When queried via the ORM or client API:
- * const orm = Orm.fromD1(env.db);
- * const people = await orm.list(Person, Person.default);
- *
- * // => Person { id: 1, dogId: 2, dog: { id: 2, name: "Fido" } }[]
- * ```
- */
-export declare const DataSource: PropertyDecorator;
-/**
- * Declares a one-to-many relationship between models.
- *
- * The argument is the foreign key property name on the
- * related model.
- *
- * Example:
- * ```ts
- * ＠OneToMany("personId")
- * dogs: Dog[];
- * ```
- */
-export declare const OneToMany: (_foreignKeyColumn: string) => PropertyDecorator;
-/**
- * Declares a one-to-one relationship between models.
- *
- * The argument is the foreign key property name that links
- * the two tables.
- *
- * Example:
- * ```ts
- * ＠OneToOne("dogId")
- * dog: Dog | undefined;
- * ```
- */
-export declare const OneToOne: (_foreignKeyColumn: string) => PropertyDecorator;
-/**
- * Declares a many-to-many relationship between models.
- *
- * The argument is a unique identifier for the generated
- * junction table used to connect the two entities.
- *
- * Example:
- * ```ts
- * ＠ManyToMany("StudentsCourses")
- * courses: Course[];
- * ```
- */
-export declare const ManyToMany: (_uniqueId: string) => PropertyDecorator;
-/**
- * Declares a foreign key relationship between models.
- * Directly translates to a SQLite foreign key.
- *
- * The argument must reference either a model class or the
- * name of a model class as a string. The property type must
- * match the target model’s primary key type.
- *
- * Example:
- * ```ts
- * ＠ForeignKey(Dog)
- * dogId: number;
- * ```
- */
+export declare function OneToMany<T>(_selector: (model: T) => T[keyof T]): PropertyDecorator;
+export declare function OneToOne<T>(_selector: (model: T) => T[keyof T]): PropertyDecorator;
 export declare const ForeignKey: <T>(_Model: T | string) => PropertyDecorator;
 /**
  * Marks a method parameter for dependency injection.
@@ -235,35 +194,6 @@ export declare const ForeignKey: <T>(_Model: T | string) => PropertyDecorator;
  * ```
  */
 export declare const Inject: ParameterDecorator;
-/**
- * Enables automatic CRUD method generation for a model.
- *
- * The argument is a list of CRUD operation kinds
- * (e.g. `"SAVE"`, `"GET"`, `"LIST"`) to generate for the model.
- *
- * Cloesce will emit corresponding backend methods and frontend
- * client bindings automatically, removing the need to manually
- * define common API operations.
- *
- * CRUD Operations:
- * - **"SAVE"** — Performs an *upsert* (insert, update, or both) for a model instance.
- * - **"GET"** — Retrieves a single record by its primary key, optionally using a `DataSource`.
- * - **"LIST"** — Retrieves all records for the model, using the specified `DataSource`.
- *
- * The generated methods are static, exposed through both the backend
- * and the frontend client API.
- *
- * Example:
- * ```ts
- * ＠CRUD(["SAVE", "GET", "LIST"])
- * ＠D1
- * export class CrudHaver {
- *   ＠PrimaryKey id: number;
- *   name: string;
- * }
- * ```
- */
-export declare const CRUD: (_kinds: CrudKind[]) => ClassDecorator;
 type Primitive = string | number | boolean | bigint | symbol | null | undefined;
 /**
  * A recursive type describing which related models to include
@@ -344,180 +274,4 @@ export type DataSourceOf<T extends object> = (KeysOfType<T, IncludeTree<T>> | "n
 export type Integer = number & {
     __brand?: "Integer";
 };
-/**
- * Exposes the ORM primitives Cloesce uses to interact with D1 databases.
- */
-export declare class Orm {
-    private db;
-    private constructor();
-    /**
-     * Creates an instance of an `Orm`
-     * @param db The database to use for ORM calls.
-     */
-    static fromD1(db: D1Database): Orm;
-    /**
-     * Maps SQL records to an instantiated Model. The records must be flat
-     * (e.g., of the form "id, name, address") or derive from a Cloesce data source view
-     * (e.g., of the form "Horse.id, Horse.name, Horse.address")
-     *
-     * Assumes the data is formatted correctly, throwing an error otherwise.
-     *
-     * @param ctor The model constructor
-     * @param records D1 Result records
-     * @param includeTree Include tree to define the relationships to join.
-     */
-    static mapSql<T extends object>(ctor: new () => T, records: Record<string, any>[], includeTree?: IncludeTree<T> | null): T[];
-    /**
-     * Executes an "upsert" query, adding or augmenting a model in the database.
-     *
-     * If a model's primary key is not defined in `newModel`, the query is assumed to be an insert.
-     *
-     * If a model's primary key _is_ defined, but some attributes are missing, the query is assumed to be an update.
-     *
-     * Finally, if the primary key is defined, but all attributes are included, a SQLite upsert will be performed.
-     *
-     * In any other case, an error string will be returned.
-     *
-     * ### Inserting a new Model
-     * ```ts
-     * const model = {name: "julio", lastname: "pumpkin"};
-     * const idRes = await orm.upsert(Person, model, null);
-     * ```
-     *
-     * ### Updating an existing model
-     * ```ts
-     * const model =  {id: 1, name: "timothy"};
-     * const idRes = await orm.upsert(Person, model, null);
-     * // (in db)=> {id: 1, name: "timothy", lastname: "pumpkin"}
-     * ```
-     *
-     * ### Upserting a model
-     * ```ts
-     * // (assume a Person already exists)
-     * const model = {
-     *  id: 1,
-     *  lastname: "burger", // updates last name
-     *  dog: {
-     *    name: "fido" // insert dog relationship
-     *  }
-     * };
-     * const idRes = await orm.upsert(Person, model, null);
-     * // (in db)=> Person: {id: 1, dogId: 1 ...}  ; Dog: {id: 1, name: "fido"}
-     * ```
-     *
-     * @param ctor A model constructor.
-     * @param newModel The new or augmented model.
-     * @param includeTree An include tree describing which foreign keys to join.
-     * @returns An error string, or the primary key of the inserted model.
-     */
-    upsert<T extends object>(ctor: new () => T, newModel: DeepPartial<T>, includeTree?: IncludeTree<T> | null): Promise<Either<string, any>>;
-    /**
-     * Returns a select query, creating a CTE view for the model using the provided include tree.
-     *
-     * @param ctor The model constructor.
-     * @param includeTree An include tree describing which related models to join.
-     * @param from An optional custom `FROM` clause to use instead of the base table.
-     * @param tagCte An optional CTE name to tag the query with. Defaults to "Model.view".
-     *
-     * ### Example:
-     * ```ts
-     * // Using a data source
-     * const query = Orm.listQuery(Person, "default");
-     *
-     * // Using a custom from statement
-     * const query = Orm.listQuery(Person, null, "SELECT * FROM Person WHERE age > 18");
-     * ```
-     *
-     * ### Example SQL output:
-     * ```sql
-     * WITH Person_view AS (
-     * SELECT
-     * "Person"."id" AS "id",
-     * ...
-     * FROM "Person"
-     * LEFT JOIN ...
-     * )
-     * SELECT * FROM Person_view
-     * ```
-     */
-    static listQuery<T extends object>(ctor: new () => T, opts: {
-        includeTree?: IncludeTree<T> | null;
-        from?: string;
-        tagCte?: string;
-    }): string;
-    /**
-     * Returns a select query for a single model by primary key, creating a CTE view using the provided include tree.
-     *
-     * @param ctor The model constructor.
-     * @param includeTree An include tree describing which related models to join.
-     *
-     * ### Example:
-     * ```ts
-     * // Using a data source
-     * const query = Orm.getQuery(Person, "default");
-     * ```
-     *
-     * ### Example SQL output:
-     *
-     * ```sql
-     * WITH Person_view AS (
-     * SELECT
-     * "Person"."id" AS "id",
-     * ...
-     * FROM "Person"
-     * LEFT JOIN ...
-     * )
-     * SELECT * FROM Person_view WHERE [Person].[id] = ?
-     * ```
-     */
-    static getQuery<T extends object>(ctor: new () => T, includeTree?: IncludeTree<T> | null): string;
-    /**
-     * Retrieves all instances of a model from the database.
-     * @param ctor The model constructor.
-     * @param includeTree An include tree describing which related models to join.
-     * @param from An optional custom `FROM` clause to use instead of the base table.
-     * @returns Either an error string, or an array of model instances.
-     *
-     * ### Example:
-     * ```ts
-     * const orm = Orm.fromD1(env.db);
-     * const horses = await orm.list(Horse, Horse.default);
-     * ```
-     *
-     * ### Example with custom from:
-     * ```ts
-     * const orm = Orm.fromD1(env.db);
-     * const adultHorses = await orm.list(Horse, Horse.default, "SELECT * FROM Horse ORDER BY age DESC LIMIT 10");
-     * ```
-     *
-     * =>
-     *
-     * ```sql
-     * SELECT
-     *  "Horse"."id" AS "id",
-     * ...
-     * FROM (SELECT * FROM Horse ORDER BY age DESC LIMIT 10)
-     * LEFT JOIN ...
-     * ```
-     *
-     */
-    list<T extends object>(ctor: new () => T, opts: {
-        includeTree?: IncludeTree<T> | null;
-        from?: string;
-    }): Promise<Either<string, T[]>>;
-    /**
-     * Retrieves a single model by primary key.
-     * @param ctor The model constructor.
-     * @param id The primary key value.
-     * @param includeTree An include tree describing which related models to join.
-     * @returns Either an error string, or the model instance (null if not found).
-     *
-     * ### Example:
-     * ```ts
-     * const orm = Orm.fromD1(env.db);
-     * const horse = await orm.get(Horse, 1, Horse.default);
-     * ```
-     */
-    get<T extends object>(ctor: new () => T, id: any, includeTree?: IncludeTree<T> | null): Promise<Either<string, T | null>>;
-}
 //# sourceMappingURL=backend.d.ts.map

package/dist/ui/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/ui/backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/ui/backend.ts"],"names":[],"mappings":"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"}