cloesce 0.0.4-unstable.8 → 0.0.5-unstable.0

package/dist/common.d.ts

@@ -1,330 +0,0 @@
-export declare enum ExtractorErrorCode {
-    MissingExport = 0,
-    AppMissingDefaultExport = 1,
-    UnknownType = 2,
-    MultipleGenericType = 3,
-    InvalidDataSourceDefinition = 4,
-    InvalidPartialType = 5,
-    InvalidIncludeTree = 6,
-    InvalidAttributeModifier = 7,
-    InvalidApiMethodModifier = 8,
-    UnknownNavigationPropertyReference = 9,
-    InvalidNavigationPropertyReference = 10,
-    MissingNavigationPropertyReference = 11,
-    MissingManyToManyUniqueId = 12,
-    MissingPrimaryKey = 13,
-    MissingDatabaseBinding = 14,
-    MissingWranglerEnv = 15,
-    TooManyWranglerEnvs = 16,
-    MissingFile = 17
-}
-export declare function getErrorInfo(code: ExtractorErrorCode): {
-    description: string;
-    suggestion: string;
-};
-export declare class ExtractorError {
-    code: ExtractorErrorCode;
-    context?: string;
-    snippet?: string;
-    constructor(code: ExtractorErrorCode);
-    addContext(fn: (val: string | undefined) => string | undefined): void;
-}
-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
- * class User {
- *   id: string;
- *   profile: {
- *     name: string;
- *     age: number;
- *   };
- *   tags: string[];
- * }
- *
- * // 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 type DeepPartial<T> = DeepPartialInner<T> & {
-    __brand?: "Partial";
-};
-export declare class Either<L, R> {
-    private readonly inner;
-    private constructor();
-    get value(): L | R;
-    static left<L, R = never>(value: L): Either<L, R>;
-    static right<R, L = never>(value: R): Either<L, R>;
-    isLeft(): this is Either<L, never>;
-    isRight(): this is Either<never, R>;
-    unwrap(): R;
-    unwrapLeft(): L;
-    map<B>(fn: (val: R) => B): Either<L, B>;
-    mapLeft<B>(fn: (val: L) => B): Either<B, R>;
-}
-/**
- * Represents the result of an HTTP operation in a monadic style.
- *
- * This type provides a uniform way to handle both success and error
- * outcomes of HTTP requests, similar to a `Result` or `Either` monad.
- *
- * It ensures that every HTTP response can be handled in a type-safe,
- * predictable way without throwing exceptions.
- *
- * @template T The type of the successful response data.
- *
- * @property {boolean} ok
- * Indicates whether the HTTP request was successful (`true` for success, `false` for error).
- * This is analogous to `Response.ok` in the Fetch API.
- *
- * @property {number} status
- * The numeric HTTP status code (e.g., 200, 404, 500).
- *
- * @property {T} [data]
- * The parsed response payload, present only when `ok` is `true`.
- *
- * @property {string} [message]
- * An optional human-readable error message or diagnostic information,
- * typically provided when `ok` is `false`.
- *
- * ## Worker APIs
- *
- * HttpResult is a first-class-citizen in the grammar in Cloesce. Methods can return HttpResults
- * which will be serialized on the client api.
- *
- * @example
- * ```ts
- *  bar(): HttpResult<Integer> {
- *    return { ok: false, status: 401, message: "forbidden"}
- *  }
- * ```
- */
-export type HttpResult<T = unknown> = {
-    ok: boolean;
-    status: number;
-    data?: T;
-    message?: string;
-};
-/**
- * Dependency injection container, mapping an object type name to an instance of that object.
- *
- * Comes with the WranglerEnv and Request by default.
- */
-export type InstanceRegistry = Map<string, any>;
-export type MiddlewareFn = (request: Request, env: any, ir: InstanceRegistry) => Promise<HttpResult | undefined>;
-export type KeysOfType<T, U> = {
-    [K in keyof T]: T[K] extends U ? (K extends string ? K : never) : never;
-}[keyof T];
-/**
- * Represents the core middleware container for a Cloesce application.
- *
- * The `CloesceApp` class provides scoped middleware registration and
- * management across three primary levels of execution:
- *
- * 1. **Global Middleware** — Executed before any routing or model resolution occurs.
- * 2. **Model-Level Middleware** — Executed for requests targeting a specific model type.
- * 3. **Method-Level Middleware** — Executed for requests targeting a specific method on a model.
- *
- * When an instance of `CloesceApp` is exported from `app.cloesce.ts`,
- * it becomes the central container that the Cloesce runtime uses to
- * assemble and apply middleware in the correct execution order.
- *
- * ### Middleware Execution Order
- * Middleware is executed in FIFO order per scope. For example:
- * ```ts
- * app.use(Foo, A);
- * app.use(Foo, B);
- * app.use(Foo, C);
- * // Executed in order: A → B → C
- * ```
- *
- * Each middleware function (`MiddlewareFn`) can optionally short-circuit
- * execution by returning a result, in which case subsequent middleware
- * at the same or lower scope will not run.
- *
- * ### Example Usage
- * ```ts
- * import { app } from "cloesce";
- *
- * // Global authentication middleware
- * app.useGlobal((request, env, di) => {
- *   // ... authenticate and inject user
- * });
- *
- * // Model-level authorization
- * app.useModel(User, (user) => user.hasPermissions([UserPermissions.canUseFoo]));
- *
- * // Method-level middleware (e.g., CRUD operation)
- * app.useMethod(Foo, "someMethod", (user) => user.hasPermissions([UserPermissions.canUseFooMethod]));
- * ```
- */
-export declare class CloesceApp {
-    global: MiddlewareFn[];
-    model: Map<string, MiddlewareFn[]>;
-    method: Map<string, Map<string, MiddlewareFn[]>>;
-    /**
-     * Registers a new global middleware function.
-     *
-     * Global middleware runs before all routing and model resolution.
-     * It is the ideal place to perform tasks such as:
-     * - Authentication (e.g., JWT verification)
-     * - Global request logging
-     * - Dependency injection of shared context
-     *
-     * @param m - The middleware function to register.
-     */
-    useGlobal(m: MiddlewareFn): void;
-    /**
-     * Registers middleware for a specific model type.
-     *
-     * Model-level middleware runs after all global middleware,
-     * but before method-specific middleware. This scope allows
-     * logic to be applied consistently across all endpoints
-     * associated with a given model (e.g., authorization).
-     *
-     * @typeParam T - The model type.
-     * @param ctor - The model constructor (used to derive its name).
-     * @param m - The middleware function to register.
-     */
-    useModel<T>(ctor: new () => T, m: MiddlewareFn): void;
-    /**
-     * Registers middleware for a specific method on a model.
-     *
-     * Method-level middleware is executed after model middleware,
-     * and before the method implementation itself. It can be used for:
-     * - Fine-grained permission checks
-     * - Custom logging or tracing per endpoint
-     *
-     * @typeParam T - The model type.
-     * @param ctor - The model constructor (used to derive its name).
-     * @param method - The method name on the model.
-     * @param m - The middleware function to register.
-     */
-    useMethod<T>(ctor: new () => T, method: KeysOfType<T, (...args: any) => any>, m: MiddlewareFn): void;
-}
-export type CrudKind = "SAVE" | "GET" | "LIST";
-export type CidlType = "Void" | "Integer" | "Real" | "Text" | "Blob" | "DateIso" | "Boolean" | {
-    DataSource: string;
-} | {
-    Inject: string;
-} | {
-    Object: string;
-} | {
-    Partial: string;
-} | {
-    Nullable: CidlType;
-} | {
-    Array: CidlType;
-} | {
-    HttpResult: CidlType;
-};
-export declare function isNullableType(ty: CidlType): boolean;
-export declare enum HttpVerb {
-    GET = "GET",
-    POST = "POST",
-    PUT = "PUT",
-    PATCH = "PATCH",
-    DELETE = "DELETE"
-}
-export interface NamedTypedValue {
-    name: string;
-    cidl_type: CidlType;
-}
-export interface ModelAttribute {
-    value: NamedTypedValue;
-    foreign_key_reference: string | null;
-}
-export interface ModelMethod {
-    name: string;
-    is_static: boolean;
-    http_verb: HttpVerb;
-    return_type: CidlType | null;
-    parameters: NamedTypedValue[];
-}
-export type NavigationPropertyKind = {
-    OneToOne: {
-        reference: string;
-    };
-} | {
-    OneToMany: {
-        reference: string;
-    };
-} | {
-    ManyToMany: {
-        unique_id: string;
-    };
-};
-export interface NavigationProperty {
-    var_name: string;
-    model_name: string;
-    kind: NavigationPropertyKind;
-}
-export declare function getNavigationPropertyCidlType(nav: NavigationProperty): CidlType;
-export interface Model {
-    name: string;
-    primary_key: NamedTypedValue;
-    attributes: ModelAttribute[];
-    navigation_properties: NavigationProperty[];
-    methods: Record<string, ModelMethod>;
-    data_sources: Record<string, DataSource>;
-    cruds: CrudKind[];
-    source_path: string;
-}
-export interface PlainOldObject {
-    name: string;
-    attributes: NamedTypedValue[];
-    source_path: string;
-}
-export interface CidlIncludeTree {
-    [key: string]: CidlIncludeTree;
-}
-export declare const NO_DATA_SOURCE = "none";
-export interface DataSource {
-    name: string;
-    tree: CidlIncludeTree;
-}
-export interface WranglerEnv {
-    name: string;
-    source_path: string;
-    db_binding: string;
-}
-export interface CloesceAst {
-    version: string;
-    project_name: string;
-    language: string;
-    wrangler_env: WranglerEnv;
-    models: Record<string, Model>;
-    poos: Record<string, PlainOldObject>;
-    app_source: string | null;
-}
-export {};
-//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,oBAAY,kBAAkB;IAC5B,aAAa,IAAA;IACb,uBAAuB,IAAA;IACvB,WAAW,IAAA;IACX,mBAAmB,IAAA;IACnB,2BAA2B,IAAA;IAC3B,kBAAkB,IAAA;IAClB,kBAAkB,IAAA;IAClB,wBAAwB,IAAA;IACxB,wBAAwB,IAAA;IACxB,kCAAkC,IAAA;IAClC,kCAAkC,KAAA;IAClC,kCAAkC,KAAA;IAClC,yBAAyB,KAAA;IACzB,iBAAiB,KAAA;IACjB,sBAAsB,KAAA;IACtB,kBAAkB,KAAA;IAClB,mBAAmB,KAAA;IACnB,WAAW,KAAA;CACZ;AAyFD,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB;iBArFpC,MAAM;gBAAc,MAAM;EAuF1C;AAED,qBAAa,cAAc;IAIN,IAAI,EAAE,kBAAkB;IAH3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEE,IAAI,EAAE,kBAAkB;IAE3C,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS;CAG/D;AAED,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC5C,gBAAgB,CAAC,CAAC,CAAC,EAAE,GACrB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC3C,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3E,qBAAa,MAAM,CAAC,CAAC,EAAE,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IADxB,OAAO;IAIP,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,CAEjB;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIjD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIlD,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAIlC,OAAO,IAAI,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAInC,MAAM,IAAI,CAAC;IAOX,UAAU,IAAI,CAAC;IAOf,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAMvC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;CAK5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,gBAAgB,KACjB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;AAErC,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK;CACxE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,UAAU;IACd,MAAM,EAAE,YAAY,EAAE,CAAM;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAa;IAC/C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAa;IAEpE;;;;;;;;;;OAUG;IACI,SAAS,CAAC,CAAC,EAAE,YAAY;IAIhC;;;;;;;;;;;OAWG;IACI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,YAAY;IAQrD;;;;;;;;;;;;OAYG;IACI,SAAS,CAAC,CAAC,EAChB,IAAI,EAAE,UAAU,CAAC,EACjB,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,EAC5C,CAAC,EAAE,YAAY;CAalB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,GACT;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACtB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,UAAU,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE7B,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED,oBAAY,QAAQ;IAClB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnC;IAAE,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpC;IAAE,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,kBAAkB,GACtB,QAAQ,CAIV;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CAChC;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/common.js

@@ -1,274 +0,0 @@
-export var ExtractorErrorCode;
-(function (ExtractorErrorCode) {
-    ExtractorErrorCode[ExtractorErrorCode["MissingExport"] = 0] = "MissingExport";
-    ExtractorErrorCode[ExtractorErrorCode["AppMissingDefaultExport"] = 1] = "AppMissingDefaultExport";
-    ExtractorErrorCode[ExtractorErrorCode["UnknownType"] = 2] = "UnknownType";
-    ExtractorErrorCode[ExtractorErrorCode["MultipleGenericType"] = 3] = "MultipleGenericType";
-    ExtractorErrorCode[ExtractorErrorCode["InvalidDataSourceDefinition"] = 4] = "InvalidDataSourceDefinition";
-    ExtractorErrorCode[ExtractorErrorCode["InvalidPartialType"] = 5] = "InvalidPartialType";
-    ExtractorErrorCode[ExtractorErrorCode["InvalidIncludeTree"] = 6] = "InvalidIncludeTree";
-    ExtractorErrorCode[ExtractorErrorCode["InvalidAttributeModifier"] = 7] = "InvalidAttributeModifier";
-    ExtractorErrorCode[ExtractorErrorCode["InvalidApiMethodModifier"] = 8] = "InvalidApiMethodModifier";
-    ExtractorErrorCode[ExtractorErrorCode["UnknownNavigationPropertyReference"] = 9] = "UnknownNavigationPropertyReference";
-    ExtractorErrorCode[ExtractorErrorCode["InvalidNavigationPropertyReference"] = 10] = "InvalidNavigationPropertyReference";
-    ExtractorErrorCode[ExtractorErrorCode["MissingNavigationPropertyReference"] = 11] = "MissingNavigationPropertyReference";
-    ExtractorErrorCode[ExtractorErrorCode["MissingManyToManyUniqueId"] = 12] = "MissingManyToManyUniqueId";
-    ExtractorErrorCode[ExtractorErrorCode["MissingPrimaryKey"] = 13] = "MissingPrimaryKey";
-    ExtractorErrorCode[ExtractorErrorCode["MissingDatabaseBinding"] = 14] = "MissingDatabaseBinding";
-    ExtractorErrorCode[ExtractorErrorCode["MissingWranglerEnv"] = 15] = "MissingWranglerEnv";
-    ExtractorErrorCode[ExtractorErrorCode["TooManyWranglerEnvs"] = 16] = "TooManyWranglerEnvs";
-    ExtractorErrorCode[ExtractorErrorCode["MissingFile"] = 17] = "MissingFile";
-})(ExtractorErrorCode || (ExtractorErrorCode = {}));
-const errorInfoMap = {
-    [ExtractorErrorCode.MissingExport]: {
-        description: "All Cloesce types must be exported.",
-        suggestion: "Add `export` to the class definition.",
-    },
-    [ExtractorErrorCode.AppMissingDefaultExport]: {
-        description: "app.cloesce.ts does not export a CloesceApp by default",
-        suggestion: "Export an instantiated CloesceApp in app.cloesce.ts",
-    },
-    [ExtractorErrorCode.UnknownType]: {
-        description: "Encountered an unknown or unsupported type",
-        suggestion: "Refer to the documentation on valid Cloesce TS types",
-    },
-    [ExtractorErrorCode.InvalidPartialType]: {
-        description: "Partial types must only contain a model or plain old object",
-        suggestion: "Refer to the documentation on valid Cloesce TS types",
-    },
-    [ExtractorErrorCode.MultipleGenericType]: {
-        description: "Cloesce does not yet support types with multiple generics",
-        suggestion: "Simplify your type to use only a single generic parameter, ie Foo<T>",
-    },
-    [ExtractorErrorCode.InvalidDataSourceDefinition]: {
-        description: "Data Sources must be explicitly typed as a static Include Tree",
-        suggestion: "Declare your data source as `static readonly _: IncludeTree<Model>`",
-    },
-    [ExtractorErrorCode.InvalidIncludeTree]: {
-        description: "Invalid Include Tree",
-        suggestion: "Include trees must only contain references to a model's navigation properties.",
-    },
-    [ExtractorErrorCode.InvalidAttributeModifier]: {
-        description: "Attributes can only be public on a Model, Plain Old Object or Wrangler Environment",
-        suggestion: "Change the attribute modifier to just `public`",
-    },
-    [ExtractorErrorCode.InvalidApiMethodModifier]: {
-        description: "Model methods must be public if they are decorated as GET, POST, PUT, PATCH",
-        suggestion: "Change the method modifier to just `public`",
-    },
-    [ExtractorErrorCode.UnknownNavigationPropertyReference]: {
-        description: "Unknown Navigation Property Reference",
-        suggestion: "Verify that the navigation property reference model exists, or create a model.",
-    },
-    [ExtractorErrorCode.InvalidNavigationPropertyReference]: {
-        description: "Invalid Navigation Property Reference",
-        suggestion: "Ensure the navigation property points to a valid model field",
-    },
-    [ExtractorErrorCode.MissingNavigationPropertyReference]: {
-        description: "Missing Navigation Property Reference",
-        suggestion: "Navigation properties require a foreign key model attribute reference",
-    },
-    [ExtractorErrorCode.MissingManyToManyUniqueId]: {
-        description: "Missing unique id on Many to Many navigation property",
-        suggestion: "Define a unique identifier field for the Many-to-Many relationship",
-    },
-    [ExtractorErrorCode.MissingPrimaryKey]: {
-        description: "Missing primary key on a model",
-        suggestion: "Add a primary key field to your model (e.g., `id: number`)",
-    },
-    [ExtractorErrorCode.MissingDatabaseBinding]: {
-        description: "Missing a database binding in the WranglerEnv definition",
-        suggestion: "Add a `D1Database` to your WranglerEnv",
-    },
-    [ExtractorErrorCode.MissingWranglerEnv]: {
-        description: "Missing a wrangler environment definition in the project",
-        suggestion: "Add a @WranglerEnv class in your project.",
-    },
-    [ExtractorErrorCode.TooManyWranglerEnvs]: {
-        description: "Too many wrangler environments defined in the project",
-        suggestion: "Consolidate or remove unused @WranglerEnv's",
-    },
-    [ExtractorErrorCode.MissingFile]: {
-        description: "A specified input file could not be found",
-        suggestion: "Verify the input file path is correct",
-    },
-};
-export function getErrorInfo(code) {
-    return errorInfoMap[code];
-}
-export class ExtractorError {
-    code;
-    context;
-    snippet;
-    constructor(code) {
-        this.code = code;
-    }
-    addContext(fn) {
-        this.context = fn(this.context ?? "");
-    }
-}
-export class Either {
-    inner;
-    constructor(inner) {
-        this.inner = inner;
-    }
-    get value() {
-        return this.inner.ok ? this.inner.right : this.inner.left;
-    }
-    static left(value) {
-        return new Either({ ok: false, left: value });
-    }
-    static right(value) {
-        return new Either({ ok: true, right: value });
-    }
-    isLeft() {
-        return !this.inner.ok;
-    }
-    isRight() {
-        return this.inner.ok;
-    }
-    unwrap() {
-        if (!this.inner.ok) {
-            throw new Error("Tried to unwrap a Left value");
-        }
-        return this.inner.right;
-    }
-    unwrapLeft() {
-        if (this.inner.ok) {
-            throw new Error("Tried to unwrapLeft a Right value");
-        }
-        return this.inner.left;
-    }
-    map(fn) {
-        return this.inner.ok
-            ? Either.right(fn(this.inner.right))
-            : Either.left(this.inner.left);
-    }
-    mapLeft(fn) {
-        return this.inner.ok
-            ? Either.right(this.inner.right)
-            : Either.left(fn(this.inner.left));
-    }
-}
-/**
- * Represents the core middleware container for a Cloesce application.
- *
- * The `CloesceApp` class provides scoped middleware registration and
- * management across three primary levels of execution:
- *
- * 1. **Global Middleware** — Executed before any routing or model resolution occurs.
- * 2. **Model-Level Middleware** — Executed for requests targeting a specific model type.
- * 3. **Method-Level Middleware** — Executed for requests targeting a specific method on a model.
- *
- * When an instance of `CloesceApp` is exported from `app.cloesce.ts`,
- * it becomes the central container that the Cloesce runtime uses to
- * assemble and apply middleware in the correct execution order.
- *
- * ### Middleware Execution Order
- * Middleware is executed in FIFO order per scope. For example:
- * ```ts
- * app.use(Foo, A);
- * app.use(Foo, B);
- * app.use(Foo, C);
- * // Executed in order: A → B → C
- * ```
- *
- * Each middleware function (`MiddlewareFn`) can optionally short-circuit
- * execution by returning a result, in which case subsequent middleware
- * at the same or lower scope will not run.
- *
- * ### Example Usage
- * ```ts
- * import { app } from "cloesce";
- *
- * // Global authentication middleware
- * app.useGlobal((request, env, di) => {
- *   // ... authenticate and inject user
- * });
- *
- * // Model-level authorization
- * app.useModel(User, (user) => user.hasPermissions([UserPermissions.canUseFoo]));
- *
- * // Method-level middleware (e.g., CRUD operation)
- * app.useMethod(Foo, "someMethod", (user) => user.hasPermissions([UserPermissions.canUseFooMethod]));
- * ```
- */
-export class CloesceApp {
-    global = [];
-    model = new Map();
-    method = new Map();
-    /**
-     * Registers a new global middleware function.
-     *
-     * Global middleware runs before all routing and model resolution.
-     * It is the ideal place to perform tasks such as:
-     * - Authentication (e.g., JWT verification)
-     * - Global request logging
-     * - Dependency injection of shared context
-     *
-     * @param m - The middleware function to register.
-     */
-    useGlobal(m) {
-        this.global.push(m);
-    }
-    /**
-     * Registers middleware for a specific model type.
-     *
-     * Model-level middleware runs after all global middleware,
-     * but before method-specific middleware. This scope allows
-     * logic to be applied consistently across all endpoints
-     * associated with a given model (e.g., authorization).
-     *
-     * @typeParam T - The model type.
-     * @param ctor - The model constructor (used to derive its name).
-     * @param m - The middleware function to register.
-     */
-    useModel(ctor, m) {
-        if (this.model.has(ctor.name)) {
-            this.model.get(ctor.name).push(m);
-        }
-        else {
-            this.model.set(ctor.name, [m]);
-        }
-    }
-    /**
-     * Registers middleware for a specific method on a model.
-     *
-     * Method-level middleware is executed after model middleware,
-     * and before the method implementation itself. It can be used for:
-     * - Fine-grained permission checks
-     * - Custom logging or tracing per endpoint
-     *
-     * @typeParam T - The model type.
-     * @param ctor - The model constructor (used to derive its name).
-     * @param method - The method name on the model.
-     * @param m - The middleware function to register.
-     */
-    useMethod(ctor, method, m) {
-        if (!this.method.has(ctor.name)) {
-            this.method.set(ctor.name, new Map());
-        }
-        const methods = this.method.get(ctor.name);
-        if (!methods.has(method)) {
-            methods.set(method, []);
-        }
-        methods.get(method).push(m);
-    }
-}
-export function isNullableType(ty) {
-    return typeof ty === "object" && ty !== null && "Nullable" in ty;
-}
-export var HttpVerb;
-(function (HttpVerb) {
-    HttpVerb["GET"] = "GET";
-    HttpVerb["POST"] = "POST";
-    HttpVerb["PUT"] = "PUT";
-    HttpVerb["PATCH"] = "PATCH";
-    HttpVerb["DELETE"] = "DELETE";
-})(HttpVerb || (HttpVerb = {}));
-export function getNavigationPropertyCidlType(nav) {
-    return "OneToOne" in nav.kind
-        ? { Object: nav.model_name }
-        : { Array: { Object: nav.model_name } };
-}
-export const NO_DATA_SOURCE = "none";