@temboplus/afloat 0.1.73 → 0.1.75-0

package/dist/lib/api/common-schemas.d.ts

@@ -0,0 +1,49 @@
+import z from "zod";
+declare const paginationSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    limit: z.ZodNumber;
+    total: z.ZodNumber;
+    totalPages: z.ZodNumber;
+    hasNext: z.ZodBoolean;
+    hasPrev: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}, {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}>;
+export declare const CommonSchemas: {
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+        hasNext: z.ZodBoolean;
+        hasPrev: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    }, {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    }>;
+};
+export type PaginationDTO = z.infer<typeof paginationSchema>;
+export {};

package/dist/lib/api/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./common-responses.js";
+export * from "./common-schemas.js";
 export * from "./base-repository.js";

package/dist/lib/query/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./query.builder.js";
+export * from "./query.types.js";

package/dist/lib/query/query.builder.d.ts

@@ -0,0 +1,71 @@
+import { FilterCriteria, QueryOptions, SortCriteria, SortDirection } from "./query.types.js";
+export declare const QUERY_BUILDER_TYPE: unique symbol;
+export declare class QueryBuilder {
+    readonly options: QueryOptions;
+    constructor(options?: QueryOptions);
+    /**
+     * Type tag to identify QueryBuilder instances
+     */
+    [QUERY_BUILDER_TYPE]: string;
+    /**
+     * Safely check if an object is a QueryBuilder instance
+     */
+    static is(obj: any): obj is QueryBuilder;
+    addFilter(criteria: FilterCriteria): this;
+    where(field: string, value: any): this;
+    whereNot(field: string, value: any): this;
+    whereLike(field: string, value: string): this;
+    whereLikeLower(field: string, value: string): this;
+    whereContains(field: string, value: string): this;
+    whereStartsWith(field: string, value: string): this;
+    whereEndsWith(field: string, value: string): this;
+    whereIn(field: string, values: any[]): this;
+    whereNull(field: string): this;
+    whereNotNull(field: string): this;
+    whereGreaterThan(field: string, value: any): this;
+    whereGreaterThanOrEqual(field: string, value: any): this;
+    whereLessThan(field: string, value: any): this;
+    whereLessThanOrEqual(field: string, value: any): this;
+    whereBetween(field: string, min: any, max: any): this;
+    whereDateBetween(startDate?: string | null, endDate?: string | null): this;
+    addSort(criteria: SortCriteria): this;
+    orderBy(field: string, direction?: SortDirection): this;
+    orderByAsc(field: string): this;
+    orderByDesc(field: string): this;
+    paginate(page: number, limit: number): this;
+    /**
+     * Add eager loading for related models
+     * @param relations Relation name or array of relation names
+     */
+    with(relations: string | string[]): this;
+    /**
+     * Add a JOIN to the query to fetch related models
+     * @param relations Relation name or array of relation names to join
+     */
+    join(relations: string | string[]): this;
+    /**
+     * Add GROUP BY clause to the query
+     * @param fields Field or fields to group by
+     */
+    groupBy(fields: string | string[]): this;
+    /**
+     * Enable count mode for the query
+     * @param expression Optional count expression (defaults to '*')
+     */
+    count(expression?: string): this;
+    /**
+     * Count specific expression with alias
+     * @param expression Expression to count
+     * @param alias Alias for the count result
+     */
+    countAs(expression: string, alias: string): this;
+    /**
+     * @returns an objection-find query
+     */
+    build(): Record<string, any>;
+    /**
+     * Create a clone of this query builder
+     */
+    clone(): this;
+    static create<T extends QueryOptions>(options?: T): QueryBuilder;
+}

package/dist/lib/query/query.types.d.ts

@@ -0,0 +1,36 @@
+export declare enum FilterOperator {
+    EQUALS = "eq",
+    NOT_EQUALS = "neq",
+    LESS_THAN = "lt",
+    LESS_THAN_OR_EQUAL = "lte",
+    GREATER_THAN = "gt",
+    GREATER_THAN_OR_EQUAL = "gte",
+    LIKE = "like",
+    LIKE_LOWER = "likeLower",
+    IS_NULL = "isNull",
+    IS_NOT_NULL = "isNotNull",
+    IN = "in"
+}
+export declare enum SortDirection {
+    ASC = "asc",
+    DESC = "desc"
+}
+export interface FilterCriteria {
+    field: string;
+    operator: FilterOperator;
+    value?: any;
+}
+export interface SortCriteria {
+    field: string;
+    direction: SortDirection;
+}
+export interface QueryOptions {
+    page?: number;
+    limit?: number;
+    filters?: FilterCriteria[];
+    sort?: SortCriteria[];
+    includes?: string[];
+    join?: string[];
+    groupBy?: string[];
+    count?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.1.73",
+  "version": "0.1.75-0",
   "description": "A foundational library for Temboplus-Afloat projects.",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",

package/dist/lib/api/common-responses.d.ts

@@ -1,12 +0,0 @@
-import type { AppRouteResponse } from "@ts-rest/core";
-import { z } from "zod";
-type ApiErrorResponseSchemaType = z.ZodObject<{
-    statusCode: z.ZodNumber;
-    message: z.ZodString;
-    error: z.ZodString;
-    details: z.ZodOptional<z.ZodRecord>;
-}>;
-export declare const common400ResponseSchema: ApiErrorResponseSchemaType;
-export type Common400APIResponse = z.infer<typeof common400ResponseSchema>;
-export declare const commonAPIResponses: Record<number, AppRouteResponse>;
-export {};