model-blueprint 0.1.4 → 0.2.0

package/dist/createId.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+const cuid2 = require('@paralleldrive/cuid2');
+
+const createId = ({ ctx }) => {
+  return { ...ctx, createId: cuid2.createId, init: cuid2.init };
+};
+
+exports.createId = createId;
+//# sourceMappingURL=createId.cjs.map

package/dist/createId.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createId.cjs","sources":["../src/queryUtils/createId.ts"],"sourcesContent":["import {\n  createId as createCuid2Id,\n  init as initCuid2,\n} from '@paralleldrive/cuid2';\n\n/**\n * Middleware factory that adds a `createId` and `init` function to the context.\n * This function allows procedures to create CUID2 IDs and initialize CUID2.\n * @template TContext - The context type.\n * @param ctx - The context object.\n * @returns A middleware function that injects the `createId` and `init` helpers into the context.\n */\nexport const createId = <TContext>({ ctx }: { ctx: TContext }) => {\n  return { ...ctx, createId: createCuid2Id, init: initCuid2 };\n};\n"],"names":["createCuid2Id","initCuid2"],"mappings":";;;;AAYO,MAAM,QAAA,GAAW,CAAW,EAAE,GAAA,EAAI,KAAyB;AAChE,EAAA,OAAO,EAAE,GAAG,GAAA,EAAK,QAAA,EAAUA,cAAA,EAAe,MAAMC,UAAA,EAAU;AAC5D;;;;"}

package/dist/createId.d.cts

@@ -0,0 +1,17 @@
+import { createId as createId$1, init } from '@paralleldrive/cuid2';
+
+/**
+ * Middleware factory that adds a `createId` and `init` function to the context.
+ * This function allows procedures to create CUID2 IDs and initialize CUID2.
+ * @template TContext - The context type.
+ * @param ctx - The context object.
+ * @returns A middleware function that injects the `createId` and `init` helpers into the context.
+ */
+declare const createId: <TContext>({ ctx }: {
+    ctx: TContext;
+}) => TContext & {
+    createId: typeof createId$1;
+    init: typeof init;
+};
+
+export { createId };

package/dist/createId.d.mts

@@ -0,0 +1,17 @@
+import { createId as createId$1, init } from '@paralleldrive/cuid2';
+
+/**
+ * Middleware factory that adds a `createId` and `init` function to the context.
+ * This function allows procedures to create CUID2 IDs and initialize CUID2.
+ * @template TContext - The context type.
+ * @param ctx - The context object.
+ * @returns A middleware function that injects the `createId` and `init` helpers into the context.
+ */
+declare const createId: <TContext>({ ctx }: {
+    ctx: TContext;
+}) => TContext & {
+    createId: typeof createId$1;
+    init: typeof init;
+};
+
+export { createId };

package/dist/createId.mjs

@@ -0,0 +1,8 @@
+import { init, createId as createId$1 } from '@paralleldrive/cuid2';
+
+const createId = ({ ctx }) => {
+  return { ...ctx, createId: createId$1, init: init };
+};
+
+export { createId };
+//# sourceMappingURL=createId.mjs.map

package/dist/createId.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createId.mjs","sources":["../src/queryUtils/createId.ts"],"sourcesContent":["import {\n  createId as createCuid2Id,\n  init as initCuid2,\n} from '@paralleldrive/cuid2';\n\n/**\n * Middleware factory that adds a `createId` and `init` function to the context.\n * This function allows procedures to create CUID2 IDs and initialize CUID2.\n * @template TContext - The context type.\n * @param ctx - The context object.\n * @returns A middleware function that injects the `createId` and `init` helpers into the context.\n */\nexport const createId = <TContext>({ ctx }: { ctx: TContext }) => {\n  return { ...ctx, createId: createCuid2Id, init: initCuid2 };\n};\n"],"names":["createCuid2Id","initCuid2"],"mappings":";;AAYO,MAAM,QAAA,GAAW,CAAW,EAAE,GAAA,EAAI,KAAyB;AAChE,EAAA,OAAO,EAAE,GAAG,GAAA,EAAK,QAAA,EAAUA,UAAA,EAAe,MAAMC,IAAA,EAAU;AAC5D;;;;"}

package/dist/dropQuery.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+const utils = require('./shared/model-blueprint.D9hykuhu.cjs');
+require('zod');
+
+const dropQuery = (dropMessages) => ({ ctx }) => {
+  const drop = (message, code) => {
+    throw new utils.ModelError(code ?? 400, {
+      message: dropMessages[message]
+    });
+  };
+  return { ...ctx, drop };
+};
+
+exports.dropQuery = dropQuery;
+//# sourceMappingURL=dropQuery.cjs.map

package/dist/dropQuery.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropQuery.cjs","sources":["../src/queryUtils/dropQuery.ts"],"sourcesContent":["import { ModelError } from '../utils';\n\n/**\n * Middleware factory that adds a `drop` function to the context.\n * This function allows procedures to throw controlled HTTP errors with specific messages.\n * @template Messages - A map of error keys to their corresponding message strings.\n * @param dropMessages - An object mapping error keys to messages.\n * @returns A middleware function that injects the `drop` helper into the context.\n */\nexport const dropQuery =\n  <Messages extends Record<string, string>>(dropMessages: Messages) =>\n  <TContext>({ ctx }: { ctx: TContext }) => {\n    const drop = <Key extends keyof Messages>(message: Key, code?: number) => {\n      throw new ModelError(code ?? 400, {\n        message: dropMessages[message],\n      });\n    };\n\n    return { ...ctx, drop };\n  };\n"],"names":["ModelError"],"mappings":";;;;;AASO,MAAM,YACX,CAA0C,YAAA,KAC1C,CAAW,EAAE,KAAI,KAAyB;AACxC,EAAA,MAAM,IAAA,GAAO,CAA6B,OAAA,EAAc,IAAA,KAAkB;AACxE,IAAA,MAAM,IAAIA,gBAAA,CAAW,IAAA,IAAQ,GAAA,EAAK;AAAA,MAChC,OAAA,EAAS,aAAa,OAAO;AAAA,KAC9B,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,EAAE,GAAG,GAAA,EAAK,IAAA,EAAK;AACxB;;;;"}

package/dist/dropQuery.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Middleware factory that adds a `drop` function to the context.
+ * This function allows procedures to throw controlled HTTP errors with specific messages.
+ * @template Messages - A map of error keys to their corresponding message strings.
+ * @param dropMessages - An object mapping error keys to messages.
+ * @returns A middleware function that injects the `drop` helper into the context.
+ */
+declare const dropQuery: <Messages extends Record<string, string>>(dropMessages: Messages) => <TContext>({ ctx }: {
+    ctx: TContext;
+}) => TContext & {
+    drop: <Key extends keyof Messages>(message: Key, code?: number) => never;
+};
+
+export { dropQuery };

package/dist/dropQuery.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Middleware factory that adds a `drop` function to the context.
+ * This function allows procedures to throw controlled HTTP errors with specific messages.
+ * @template Messages - A map of error keys to their corresponding message strings.
+ * @param dropMessages - An object mapping error keys to messages.
+ * @returns A middleware function that injects the `drop` helper into the context.
+ */
+declare const dropQuery: <Messages extends Record<string, string>>(dropMessages: Messages) => <TContext>({ ctx }: {
+    ctx: TContext;
+}) => TContext & {
+    drop: <Key extends keyof Messages>(message: Key, code?: number) => never;
+};
+
+export { dropQuery };

package/dist/dropQuery.mjs

@@ -0,0 +1,14 @@
+import { M as ModelError } from './shared/model-blueprint.JM5S8yAe.mjs';
+import 'zod';
+
+const dropQuery = (dropMessages) => ({ ctx }) => {
+  const drop = (message, code) => {
+    throw new ModelError(code ?? 400, {
+      message: dropMessages[message]
+    });
+  };
+  return { ...ctx, drop };
+};
+
+export { dropQuery };
+//# sourceMappingURL=dropQuery.mjs.map

package/dist/dropQuery.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropQuery.mjs","sources":["../src/queryUtils/dropQuery.ts"],"sourcesContent":["import { ModelError } from '../utils';\n\n/**\n * Middleware factory that adds a `drop` function to the context.\n * This function allows procedures to throw controlled HTTP errors with specific messages.\n * @template Messages - A map of error keys to their corresponding message strings.\n * @param dropMessages - An object mapping error keys to messages.\n * @returns A middleware function that injects the `drop` helper into the context.\n */\nexport const dropQuery =\n  <Messages extends Record<string, string>>(dropMessages: Messages) =>\n  <TContext>({ ctx }: { ctx: TContext }) => {\n    const drop = <Key extends keyof Messages>(message: Key, code?: number) => {\n      throw new ModelError(code ?? 400, {\n        message: dropMessages[message],\n      });\n    };\n\n    return { ...ctx, drop };\n  };\n"],"names":[],"mappings":";;;AASO,MAAM,YACX,CAA0C,YAAA,KAC1C,CAAW,EAAE,KAAI,KAAyB;AACxC,EAAA,MAAM,IAAA,GAAO,CAA6B,OAAA,EAAc,IAAA,KAAkB;AACxE,IAAA,MAAM,IAAI,UAAA,CAAW,IAAA,IAAQ,GAAA,EAAK;AAAA,MAChC,OAAA,EAAS,aAAa,OAAO;AAAA,KAC9B,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,OAAO,EAAE,GAAG,GAAA,EAAK,IAAA,EAAK;AACxB;;;;"}

package/dist/index.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const utils = require('./shared/model-blueprint.D9hykuhu.cjs');
+require('zod');
+
+function createModelFactory(blueprint) {
+  return function createModel(ctx) {
+    const hydrate = (structure) => {
+      const result = {};
+      for (const key in structure) {
+        const value = structure[key];
+        if (utils.isQueryBuilder(value)) {
+          result[key] = value(ctx);
+        } else if (utils.isPlainObject(value)) {
+          result[key] = hydrate(value);
+        } else {
+          result[key] = value;
+        }
+      }
+      return result;
+    };
+    return hydrate(blueprint);
+  };
+}
+
+exports.ModelError = utils.ModelError;
+exports.initProcedure = utils.initProcedure;
+exports.createModelFactory = createModelFactory;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/createModelFactory.ts"],"sourcesContent":["import type { HydratedModel } from './types';\nimport { isPlainObject, isQueryBuilder } from './utils';\n\n/**\n * Creates a Model Factory based on your API Blueprint.\n * @template TBlueprint - The structure of your API (nested objects containing QueryBuilders).\n * @param blueprint - The static object defining your API structure.\n * @returns A function `createModel(ctx)` that takes your Context and returns the fully typed API.\n * @example\n * const modelFactory = createModelFactory({\n *   users: { get: userGetQuery }\n * });\n * const DB = modelFactory({ db: myDb });\n */\nexport function createModelFactory<TBlueprint extends Record<string, unknown>>(\n  blueprint: TBlueprint\n) {\n  /**\n   * The actual factory function used at runtime per-request.\n   * @param ctx - The dependency injection context (must match TRootContext of your builders).\n   */\n  return function createModel<TContext>(\n    ctx: TContext\n  ): HydratedModel<TBlueprint, TContext> {\n    // Recursive function to walk the blueprint tree and inject context.\n    const hydrate = (structure: Record<string, unknown>): unknown => {\n      const result: Record<string, unknown> = {};\n\n      for (const key in structure) {\n        const value = structure[key];\n\n        if (isQueryBuilder(value)) {\n          // Safe execution via Type Guard\n          // value is strictly QueryBuilder<unknown, unknown, unknown>\n          result[key] = value(ctx);\n          // Note: We perform one specific cast here because TypeScript\n          // cannot correlate the TContext generic of the *specific* builder\n          // with the TContext passed to the factory without excessive complexity.\n          // However, the *Generics* on the class ensure safety for the user.\n        } else if (isPlainObject(value)) {\n          result[key] = hydrate(value);\n        } else {\n          result[key] = value;\n        }\n      }\n      return result;\n    };\n\n    return hydrate(blueprint) as HydratedModel<TBlueprint, TContext>;\n  };\n}\n"],"names":["isQueryBuilder","isPlainObject"],"mappings":";;;;;AAcO,SAAS,mBACd,SAAA,EACA;AAKA,EAAA,OAAO,SAAS,YACd,GAAA,EACqC;AAErC,IAAA,MAAM,OAAA,GAAU,CAAC,SAAA,KAAgD;AAC/D,MAAA,MAAM,SAAkC,EAAC;AAEzC,MAAA,KAAA,MAAW,OAAO,SAAA,EAAW;AAC3B,QAAA,MAAM,KAAA,GAAQ,UAAU,GAAG,CAAA;AAE3B,QAAA,IAAIA,oBAAA,CAAe,KAAK,CAAA,EAAG;AAGzB,UAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA,CAAM,GAAG,CAAA;AAAA,QAKzB,CAAA,MAAA,IAAWC,mBAAA,CAAc,KAAK,CAAA,EAAG;AAC/B,UAAA,MAAA,CAAO,GAAG,CAAA,GAAI,OAAA,CAAQ,KAAK,CAAA;AAAA,QAC7B,CAAA,MAAO;AACL,UAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA;AAAA,QAChB;AAAA,MACF;AACA,MAAA,OAAO,MAAA;AAAA,IACT,CAAA;AAEA,IAAA,OAAO,QAAQ,SAAS,CAAA;AAAA,EAC1B,CAAA;AACF;;;;;;"}

package/dist/index.d.cts

@@ -0,0 +1,99 @@
+import z from 'zod';
+
+/**
+ * Represents a compiled query function that is waiting for a Context to be injected.
+ * @template TContext - The type of the context object (e.g., DB connection, User session) this query requires.
+ * @template TInput - The Zod-inferred type of the input arguments.
+ * @template TOutput - The return type of the query handler.
+ */
+type QueryBuilder<TContext, TInput, TOutput> = {
+    /**
+     * Accepts the Context and returns the executable function.
+     * @param ctx - The dependency injection context.
+     */
+    (ctx: TContext): (input: TInput) => Promise<TOutput>;
+};
+/**
+ * A recursive type that transforms a Blueprint definition into a usable API client.
+ * - Converts `QueryBuilder<Context, Input, Output>` -> `(input: Input) => Promise<Output>`
+ * - Recursively traverses nested objects.
+ * - Passes through primitives (like string constants) unchanged.
+ */
+type HydratedModel<TBlueprint, TContext> = {
+    [K in keyof TBlueprint]: TBlueprint[K] extends QueryBuilder<TContext, infer I, infer O> ? (input: I) => Promise<O> : TBlueprint[K] extends object ? HydratedModel<TBlueprint[K], TContext> : TBlueprint[K];
+};
+/**
+ * A generic function type for internal middleware storage.
+ * Uses `unknown` to allow storage of diverse middleware chains in the same array.
+ */
+type ProcedureMiddleware = (params: {
+    ctx: unknown;
+    input: unknown;
+}) => Promise<unknown> | unknown;
+type GenericProcedureMiddleware<Context> = (params: {
+    ctx: Context;
+    input: unknown;
+}) => Promise<unknown> | unknown;
+
+/**
+ * Creates a Model Factory based on your API Blueprint.
+ * @template TBlueprint - The structure of your API (nested objects containing QueryBuilders).
+ * @param blueprint - The static object defining your API structure.
+ * @returns A function `createModel(ctx)` that takes your Context and returns the fully typed API.
+ * @example
+ * const modelFactory = createModelFactory({
+ *   users: { get: userGetQuery }
+ * });
+ * const DB = modelFactory({ db: myDb });
+ */
+declare function createModelFactory<TBlueprint extends Record<string, unknown>>(blueprint: TBlueprint): <TContext>(ctx: TContext) => HydratedModel<TBlueprint, TContext>;
+
+/**
+ * The core builder class for creating type-safe database procedures.
+ * Implements a fluent interface to chain validation, middleware, and handlers.
+ * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).
+ * @template TCurrentContext - The Context type at the current stage of the pipeline (modified by previous middlewares).
+ * @template TInput - The validated input type (inferred from Zod).
+ */
+declare class ProcedureBuilder<TRootContext, TCurrentContext, TInput extends z.ZodType> {
+    #private;
+    constructor(schema?: TInput, middlewares?: ProcedureMiddleware[]);
+    /**
+     * Define input validation.
+     * Resets TInput to the inferred Zod type.
+     */
+    input<TSchema extends z.ZodType>(schema: TSchema): ProcedureBuilder<TRootContext, TCurrentContext, TSchema>;
+    /**
+     * Add middleware.
+     * Transforms TCurrentContext -> TNextContext.
+     */
+    use<TNextContext>(middleware: (params: {
+        ctx: TCurrentContext;
+        input: z.infer<TInput>;
+    }) => Promise<TNextContext> | TNextContext): ProcedureBuilder<TRootContext, TNextContext, TInput>;
+    /**
+     * Finalize the query.
+     * Returns a QueryBuilder that expects TRootContext.
+     */
+    query<TResult>(handler: (params: {
+        ctx: TCurrentContext;
+        input: z.infer<TInput>;
+    }) => Promise<TResult>): QueryBuilder<TRootContext, z.infer<TInput>, TResult>;
+}
+
+/**
+ * Initialize a new procedure builder.
+ * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).
+ * @returns A new ProcedureBuilder instance.
+ */
+declare function initProcedure<TRootContext>(): ProcedureBuilder<TRootContext, TRootContext, z.ZodAny>;
+type ModelErrorOptions = {
+    message?: string;
+};
+declare class ModelError extends Error {
+    readonly status: number;
+    constructor(status: number, options?: ModelErrorOptions);
+}
+
+export { ModelError, createModelFactory, initProcedure };
+export type { GenericProcedureMiddleware, HydratedModel };

package/dist/index.d.mts

@@ -0,0 +1,99 @@
+import z from 'zod';
+
+/**
+ * Represents a compiled query function that is waiting for a Context to be injected.
+ * @template TContext - The type of the context object (e.g., DB connection, User session) this query requires.
+ * @template TInput - The Zod-inferred type of the input arguments.
+ * @template TOutput - The return type of the query handler.
+ */
+type QueryBuilder<TContext, TInput, TOutput> = {
+    /**
+     * Accepts the Context and returns the executable function.
+     * @param ctx - The dependency injection context.
+     */
+    (ctx: TContext): (input: TInput) => Promise<TOutput>;
+};
+/**
+ * A recursive type that transforms a Blueprint definition into a usable API client.
+ * - Converts `QueryBuilder<Context, Input, Output>` -> `(input: Input) => Promise<Output>`
+ * - Recursively traverses nested objects.
+ * - Passes through primitives (like string constants) unchanged.
+ */
+type HydratedModel<TBlueprint, TContext> = {
+    [K in keyof TBlueprint]: TBlueprint[K] extends QueryBuilder<TContext, infer I, infer O> ? (input: I) => Promise<O> : TBlueprint[K] extends object ? HydratedModel<TBlueprint[K], TContext> : TBlueprint[K];
+};
+/**
+ * A generic function type for internal middleware storage.
+ * Uses `unknown` to allow storage of diverse middleware chains in the same array.
+ */
+type ProcedureMiddleware = (params: {
+    ctx: unknown;
+    input: unknown;
+}) => Promise<unknown> | unknown;
+type GenericProcedureMiddleware<Context> = (params: {
+    ctx: Context;
+    input: unknown;
+}) => Promise<unknown> | unknown;
+
+/**
+ * Creates a Model Factory based on your API Blueprint.
+ * @template TBlueprint - The structure of your API (nested objects containing QueryBuilders).
+ * @param blueprint - The static object defining your API structure.
+ * @returns A function `createModel(ctx)` that takes your Context and returns the fully typed API.
+ * @example
+ * const modelFactory = createModelFactory({
+ *   users: { get: userGetQuery }
+ * });
+ * const DB = modelFactory({ db: myDb });
+ */
+declare function createModelFactory<TBlueprint extends Record<string, unknown>>(blueprint: TBlueprint): <TContext>(ctx: TContext) => HydratedModel<TBlueprint, TContext>;
+
+/**
+ * The core builder class for creating type-safe database procedures.
+ * Implements a fluent interface to chain validation, middleware, and handlers.
+ * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).
+ * @template TCurrentContext - The Context type at the current stage of the pipeline (modified by previous middlewares).
+ * @template TInput - The validated input type (inferred from Zod).
+ */
+declare class ProcedureBuilder<TRootContext, TCurrentContext, TInput extends z.ZodType> {
+    #private;
+    constructor(schema?: TInput, middlewares?: ProcedureMiddleware[]);
+    /**
+     * Define input validation.
+     * Resets TInput to the inferred Zod type.
+     */
+    input<TSchema extends z.ZodType>(schema: TSchema): ProcedureBuilder<TRootContext, TCurrentContext, TSchema>;
+    /**
+     * Add middleware.
+     * Transforms TCurrentContext -> TNextContext.
+     */
+    use<TNextContext>(middleware: (params: {
+        ctx: TCurrentContext;
+        input: z.infer<TInput>;
+    }) => Promise<TNextContext> | TNextContext): ProcedureBuilder<TRootContext, TNextContext, TInput>;
+    /**
+     * Finalize the query.
+     * Returns a QueryBuilder that expects TRootContext.
+     */
+    query<TResult>(handler: (params: {
+        ctx: TCurrentContext;
+        input: z.infer<TInput>;
+    }) => Promise<TResult>): QueryBuilder<TRootContext, z.infer<TInput>, TResult>;
+}
+
+/**
+ * Initialize a new procedure builder.
+ * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).
+ * @returns A new ProcedureBuilder instance.
+ */
+declare function initProcedure<TRootContext>(): ProcedureBuilder<TRootContext, TRootContext, z.ZodAny>;
+type ModelErrorOptions = {
+    message?: string;
+};
+declare class ModelError extends Error {
+    readonly status: number;
+    constructor(status: number, options?: ModelErrorOptions);
+}
+
+export { ModelError, createModelFactory, initProcedure };
+export type { GenericProcedureMiddleware, HydratedModel };

package/dist/index.d.ts

@@ -30,6 +30,10 @@ type ProcedureMiddleware = (params: {
     ctx: unknown;
     input: unknown;
 }) => Promise<unknown> | unknown;
+type GenericProcedureMiddleware<Context> = (params: {
+    ctx: Context;
+    input: unknown;
+}) => Promise<unknown> | unknown;
 
 /**
  * Creates a Model Factory based on your API Blueprint.
@@ -91,4 +95,5 @@ declare class ModelError extends Error {
     constructor(status: number, options?: ModelErrorOptions);
 }
 
-export { type HydratedModel, ModelError, createModelFactory, initProcedure };
+export { ModelError, createModelFactory, initProcedure };
+export type { GenericProcedureMiddleware, HydratedModel };

package/dist/index.mjs

@@ -0,0 +1,26 @@
+import { i as isQueryBuilder, a as isPlainObject } from './shared/model-blueprint.JM5S8yAe.mjs';
+export { M as ModelError, b as initProcedure } from './shared/model-blueprint.JM5S8yAe.mjs';
+import 'zod';
+
+function createModelFactory(blueprint) {
+  return function createModel(ctx) {
+    const hydrate = (structure) => {
+      const result = {};
+      for (const key in structure) {
+        const value = structure[key];
+        if (isQueryBuilder(value)) {
+          result[key] = value(ctx);
+        } else if (isPlainObject(value)) {
+          result[key] = hydrate(value);
+        } else {
+          result[key] = value;
+        }
+      }
+      return result;
+    };
+    return hydrate(blueprint);
+  };
+}
+
+export { createModelFactory };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/createModelFactory.ts"],"sourcesContent":["import type { HydratedModel } from './types';\nimport { isPlainObject, isQueryBuilder } from './utils';\n\n/**\n * Creates a Model Factory based on your API Blueprint.\n * @template TBlueprint - The structure of your API (nested objects containing QueryBuilders).\n * @param blueprint - The static object defining your API structure.\n * @returns A function `createModel(ctx)` that takes your Context and returns the fully typed API.\n * @example\n * const modelFactory = createModelFactory({\n *   users: { get: userGetQuery }\n * });\n * const DB = modelFactory({ db: myDb });\n */\nexport function createModelFactory<TBlueprint extends Record<string, unknown>>(\n  blueprint: TBlueprint\n) {\n  /**\n   * The actual factory function used at runtime per-request.\n   * @param ctx - The dependency injection context (must match TRootContext of your builders).\n   */\n  return function createModel<TContext>(\n    ctx: TContext\n  ): HydratedModel<TBlueprint, TContext> {\n    // Recursive function to walk the blueprint tree and inject context.\n    const hydrate = (structure: Record<string, unknown>): unknown => {\n      const result: Record<string, unknown> = {};\n\n      for (const key in structure) {\n        const value = structure[key];\n\n        if (isQueryBuilder(value)) {\n          // Safe execution via Type Guard\n          // value is strictly QueryBuilder<unknown, unknown, unknown>\n          result[key] = value(ctx);\n          // Note: We perform one specific cast here because TypeScript\n          // cannot correlate the TContext generic of the *specific* builder\n          // with the TContext passed to the factory without excessive complexity.\n          // However, the *Generics* on the class ensure safety for the user.\n        } else if (isPlainObject(value)) {\n          result[key] = hydrate(value);\n        } else {\n          result[key] = value;\n        }\n      }\n      return result;\n    };\n\n    return hydrate(blueprint) as HydratedModel<TBlueprint, TContext>;\n  };\n}\n"],"names":[],"mappings":";;;;AAcO,SAAS,mBACd,SAAA,EACA;AAKA,EAAA,OAAO,SAAS,YACd,GAAA,EACqC;AAErC,IAAA,MAAM,OAAA,GAAU,CAAC,SAAA,KAAgD;AAC/D,MAAA,MAAM,SAAkC,EAAC;AAEzC,MAAA,KAAA,MAAW,OAAO,SAAA,EAAW;AAC3B,QAAA,MAAM,KAAA,GAAQ,UAAU,GAAG,CAAA;AAE3B,QAAA,IAAI,cAAA,CAAe,KAAK,CAAA,EAAG;AAGzB,UAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA,CAAM,GAAG,CAAA;AAAA,QAKzB,CAAA,MAAA,IAAW,aAAA,CAAc,KAAK,CAAA,EAAG;AAC/B,UAAA,MAAA,CAAO,GAAG,CAAA,GAAI,OAAA,CAAQ,KAAK,CAAA;AAAA,QAC7B,CAAA,MAAO;AACL,UAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA;AAAA,QAChB;AAAA,MACF;AACA,MAAA,OAAO,MAAA;AAAA,IACT,CAAA;AAEA,IAAA,OAAO,QAAQ,SAAS,CAAA;AAAA,EAC1B,CAAA;AACF;;;;"}

package/dist/{index.js → shared/model-blueprint.D9hykuhu.cjs}

@@ -1,17 +1,22 @@
+'use strict';
+
+const z = require('zod');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const z__default = /*#__PURE__*/_interopDefaultCompat(z);
+
+const QUERY_MARKER = Symbol("QUERY_BUILDER");
+
 var __typeError = (msg) => {
   throw TypeError(msg);
 };
 var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
-var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), member.get(obj));
 var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
-
-// src/constant.ts
-var QUERY_MARKER = /* @__PURE__ */ Symbol("QUERY_BUILDER");
-
-// src/ProcedureBuilder.ts
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), member.set(obj, value), value);
 var _middlewares, _schema;
-var _ProcedureBuilder = class _ProcedureBuilder {
+const _ProcedureBuilder = class _ProcedureBuilder {
   constructor(schema, middlewares = []) {
     __privateAdd(this, _middlewares);
     __privateAdd(this, _schema);
@@ -76,9 +81,8 @@ var _ProcedureBuilder = class _ProcedureBuilder {
 };
 _middlewares = new WeakMap();
 _schema = new WeakMap();
-var ProcedureBuilder = _ProcedureBuilder;
+let ProcedureBuilder = _ProcedureBuilder;
 
-// src/utils.ts
 function isQueryBuilder(value) {
   return typeof value === "function" && QUERY_MARKER in value && value[QUERY_MARKER] === true;
 }
@@ -88,46 +92,25 @@ function isPlainObject(value) {
 function initProcedure() {
   return new ProcedureBuilder();
 }
-var parseSchema = (schema, input) => {
+const parseSchema = (schema, input) => {
   const parsed = schema.safeParse(input);
   if (!parsed.success) {
     throw new ModelError(400, {
-      message: "input-not-valid"
+      message: z__default.prettifyError(parsed.error)
     });
   }
   return parsed.data;
 };
-var ModelError = class extends Error {
+class ModelError extends Error {
   constructor(status, options) {
     super(options?.message);
     this.status = status;
     this.name = "ModuleError";
   }
-};
-
-// src/createModelFactory.ts
-function createModelFactory(blueprint) {
-  return function createModel(ctx) {
-    const hydrate = (structure) => {
-      const result = {};
-      for (const key in structure) {
-        const value = structure[key];
-        if (isQueryBuilder(value)) {
-          result[key] = value(ctx);
-        } else if (isPlainObject(value)) {
-          result[key] = hydrate(value);
-        } else {
-          result[key] = value;
-        }
-      }
-      return result;
-    };
-    return hydrate(blueprint);
-  };
 }
-export {
-  ModelError,
-  createModelFactory,
-  initProcedure
-};
-//# sourceMappingURL=index.js.map
+
+exports.ModelError = ModelError;
+exports.initProcedure = initProcedure;
+exports.isPlainObject = isPlainObject;
+exports.isQueryBuilder = isQueryBuilder;
+//# sourceMappingURL=model-blueprint.D9hykuhu.cjs.map

package/dist/shared/model-blueprint.D9hykuhu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-blueprint.D9hykuhu.cjs","sources":["../../src/constant.ts","../../src/ProcedureBuilder.ts","../../src/utils.ts"],"sourcesContent":["/**\n * A unique symbol used to identify `QueryBuilder` functions at runtime.\n * This prevents accidental execution of arbitrary functions found in the blueprint object.\n * @internal\n */\nexport const QUERY_MARKER = Symbol('QUERY_BUILDER');\n","import z from 'zod';\nimport type { ProcedureMiddleware, QueryBuilder } from './types';\nimport { QUERY_MARKER } from './constant';\nimport { parseSchema } from './utils';\n\n/**\n * The core builder class for creating type-safe database procedures.\n * Implements a fluent interface to chain validation, middleware, and handlers.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @template TCurrentContext - The Context type at the current stage of the pipeline (modified by previous middlewares).\n * @template TInput - The validated input type (inferred from Zod).\n */\nexport class ProcedureBuilder<\n  TRootContext,\n  TCurrentContext,\n  TInput extends z.ZodType,\n> {\n  readonly #middlewares: ProcedureMiddleware[];\n  readonly #schema: TInput | undefined;\n\n  constructor(schema?: TInput, middlewares: ProcedureMiddleware[] = []) {\n    this.#schema = schema;\n    this.#middlewares = middlewares;\n  }\n  /**\n   * Define input validation.\n   * Resets TInput to the inferred Zod type.\n   */\n  public input<TSchema extends z.ZodType>(schema: TSchema) {\n    return new ProcedureBuilder<TRootContext, TCurrentContext, TSchema>(\n      schema,\n      this.#middlewares\n    );\n  }\n\n  /**\n   * Add middleware.\n   * Transforms TCurrentContext -> TNextContext.\n   */\n  public use<TNextContext>(\n    middleware: (params: {\n      ctx: TCurrentContext;\n      input: z.infer<TInput>;\n    }) => Promise<TNextContext> | TNextContext\n  ) {\n    // We cast the middleware to the internal unknown type to store it\n    const storedMiddleware: ProcedureMiddleware = async (p) => {\n      // Safe casting because the class generics enforce strict usage upstream\n      return middleware({\n        ctx: p.ctx as TCurrentContext,\n        input: p.input as z.infer<TInput>,\n      });\n    };\n\n    return new ProcedureBuilder<TRootContext, TNextContext, TInput>(\n      this.#schema,\n      [...this.#middlewares, storedMiddleware]\n    );\n  }\n\n  /**\n   * Finalize the query.\n   * Returns a QueryBuilder that expects TRootContext.\n   */\n  public query<TResult>(\n    handler: (params: {\n      ctx: TCurrentContext;\n      input: z.infer<TInput>;\n    }) => Promise<TResult>\n  ): QueryBuilder<TRootContext, z.infer<TInput>, TResult> {\n    // The Factory-Compatible Builder\n    const builder = (rootCtx: TRootContext) => {\n      return async (rawInput: z.infer<TInput>): Promise<TResult> => {\n        // A. Validation\n        if (!this.#schema) {\n          throw new Error('No schema provided for query');\n        }\n        const validatedInput = parseSchema(this.#schema, rawInput);\n\n        // B. Middleware Pipeline\n        // We start with the Root Context\n        let ctxCursor: unknown = rootCtx;\n\n        for (const mw of this.#middlewares) {\n          ctxCursor = await mw({ ctx: ctxCursor, input: validatedInput });\n        }\n\n        // C. Handler\n        return handler({\n          ctx: ctxCursor as TCurrentContext,\n          input: validatedInput,\n        });\n      };\n    };\n\n    // Attach Marker safely\n    Object.defineProperty(builder, QUERY_MARKER, {\n      value: true,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    });\n\n    return builder as QueryBuilder<TRootContext, z.infer<TInput>, TResult>;\n  }\n}\n","import z, { ZodAny } from 'zod';\nimport { QUERY_MARKER } from './constant';\nimport { QueryBuilder } from './types';\nimport { ProcedureBuilder } from './ProcedureBuilder';\n\n/**\n * Type guard to check if a value is a valid `QueryBuilder`.\n * Used internally by the repository factory during hydration.\n * @param value - The value to check.\n * @returns True if the value is a QueryBuilder function.\n */\nexport function isQueryBuilder<TContext>(\n  value: unknown\n): value is QueryBuilder<TContext, unknown, unknown> {\n  return (\n    typeof value === 'function' &&\n    QUERY_MARKER in value &&\n    (value as { [QUERY_MARKER]: boolean })[QUERY_MARKER] === true\n  );\n}\n\n/**\n * Type guard to check if a value is a plain JavaScript object.\n * Used to determine if recursion is needed during repository hydration.\n * Excludes null, Arrays, and Dates.\n * @param value - The value to check.\n * @returns True if the value is a plain object.\n */\nexport function isPlainObject(\n  value: unknown\n): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  );\n}\n\n/**\n * Initialize a new procedure builder.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @returns A new ProcedureBuilder instance.\n */\nexport function initProcedure<TRootContext>() {\n  // Initial state: Root = Current, Input = unknown\n  return new ProcedureBuilder<TRootContext, TRootContext, ZodAny>();\n}\n\nexport const parseSchema = <TInput extends z.ZodType>(\n  schema: TInput,\n  input: unknown\n) => {\n  const parsed = schema.safeParse(input);\n\n  if (!parsed.success) {\n    throw new ModelError(400, {\n      message: z.prettifyError(parsed.error),\n    });\n  }\n\n  return parsed.data;\n};\n\ntype ModelErrorOptions = {\n  message?: string;\n};\n\nexport class ModelError extends Error {\n  constructor(\n    public readonly status: number,\n    options?: ModelErrorOptions\n  ) {\n    super(options?.message);\n    this.name = 'ModuleError';\n  }\n}\n"],"names":["z"],"mappings":"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"}

package/dist/shared/model-blueprint.JM5S8yAe.mjs

@@ -0,0 +1,107 @@
+import z from 'zod';
+
+const QUERY_MARKER = Symbol("QUERY_BUILDER");
+
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), member.set(obj, value), value);
+var _middlewares, _schema;
+const _ProcedureBuilder = class _ProcedureBuilder {
+  constructor(schema, middlewares = []) {
+    __privateAdd(this, _middlewares);
+    __privateAdd(this, _schema);
+    __privateSet(this, _schema, schema);
+    __privateSet(this, _middlewares, middlewares);
+  }
+  /**
+   * Define input validation.
+   * Resets TInput to the inferred Zod type.
+   */
+  input(schema) {
+    return new _ProcedureBuilder(
+      schema,
+      __privateGet(this, _middlewares)
+    );
+  }
+  /**
+   * Add middleware.
+   * Transforms TCurrentContext -> TNextContext.
+   */
+  use(middleware) {
+    const storedMiddleware = async (p) => {
+      return middleware({
+        ctx: p.ctx,
+        input: p.input
+      });
+    };
+    return new _ProcedureBuilder(
+      __privateGet(this, _schema),
+      [...__privateGet(this, _middlewares), storedMiddleware]
+    );
+  }
+  /**
+   * Finalize the query.
+   * Returns a QueryBuilder that expects TRootContext.
+   */
+  query(handler) {
+    const builder = (rootCtx) => {
+      return async (rawInput) => {
+        if (!__privateGet(this, _schema)) {
+          throw new Error("No schema provided for query");
+        }
+        const validatedInput = parseSchema(__privateGet(this, _schema), rawInput);
+        let ctxCursor = rootCtx;
+        for (const mw of __privateGet(this, _middlewares)) {
+          ctxCursor = await mw({ ctx: ctxCursor, input: validatedInput });
+        }
+        return handler({
+          ctx: ctxCursor,
+          input: validatedInput
+        });
+      };
+    };
+    Object.defineProperty(builder, QUERY_MARKER, {
+      value: true,
+      writable: false,
+      enumerable: false,
+      configurable: false
+    });
+    return builder;
+  }
+};
+_middlewares = new WeakMap();
+_schema = new WeakMap();
+let ProcedureBuilder = _ProcedureBuilder;
+
+function isQueryBuilder(value) {
+  return typeof value === "function" && QUERY_MARKER in value && value[QUERY_MARKER] === true;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+}
+function initProcedure() {
+  return new ProcedureBuilder();
+}
+const parseSchema = (schema, input) => {
+  const parsed = schema.safeParse(input);
+  if (!parsed.success) {
+    throw new ModelError(400, {
+      message: z.prettifyError(parsed.error)
+    });
+  }
+  return parsed.data;
+};
+class ModelError extends Error {
+  constructor(status, options) {
+    super(options?.message);
+    this.status = status;
+    this.name = "ModuleError";
+  }
+}
+
+export { ModelError as M, isPlainObject as a, initProcedure as b, isQueryBuilder as i };
+//# sourceMappingURL=model-blueprint.JM5S8yAe.mjs.map

package/dist/shared/model-blueprint.JM5S8yAe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-blueprint.JM5S8yAe.mjs","sources":["../../src/constant.ts","../../src/ProcedureBuilder.ts","../../src/utils.ts"],"sourcesContent":["/**\n * A unique symbol used to identify `QueryBuilder` functions at runtime.\n * This prevents accidental execution of arbitrary functions found in the blueprint object.\n * @internal\n */\nexport const QUERY_MARKER = Symbol('QUERY_BUILDER');\n","import z from 'zod';\nimport type { ProcedureMiddleware, QueryBuilder } from './types';\nimport { QUERY_MARKER } from './constant';\nimport { parseSchema } from './utils';\n\n/**\n * The core builder class for creating type-safe database procedures.\n * Implements a fluent interface to chain validation, middleware, and handlers.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @template TCurrentContext - The Context type at the current stage of the pipeline (modified by previous middlewares).\n * @template TInput - The validated input type (inferred from Zod).\n */\nexport class ProcedureBuilder<\n  TRootContext,\n  TCurrentContext,\n  TInput extends z.ZodType,\n> {\n  readonly #middlewares: ProcedureMiddleware[];\n  readonly #schema: TInput | undefined;\n\n  constructor(schema?: TInput, middlewares: ProcedureMiddleware[] = []) {\n    this.#schema = schema;\n    this.#middlewares = middlewares;\n  }\n  /**\n   * Define input validation.\n   * Resets TInput to the inferred Zod type.\n   */\n  public input<TSchema extends z.ZodType>(schema: TSchema) {\n    return new ProcedureBuilder<TRootContext, TCurrentContext, TSchema>(\n      schema,\n      this.#middlewares\n    );\n  }\n\n  /**\n   * Add middleware.\n   * Transforms TCurrentContext -> TNextContext.\n   */\n  public use<TNextContext>(\n    middleware: (params: {\n      ctx: TCurrentContext;\n      input: z.infer<TInput>;\n    }) => Promise<TNextContext> | TNextContext\n  ) {\n    // We cast the middleware to the internal unknown type to store it\n    const storedMiddleware: ProcedureMiddleware = async (p) => {\n      // Safe casting because the class generics enforce strict usage upstream\n      return middleware({\n        ctx: p.ctx as TCurrentContext,\n        input: p.input as z.infer<TInput>,\n      });\n    };\n\n    return new ProcedureBuilder<TRootContext, TNextContext, TInput>(\n      this.#schema,\n      [...this.#middlewares, storedMiddleware]\n    );\n  }\n\n  /**\n   * Finalize the query.\n   * Returns a QueryBuilder that expects TRootContext.\n   */\n  public query<TResult>(\n    handler: (params: {\n      ctx: TCurrentContext;\n      input: z.infer<TInput>;\n    }) => Promise<TResult>\n  ): QueryBuilder<TRootContext, z.infer<TInput>, TResult> {\n    // The Factory-Compatible Builder\n    const builder = (rootCtx: TRootContext) => {\n      return async (rawInput: z.infer<TInput>): Promise<TResult> => {\n        // A. Validation\n        if (!this.#schema) {\n          throw new Error('No schema provided for query');\n        }\n        const validatedInput = parseSchema(this.#schema, rawInput);\n\n        // B. Middleware Pipeline\n        // We start with the Root Context\n        let ctxCursor: unknown = rootCtx;\n\n        for (const mw of this.#middlewares) {\n          ctxCursor = await mw({ ctx: ctxCursor, input: validatedInput });\n        }\n\n        // C. Handler\n        return handler({\n          ctx: ctxCursor as TCurrentContext,\n          input: validatedInput,\n        });\n      };\n    };\n\n    // Attach Marker safely\n    Object.defineProperty(builder, QUERY_MARKER, {\n      value: true,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    });\n\n    return builder as QueryBuilder<TRootContext, z.infer<TInput>, TResult>;\n  }\n}\n","import z, { ZodAny } from 'zod';\nimport { QUERY_MARKER } from './constant';\nimport { QueryBuilder } from './types';\nimport { ProcedureBuilder } from './ProcedureBuilder';\n\n/**\n * Type guard to check if a value is a valid `QueryBuilder`.\n * Used internally by the repository factory during hydration.\n * @param value - The value to check.\n * @returns True if the value is a QueryBuilder function.\n */\nexport function isQueryBuilder<TContext>(\n  value: unknown\n): value is QueryBuilder<TContext, unknown, unknown> {\n  return (\n    typeof value === 'function' &&\n    QUERY_MARKER in value &&\n    (value as { [QUERY_MARKER]: boolean })[QUERY_MARKER] === true\n  );\n}\n\n/**\n * Type guard to check if a value is a plain JavaScript object.\n * Used to determine if recursion is needed during repository hydration.\n * Excludes null, Arrays, and Dates.\n * @param value - The value to check.\n * @returns True if the value is a plain object.\n */\nexport function isPlainObject(\n  value: unknown\n): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  );\n}\n\n/**\n * Initialize a new procedure builder.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @returns A new ProcedureBuilder instance.\n */\nexport function initProcedure<TRootContext>() {\n  // Initial state: Root = Current, Input = unknown\n  return new ProcedureBuilder<TRootContext, TRootContext, ZodAny>();\n}\n\nexport const parseSchema = <TInput extends z.ZodType>(\n  schema: TInput,\n  input: unknown\n) => {\n  const parsed = schema.safeParse(input);\n\n  if (!parsed.success) {\n    throw new ModelError(400, {\n      message: z.prettifyError(parsed.error),\n    });\n  }\n\n  return parsed.data;\n};\n\ntype ModelErrorOptions = {\n  message?: string;\n};\n\nexport class ModelError extends Error {\n  constructor(\n    public readonly status: number,\n    options?: ModelErrorOptions\n  ) {\n    super(options?.message);\n    this.name = 'ModuleError';\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/withCursor.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const getCursor = (entries, parameter, pageSize) => entries.length && pageSize === entries.length ? entries[entries.length - 1][parameter] : null;
+const withCursor = (entries, parameter, pageSize, orderedBy = "asc") => {
+  const cursor = getCursor(entries, parameter, pageSize);
+  return {
+    entries: orderedBy === "asc" ? entries : entries.reverse(),
+    cursor
+  };
+};
+
+exports.withCursor = withCursor;
+//# sourceMappingURL=withCursor.cjs.map

package/dist/withCursor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"withCursor.cjs","sources":["../src/queryUtils/withCursor.ts"],"sourcesContent":["const getCursor = <T extends Record<string, unknown | number>>(\n  entries: Array<T>,\n  parameter: keyof T,\n  pageSize: number\n) =>\n  entries.length && pageSize === entries.length\n    ? (entries[entries.length - 1][parameter] as number)\n    : null;\n\nexport const withCursor = <T extends Record<string, unknown | number>>(\n  entries: Array<T>,\n  parameter: keyof T,\n  pageSize: number,\n  orderedBy: 'asc' | 'desc' = 'asc'\n) => {\n  const cursor = getCursor<T>(entries, parameter, pageSize);\n\n  return {\n    entries: orderedBy === 'asc' ? entries : entries.reverse(),\n    cursor,\n  };\n};\n"],"names":[],"mappings":";;AAAA,MAAM,YAAY,CAChB,OAAA,EACA,SAAA,EACA,QAAA,KAEA,QAAQ,MAAA,IAAU,QAAA,KAAa,OAAA,CAAQ,MAAA,GAClC,QAAQ,OAAA,CAAQ,MAAA,GAAS,CAAC,CAAA,CAAE,SAAS,CAAA,GACtC,IAAA;AAEC,MAAM,aAAa,CACxB,OAAA,EACA,SAAA,EACA,QAAA,EACA,YAA4B,KAAA,KACzB;AACH,EAAA,MAAM,MAAA,GAAS,SAAA,CAAa,OAAA,EAAS,SAAA,EAAW,QAAQ,CAAA;AAExD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,SAAA,KAAc,KAAA,GAAQ,OAAA,GAAU,QAAQ,OAAA,EAAQ;AAAA,IACzD;AAAA,GACF;AACF;;;;"}

package/dist/withCursor.d.cts

@@ -0,0 +1,6 @@
+declare const withCursor: <T extends Record<string, unknown | number>>(entries: Array<T>, parameter: keyof T, pageSize: number, orderedBy?: "asc" | "desc") => {
+    entries: T[];
+    cursor: number | null;
+};
+
+export { withCursor };

package/dist/withCursor.d.mts

@@ -0,0 +1,6 @@
+declare const withCursor: <T extends Record<string, unknown | number>>(entries: Array<T>, parameter: keyof T, pageSize: number, orderedBy?: "asc" | "desc") => {
+    entries: T[];
+    cursor: number | null;
+};
+
+export { withCursor };

package/dist/withCursor.mjs

@@ -0,0 +1,11 @@
+const getCursor = (entries, parameter, pageSize) => entries.length && pageSize === entries.length ? entries[entries.length - 1][parameter] : null;
+const withCursor = (entries, parameter, pageSize, orderedBy = "asc") => {
+  const cursor = getCursor(entries, parameter, pageSize);
+  return {
+    entries: orderedBy === "asc" ? entries : entries.reverse(),
+    cursor
+  };
+};
+
+export { withCursor };
+//# sourceMappingURL=withCursor.mjs.map

package/dist/withCursor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"withCursor.mjs","sources":["../src/queryUtils/withCursor.ts"],"sourcesContent":["const getCursor = <T extends Record<string, unknown | number>>(\n  entries: Array<T>,\n  parameter: keyof T,\n  pageSize: number\n) =>\n  entries.length && pageSize === entries.length\n    ? (entries[entries.length - 1][parameter] as number)\n    : null;\n\nexport const withCursor = <T extends Record<string, unknown | number>>(\n  entries: Array<T>,\n  parameter: keyof T,\n  pageSize: number,\n  orderedBy: 'asc' | 'desc' = 'asc'\n) => {\n  const cursor = getCursor<T>(entries, parameter, pageSize);\n\n  return {\n    entries: orderedBy === 'asc' ? entries : entries.reverse(),\n    cursor,\n  };\n};\n"],"names":[],"mappings":"AAAA,MAAM,YAAY,CAChB,OAAA,EACA,SAAA,EACA,QAAA,KAEA,QAAQ,MAAA,IAAU,QAAA,KAAa,OAAA,CAAQ,MAAA,GAClC,QAAQ,OAAA,CAAQ,MAAA,GAAS,CAAC,CAAA,CAAE,SAAS,CAAA,GACtC,IAAA;AAEC,MAAM,aAAa,CACxB,OAAA,EACA,SAAA,EACA,QAAA,EACA,YAA4B,KAAA,KACzB;AACH,EAAA,MAAM,MAAA,GAAS,SAAA,CAAa,OAAA,EAAS,SAAA,EAAW,QAAQ,CAAA;AAExD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,SAAA,KAAc,KAAA,GAAQ,OAAA,GAAU,QAAQ,OAAA,EAAQ;AAAA,IACzD;AAAA,GACF;AACF;;;;"}

package/package.json

@@ -1,31 +1,42 @@
 {
   "name": "model-blueprint",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "type": "module",
-  "main": "dist/index.js",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
     },
     "./withCursor": {
-      "import": "./dist/withCursor.js",
-      "types": "./dist/withCursor.d.ts"
+      "types": "./dist/withCursor.d.ts",
+      "import": "./dist/withCursor.mjs",
+      "require": "./dist/withCursor.cjs",
+      "default": "./dist/withCursor.mjs"
     },
     "./createId": {
-      "import": "./dist/createId.js",
-      "types": "./dist/createId.d.ts"
+      "types": "./dist/createId.d.ts",
+      "import": "./dist/createId.mjs",
+      "require": "./dist/createId.cjs",
+      "default": "./dist/createId.mjs"
     },
     "./dropQuery": {
-      "import": "./dist/dropQuery.js",
-      "types": "./dist/dropQuery.d.ts"
-    }
+      "types": "./dist/dropQuery.d.ts",
+      "import": "./dist/dropQuery.mjs",
+      "require": "./dist/dropQuery.cjs",
+      "default": "./dist/dropQuery.mjs"
+    },
+    "./package.json": "./package.json"
   },
   "scripts": {
     "prepare": "husky",
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "prepack": "unbuild",
     "test": "vitest",
     "test:ui": "vitest --ui",
     "coverage": "vitest --coverage",
@@ -54,20 +65,20 @@
   },
   "description": "model-blueprint",
   "dependencies": {
-    "zod": "^4.3.6",
-    "@paralleldrive/cuid2": "^3.3.0"
+    "@paralleldrive/cuid2": "^3.3.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@eslint/js": "^9.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@eslint/js": "^10.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.64.0",
     "@typescript-eslint/parser": "^8.0.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^9.0.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^10.7.0",
     "husky": "^9.1.7",
-    "prettier": "^3.8.1",
-    "tsup": "^8.5.1",
-    "typescript": "^5.0.0",
-    "vitest": "^4.0.18"
+    "prettier": "^3.9.5",
+    "typescript": "^5.9.3",
+    "unbuild": "^3.6.1",
+    "vitest": "^4.1.10"
   },
   "files": [
     "dist"

package/dist/createId.js

@@ -1,12 +0,0 @@
-// src/queryUtils/createId.ts
-import {
-  createId as createCuid2Id,
-  init as initCuid2
-} from "@paralleldrive/cuid2";
-var createId = ({ ctx }) => {
-  return { ...ctx, createId: createCuid2Id, init: initCuid2 };
-};
-export {
-  createId
-};
-//# sourceMappingURL=createId.js.map

package/dist/createId.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/queryUtils/createId.ts"],"sourcesContent":["import {\n  createId as createCuid2Id,\n  init as initCuid2,\n} from '@paralleldrive/cuid2';\n\n/**\n * Middleware factory that adds a `createId` and `init` function to the context.\n * This function allows procedures to create CUID2 IDs and initialize CUID2.\n * @template TContext - The context type.\n * @param ctx - The context object.\n * @returns A middleware function that injects the `createId` and `init` helpers into the context.\n */\nexport const createId = <TContext>({ ctx }: { ctx: TContext }) => {\n  return { ...ctx, createId: createCuid2Id, init: initCuid2 };\n};\n"],"mappings":";AAAA;AAAA,EACE,YAAY;AAAA,EACZ,QAAQ;AAAA,OACH;AASA,IAAM,WAAW,CAAW,EAAE,IAAI,MAAyB;AAChE,SAAO,EAAE,GAAG,KAAK,UAAU,eAAe,MAAM,UAAU;AAC5D;","names":[]}

package/dist/dropQuery.js

@@ -1,22 +0,0 @@
-// src/utils.ts
-var ModelError = class extends Error {
-  constructor(status, options) {
-    super(options?.message);
-    this.status = status;
-    this.name = "ModuleError";
-  }
-};
-
-// src/queryUtils/dropQuery.ts
-var dropQuery = (dropMessages) => ({ ctx }) => {
-  const drop = (message, code) => {
-    throw new ModelError(code ?? 400, {
-      message: dropMessages[message]
-    });
-  };
-  return { ...ctx, drop };
-};
-export {
-  dropQuery
-};
-//# sourceMappingURL=dropQuery.js.map

package/dist/dropQuery.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils.ts","../src/queryUtils/dropQuery.ts"],"sourcesContent":["import z, { ZodAny } from 'zod';\nimport { QUERY_MARKER } from './constant';\nimport { QueryBuilder } from './types';\nimport { ProcedureBuilder } from './ProcedureBuilder';\n\n/**\n * Type guard to check if a value is a valid `QueryBuilder`.\n * Used internally by the repository factory during hydration.\n * @param value - The value to check.\n * @returns True if the value is a QueryBuilder function.\n */\nexport function isQueryBuilder<TContext>(\n  value: unknown\n): value is QueryBuilder<TContext, unknown, unknown> {\n  return (\n    typeof value === 'function' &&\n    QUERY_MARKER in value &&\n    (value as { [QUERY_MARKER]: boolean })[QUERY_MARKER] === true\n  );\n}\n\n/**\n * Type guard to check if a value is a plain JavaScript object.\n * Used to determine if recursion is needed during repository hydration.\n * Excludes null, Arrays, and Dates.\n * @param value - The value to check.\n * @returns True if the value is a plain object.\n */\nexport function isPlainObject(\n  value: unknown\n): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  );\n}\n\n/**\n * Initialize a new procedure builder.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @returns A new ProcedureBuilder instance.\n */\nexport function initProcedure<TRootContext>() {\n  // Initial state: Root = Current, Input = unknown\n  return new ProcedureBuilder<TRootContext, TRootContext, ZodAny>();\n}\n\nexport const parseSchema = <TInput extends z.ZodType>(\n  schema: TInput,\n  input: unknown\n) => {\n  const parsed = schema.safeParse(input);\n\n  if (!parsed.success) {\n    throw new ModelError(400, {\n      message: 'input-not-valid',\n    });\n  }\n\n  return parsed.data;\n};\n\ntype ModelErrorOptions = {\n  message?: string;\n};\n\nexport class ModelError extends Error {\n  constructor(\n    public readonly status: number,\n    options?: ModelErrorOptions\n  ) {\n    super(options?.message);\n    this.name = 'ModuleError';\n  }\n}\n","import { ModelError } from '@/utils';\n\n/**\n * Middleware factory that adds a `drop` function to the context.\n * This function allows procedures to throw controlled HTTP errors with specific messages.\n * @template Messages - A map of error keys to their corresponding message strings.\n * @param dropMessages - An object mapping error keys to messages.\n * @returns A middleware function that injects the `drop` helper into the context.\n */\nexport const dropQuery =\n  <Messages extends Record<string, string>>(dropMessages: Messages) =>\n  <TContext>({ ctx }: { ctx: TContext }) => {\n    const drop = <Key extends keyof Messages>(message: Key, code?: number) => {\n      throw new ModelError(code ?? 400, {\n        message: dropMessages[message],\n      });\n    };\n\n    return { ...ctx, drop };\n  };\n"],"mappings":";AAoEO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YACkB,QAChB,SACA;AACA,UAAM,SAAS,OAAO;AAHN;AAIhB,SAAK,OAAO;AAAA,EACd;AACF;;;ACnEO,IAAM,YACX,CAA0C,iBAC1C,CAAW,EAAE,IAAI,MAAyB;AACxC,QAAM,OAAO,CAA6B,SAAc,SAAkB;AACxE,UAAM,IAAI,WAAW,QAAQ,KAAK;AAAA,MAChC,SAAS,aAAa,OAAO;AAAA,IAC/B,CAAC;AAAA,EACH;AAEA,SAAO,EAAE,GAAG,KAAK,KAAK;AACxB;","names":[]}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/constant.ts","../src/ProcedureBuilder.ts","../src/utils.ts","../src/createModelFactory.ts"],"sourcesContent":["/**\n * A unique symbol used to identify `QueryBuilder` functions at runtime.\n * This prevents accidental execution of arbitrary functions found in the blueprint object.\n * @internal\n */\nexport const QUERY_MARKER = Symbol('QUERY_BUILDER');\n","import z from 'zod';\nimport type { ProcedureMiddleware, QueryBuilder } from './types';\nimport { QUERY_MARKER } from './constant';\nimport { parseSchema } from './utils';\n\n/**\n * The core builder class for creating type-safe database procedures.\n * Implements a fluent interface to chain validation, middleware, and handlers.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @template TCurrentContext - The Context type at the current stage of the pipeline (modified by previous middlewares).\n * @template TInput - The validated input type (inferred from Zod).\n */\nexport class ProcedureBuilder<\n  TRootContext,\n  TCurrentContext,\n  TInput extends z.ZodType,\n> {\n  readonly #middlewares: ProcedureMiddleware[];\n  readonly #schema: TInput | undefined;\n\n  constructor(schema?: TInput, middlewares: ProcedureMiddleware[] = []) {\n    this.#schema = schema;\n    this.#middlewares = middlewares;\n  }\n  /**\n   * Define input validation.\n   * Resets TInput to the inferred Zod type.\n   */\n  public input<TSchema extends z.ZodType>(schema: TSchema) {\n    return new ProcedureBuilder<TRootContext, TCurrentContext, TSchema>(\n      schema,\n      this.#middlewares\n    );\n  }\n\n  /**\n   * Add middleware.\n   * Transforms TCurrentContext -> TNextContext.\n   */\n  public use<TNextContext>(\n    middleware: (params: {\n      ctx: TCurrentContext;\n      input: z.infer<TInput>;\n    }) => Promise<TNextContext> | TNextContext\n  ) {\n    // We cast the middleware to the internal unknown type to store it\n    const storedMiddleware: ProcedureMiddleware = async (p) => {\n      // Safe casting because the class generics enforce strict usage upstream\n      return middleware({\n        ctx: p.ctx as TCurrentContext,\n        input: p.input as z.infer<TInput>,\n      });\n    };\n\n    return new ProcedureBuilder<TRootContext, TNextContext, TInput>(\n      this.#schema,\n      [...this.#middlewares, storedMiddleware]\n    );\n  }\n\n  /**\n   * Finalize the query.\n   * Returns a QueryBuilder that expects TRootContext.\n   */\n  public query<TResult>(\n    handler: (params: {\n      ctx: TCurrentContext;\n      input: z.infer<TInput>;\n    }) => Promise<TResult>\n  ): QueryBuilder<TRootContext, z.infer<TInput>, TResult> {\n    // The Factory-Compatible Builder\n    const builder = (rootCtx: TRootContext) => {\n      return async (rawInput: z.infer<TInput>): Promise<TResult> => {\n        // A. Validation\n        if (!this.#schema) {\n          throw new Error('No schema provided for query');\n        }\n        const validatedInput = parseSchema(this.#schema, rawInput);\n\n        // B. Middleware Pipeline\n        // We start with the Root Context\n        let ctxCursor: unknown = rootCtx;\n\n        for (const mw of this.#middlewares) {\n          ctxCursor = await mw({ ctx: ctxCursor, input: validatedInput });\n        }\n\n        // C. Handler\n        return handler({\n          ctx: ctxCursor as TCurrentContext,\n          input: validatedInput,\n        });\n      };\n    };\n\n    // Attach Marker safely\n    Object.defineProperty(builder, QUERY_MARKER, {\n      value: true,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    });\n\n    return builder as QueryBuilder<TRootContext, z.infer<TInput>, TResult>;\n  }\n}\n","import z, { ZodAny } from 'zod';\nimport { QUERY_MARKER } from './constant';\nimport { QueryBuilder } from './types';\nimport { ProcedureBuilder } from './ProcedureBuilder';\n\n/**\n * Type guard to check if a value is a valid `QueryBuilder`.\n * Used internally by the repository factory during hydration.\n * @param value - The value to check.\n * @returns True if the value is a QueryBuilder function.\n */\nexport function isQueryBuilder<TContext>(\n  value: unknown\n): value is QueryBuilder<TContext, unknown, unknown> {\n  return (\n    typeof value === 'function' &&\n    QUERY_MARKER in value &&\n    (value as { [QUERY_MARKER]: boolean })[QUERY_MARKER] === true\n  );\n}\n\n/**\n * Type guard to check if a value is a plain JavaScript object.\n * Used to determine if recursion is needed during repository hydration.\n * Excludes null, Arrays, and Dates.\n * @param value - The value to check.\n * @returns True if the value is a plain object.\n */\nexport function isPlainObject(\n  value: unknown\n): value is Record<string, unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    !Array.isArray(value) &&\n    !(value instanceof Date)\n  );\n}\n\n/**\n * Initialize a new procedure builder.\n * @template TRootContext - The initial Context type provided by the application (e.g., Raw Request Context).\n * @returns A new ProcedureBuilder instance.\n */\nexport function initProcedure<TRootContext>() {\n  // Initial state: Root = Current, Input = unknown\n  return new ProcedureBuilder<TRootContext, TRootContext, ZodAny>();\n}\n\nexport const parseSchema = <TInput extends z.ZodType>(\n  schema: TInput,\n  input: unknown\n) => {\n  const parsed = schema.safeParse(input);\n\n  if (!parsed.success) {\n    throw new ModelError(400, {\n      message: 'input-not-valid',\n    });\n  }\n\n  return parsed.data;\n};\n\ntype ModelErrorOptions = {\n  message?: string;\n};\n\nexport class ModelError extends Error {\n  constructor(\n    public readonly status: number,\n    options?: ModelErrorOptions\n  ) {\n    super(options?.message);\n    this.name = 'ModuleError';\n  }\n}\n","import type { HydratedModel } from './types';\nimport { isPlainObject, isQueryBuilder } from './utils';\n\n/**\n * Creates a Model Factory based on your API Blueprint.\n * @template TBlueprint - The structure of your API (nested objects containing QueryBuilders).\n * @param blueprint - The static object defining your API structure.\n * @returns A function `createModel(ctx)` that takes your Context and returns the fully typed API.\n * @example\n * const modelFactory = createModelFactory({\n *   users: { get: userGetQuery }\n * });\n * const DB = modelFactory({ db: myDb });\n */\nexport function createModelFactory<TBlueprint extends Record<string, unknown>>(\n  blueprint: TBlueprint\n) {\n  /**\n   * The actual factory function used at runtime per-request.\n   * @param ctx - The dependency injection context (must match TRootContext of your builders).\n   */\n  return function createModel<TContext>(\n    ctx: TContext\n  ): HydratedModel<TBlueprint, TContext> {\n    // Recursive function to walk the blueprint tree and inject context.\n    const hydrate = (structure: Record<string, unknown>): unknown => {\n      const result: Record<string, unknown> = {};\n\n      for (const key in structure) {\n        const value = structure[key];\n\n        if (isQueryBuilder(value)) {\n          // Safe execution via Type Guard\n          // value is strictly QueryBuilder<unknown, unknown, unknown>\n          result[key] = value(ctx);\n          // Note: We perform one specific cast here because TypeScript\n          // cannot correlate the TContext generic of the *specific* builder\n          // with the TContext passed to the factory without excessive complexity.\n          // However, the *Generics* on the class ensure safety for the user.\n        } else if (isPlainObject(value)) {\n          result[key] = hydrate(value);\n        } else {\n          result[key] = value;\n        }\n      }\n      return result;\n    };\n\n    return hydrate(blueprint) as HydratedModel<TBlueprint, TContext>;\n  };\n}\n"],"mappings":";;;;;;;;;AAKO,IAAM,eAAe,uBAAO,eAAe;;;ACLlD;AAYO,IAAM,oBAAN,MAAM,kBAIX;AAAA,EAIA,YAAY,QAAiB,cAAqC,CAAC,GAAG;AAHtE,uBAAS;AACT,uBAAS;AAGP,uBAAK,SAAU;AACf,uBAAK,cAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKO,MAAiC,QAAiB;AACvD,WAAO,IAAI;AAAA,MACT;AAAA,MACA,mBAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,IACL,YAIA;AAEA,UAAM,mBAAwC,OAAO,MAAM;AAEzD,aAAO,WAAW;AAAA,QAChB,KAAK,EAAE;AAAA,QACP,OAAO,EAAE;AAAA,MACX,CAAC;AAAA,IACH;AAEA,WAAO,IAAI;AAAA,MACT,mBAAK;AAAA,MACL,CAAC,GAAG,mBAAK,eAAc,gBAAgB;AAAA,IACzC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,MACL,SAIsD;AAEtD,UAAM,UAAU,CAAC,YAA0B;AACzC,aAAO,OAAO,aAAgD;AAE5D,YAAI,CAAC,mBAAK,UAAS;AACjB,gBAAM,IAAI,MAAM,8BAA8B;AAAA,QAChD;AACA,cAAM,iBAAiB,YAAY,mBAAK,UAAS,QAAQ;AAIzD,YAAI,YAAqB;AAEzB,mBAAW,MAAM,mBAAK,eAAc;AAClC,sBAAY,MAAM,GAAG,EAAE,KAAK,WAAW,OAAO,eAAe,CAAC;AAAA,QAChE;AAGA,eAAO,QAAQ;AAAA,UACb,KAAK;AAAA,UACL,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AAGA,WAAO,eAAe,SAAS,cAAc;AAAA,MAC3C,OAAO;AAAA,MACP,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB,CAAC;AAED,WAAO;AAAA,EACT;AACF;AAxFW;AACA;AANJ,IAAM,mBAAN;;;ACDA,SAAS,eACd,OACmD;AACnD,SACE,OAAO,UAAU,cACjB,gBAAgB,SACf,MAAsC,YAAY,MAAM;AAE7D;AASO,SAAS,cACd,OACkC;AAClC,SACE,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,MAAM,QAAQ,KAAK,KACpB,EAAE,iBAAiB;AAEvB;AAOO,SAAS,gBAA8B;AAE5C,SAAO,IAAI,iBAAqD;AAClE;AAEO,IAAM,cAAc,CACzB,QACA,UACG;AACH,QAAM,SAAS,OAAO,UAAU,KAAK;AAErC,MAAI,CAAC,OAAO,SAAS;AACnB,UAAM,IAAI,WAAW,KAAK;AAAA,MACxB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,SAAO,OAAO;AAChB;AAMO,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YACkB,QAChB,SACA;AACA,UAAM,SAAS,OAAO;AAHN;AAIhB,SAAK,OAAO;AAAA,EACd;AACF;;;AC9DO,SAAS,mBACd,WACA;AAKA,SAAO,SAAS,YACd,KACqC;AAErC,UAAM,UAAU,CAAC,cAAgD;AAC/D,YAAM,SAAkC,CAAC;AAEzC,iBAAW,OAAO,WAAW;AAC3B,cAAM,QAAQ,UAAU,GAAG;AAE3B,YAAI,eAAe,KAAK,GAAG;AAGzB,iBAAO,GAAG,IAAI,MAAM,GAAG;AAAA,QAKzB,WAAW,cAAc,KAAK,GAAG;AAC/B,iBAAO,GAAG,IAAI,QAAQ,KAAK;AAAA,QAC7B,OAAO;AACL,iBAAO,GAAG,IAAI;AAAA,QAChB;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAEA,WAAO,QAAQ,SAAS;AAAA,EAC1B;AACF;","names":[]}

package/dist/withCursor.js

@@ -1,13 +0,0 @@
-// src/queryUtils/withCursor.ts
-var getCursor = (entries, parameter, pageSize) => entries.length && pageSize === entries.length ? entries[entries.length - 1][parameter] : null;
-var withCursor = (entries, parameter, pageSize, orderedBy = "asc") => {
-  const cursor = getCursor(entries, parameter, pageSize);
-  return {
-    entries: orderedBy === "asc" ? entries : entries.reverse(),
-    cursor
-  };
-};
-export {
-  withCursor
-};
-//# sourceMappingURL=withCursor.js.map

package/dist/withCursor.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/queryUtils/withCursor.ts"],"sourcesContent":["const getCursor = <T extends Record<string, unknown | number>>(\n  entries: Array<T>,\n  parameter: keyof T,\n  pageSize: number\n) =>\n  entries.length && pageSize === entries.length\n    ? (entries[entries.length - 1][parameter] as number)\n    : null;\n\nexport const withCursor = <T extends Record<string, unknown | number>>(\n  entries: Array<T>,\n  parameter: keyof T,\n  pageSize: number,\n  orderedBy: 'asc' | 'desc' = 'asc'\n) => {\n  const cursor = getCursor<T>(entries, parameter, pageSize);\n\n  return {\n    entries: orderedBy === 'asc' ? entries : entries.reverse(),\n    cursor,\n  };\n};\n"],"mappings":";AAAA,IAAM,YAAY,CAChB,SACA,WACA,aAEA,QAAQ,UAAU,aAAa,QAAQ,SAClC,QAAQ,QAAQ,SAAS,CAAC,EAAE,SAAS,IACtC;AAEC,IAAM,aAAa,CACxB,SACA,WACA,UACA,YAA4B,UACzB;AACH,QAAM,SAAS,UAAa,SAAS,WAAW,QAAQ;AAExD,SAAO;AAAA,IACL,SAAS,cAAc,QAAQ,UAAU,QAAQ,QAAQ;AAAA,IACzD;AAAA,EACF;AACF;","names":[]}