cloesce 0.0.3-fix.6 → 0.0.4-unstable.0

package/dist/runtime/runtime.d.ts

@@ -1,112 +0,0 @@
-import { HttpResult, Either, ModelMethod, CloesceAst, Model } from "../common.js";
-import { IncludeTree } from "../index/backend.js";
-/**
- * Map of model names to their respective constructor.
- *
- * The value accepted into the `cloesce` function is generated by the Cloesce compiler, and
- * is guaranteed to contain all model definitions.
- */
-type ModelConstructorRegistry = Record<string, new () => UserDefinedModel>;
-/**
- * Dependency injection container, mapping an object type name to an instance of that object.
- *
- * The value accepted into the `cloesce` function is generated by the Cloesce compiler, and is
- * guaranteed to contain all injected model method parameters.
- */
-type InstanceRegistry = Map<string, any>;
-/**
- * Users will create Cloesce models, which have metadata for them in the ast.
- * For TypeScript's purposes, these models can be anything. We can assume any
- * `UserDefinedModel` has been verified by the compiler.
- */
-type UserDefinedModel = any;
-/**
- * Given a request, this represents a map of each body / url  param name to
- * its actual value. Unknown, as the a request can be anything.
- */
-type RequestParamMap = Record<string, unknown>;
-/**
- * Meta information on the wrangler env and db bindings
- */
-interface MetaWranglerEnv {
-    envName: string;
-    dbName: string;
-}
-/**
- * WASM ABI
- */
-interface RuntimeWasmExports {
-    memory: WebAssembly.Memory;
-    get_return_len(): number;
-    set_meta_ptr(ptr: number, len: number): number;
-    alloc(len: number): number;
-    dealloc(ptr: number, len: number): void;
-    object_relational_mapping(model_name_ptr: number, model_name_len: number, sql_rows_ptr: number, sql_rows_len: number, include_tree_ptr: number, include_tree_len: number): number;
-}
-/**
- * Singleton instances of the cidl, constructor registry, and wasm binary.
- * These values are guaranteed to never change throughout a program lifetime.
- */
-declare class RuntimeContainer {
-    readonly ast: CloesceAst;
-    readonly constructorRegistry: ModelConstructorRegistry;
-    readonly wasm: RuntimeWasmExports;
-    private static instance;
-    private constructor();
-    static init(ast: CloesceAst, constructorRegistry: ModelConstructorRegistry, wasm?: WebAssembly.Instance): Promise<void>;
-    static get(): RuntimeContainer;
-}
-/**
- * Runtime entry point. Given a request, undergoes: routing, validating,
- * hydrating, and method dispatch.
- *
- * @returns A Response with an `HttpResult` JSON body.
- */
-export declare function cloesce(request: Request, ast: CloesceAst, constructorRegistry: ModelConstructorRegistry, instanceRegistry: InstanceRegistry, envMeta: MetaWranglerEnv, api_route: string): Promise<Response>;
-/**
- * Matches a request to a method on a model.
- * @param api_route The route from the domain to the actual API, ie https://foo.com/route/to/api => route/to/api/
- * @returns 404 or a `MatchedRoute`
- */
-declare function matchRoute(request: Request, ast: CloesceAst, api_route: string): Either<HttpResult, {
-    model: Model;
-    method: ModelMethod;
-    id: string | null;
-}>;
-/**
- * Validates the request's body/search params against a ModelMethod
- * @returns 400 or a `RequestParamMap` consisting of each parameters name mapped to its value, and
- * a data source
- */
-declare function validateRequest(request: Request, ast: CloesceAst, model: Model, method: ModelMethod, id: string | null): Promise<Either<HttpResult, {
-    params: RequestParamMap;
-    dataSource: string | null;
-}>>;
-/**
- * Calls a method on a model given a list of parameters.
- * @returns 500 on an uncaught client error, 200 with a result body on success
- */
-declare function methodDispatch(instance: object, instanceRegistry: InstanceRegistry, envMeta: MetaWranglerEnv, method: ModelMethod, params: Record<string, unknown>): Promise<HttpResult<unknown>>;
-/**
- * Creates model instances given a properly formatted SQL record, being either:
- *
- *  1. Flat, relationship-less (ex: id, name, location, ...)
- *  2. `DataSource` formatted (ex: Horse.id, Horse.name, Horse.rider, ...)
- *
- * @param ctor The type of the model
- * @param records SQL records
- * @param includeTree The include tree to use when parsing the records
- * @returns An instantiated array of `T`, containing one or more objects.
- */
-export declare function modelsFromSql<T extends object>(ctor: new () => T, records: Record<string, any>[], includeTree: IncludeTree<T> | null): T[];
-/**
- * For testing purposes
- */
-export declare const _cloesceInternal: {
-    matchRoute: typeof matchRoute;
-    validateRequest: typeof validateRequest;
-    methodDispatch: typeof methodDispatch;
-    RuntimeContainer: typeof RuntimeContainer;
-};
-export {};
-//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

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