@scarif/scarif-js 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Main entry point for the API SDK
+ * Exports client, types, and convenience functions
+ */
+import { ApiClient } from './client';
+import { ApiClientOptions, ApiResponse, QueryBuilder, TableTypes } from './types';
+export * from './types';
+export * from './constants';
+export { ApiClient } from './client';
+/**
+ * Create a new API client instance
+ * @param options - Configuration options including API key
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from 'stoorplek-data-api';
+ *
+ * const client = createClient({
+ *   apiKey: 'sk_live_your_api_key_here'
+ * });
+ *
+ * const countries = await client
+ *   .from('countries')
+ *   .select('name, iso, cities(id, name, population)');
+ * ```
+ */
+export declare function createClient(options: ApiClientOptions): ApiClient;
+/**
+ * Configure the default client
+ * Call this once at the start of your app
+ *
+ * @example
+ * ```typescript
+ * import { configure } from 'my-api-sdk';
+ *
+ * configure({
+ *   apiKey: process.env.API_KEY
+ * });
+ * ```
+ */
+export declare function configure(options: ApiClientOptions): void;
+/**
+ * Start a chainable query using the default client
+ *
+ * @example
+ * ```typescript
+ * import { from } from 'stoorplek-data-api';
+ *
+ * // Simple query
+ * const countries = await from('countries')
+ *   .select('name, iso');
+ *
+ * // With relations
+ * const countriesWithCities = await from('countries')
+ *   .select('name, iso, cities(id, name, population)');
+ *
+ * // Complex query with filters
+ * const filtered = await from('countries')
+ *   .select('name, iso, cities(id, name), languages(*)')
+ *   .ilike('name', '%united%')
+ *   .order('name', 'asc')
+ *   .limit(10);
+ *
+ * // Get single result
+ * const usa = await from('countries')
+ *   .select('*')
+ *   .eq('iso', 'US')
+ *   .single();
+ * ```
+ */
+export declare function from<T extends keyof TableTypes>(table: T): QueryBuilder<TableTypes[T]>;
+export declare function from<T = any>(table: string): QueryBuilder<T>;
+/**
+ * Check API health using default client
+ */
+export declare function health(): Promise<ApiResponse>;
+/**
+ * Stoorplek from function with type inference
+ * Delegates to the main from() function to avoid duplication
+ */
+declare function stoorplekFrom<T extends keyof TableTypes>(table: T): QueryBuilder<TableTypes[T]>;
+declare function stoorplekFrom<T = any>(table: string): QueryBuilder<T>;
+/**
+ * Default stoorplek object for easy importing
+ *
+ * @example
+ * ```typescript
+ * const { stoorplek } = require('stoorplek-data-api');
+ *
+ * // Configure once (or use MY_API_KEY env var)
+ * stoorplek.configure({ apiKey: 'your-key' });
+ *
+ * // Use in queries
+ * const { data, error } = await stoorplek.from('countries').select('*');
+ * ```
+ */
+export declare const scarif: {
+    from: typeof stoorplekFrom;
+    configure: typeof configure;
+    createClient: typeof createClient;
+    health: typeof health;
+    ApiClient: typeof ApiClient;
+};
+declare const _default: {
+    createClient: typeof createClient;
+    configure: typeof configure;
+    from: typeof from;
+    health: typeof health;
+    ApiClient: typeof ApiClient;
+    scarif: {
+        from: typeof stoorplekFrom;
+        configure: typeof configure;
+        createClient: typeof createClient;
+        health: typeof health;
+        ApiClient: typeof ApiClient;
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIlF,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMrC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEjE;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEzD;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACxF,wBAAgB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAK9D;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAEnD;AAMD;;;GAGG;AACH,iBAAS,aAAa,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1F,iBAAS,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAKhE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM;;;;;;CAMlB,CAAC;;;;;;;;;;;;;;;AAMF,wBAOE"}

package/dist/index.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Main entry point for the API SDK
+ * Exports client, types, and convenience functions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scarif = exports.ApiClient = void 0;
+exports.createClient = createClient;
+exports.configure = configure;
+exports.from = from;
+exports.health = health;
+const client_1 = require("./client");
+const constants_1 = require("./constants");
+// Export all types
+__exportStar(require("./types"), exports);
+__exportStar(require("./constants"), exports);
+var client_2 = require("./client");
+Object.defineProperty(exports, "ApiClient", { enumerable: true, get: function () { return client_2.ApiClient; } });
+// ===========================================
+// CLIENT FACTORY
+// ===========================================
+/**
+ * Create a new API client instance
+ * @param options - Configuration options including API key
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from 'stoorplek-data-api';
+ *
+ * const client = createClient({
+ *   apiKey: 'sk_live_your_api_key_here'
+ * });
+ *
+ * const countries = await client
+ *   .from('countries')
+ *   .select('name, iso, cities(id, name, population)');
+ * ```
+ */
+function createClient(options) {
+    return new client_1.ApiClient(options);
+}
+// ===========================================
+// DEFAULT CLIENT & CONVENIENCE FUNCTIONS
+// ===========================================
+let defaultClient = null;
+/**
+ * Configure the default client
+ * Call this once at the start of your app
+ *
+ * @example
+ * ```typescript
+ * import { configure } from 'my-api-sdk';
+ *
+ * configure({
+ *   apiKey: process.env.API_KEY
+ * });
+ * ```
+ */
+function configure(options) {
+    defaultClient = new client_1.ApiClient(options);
+}
+/**
+ * Get the default client instance
+ * Auto-initializes from MY_API_KEY environment variable if not configured
+ */
+function getDefaultClient() {
+    if (!defaultClient) {
+        const apiKey = process.env[constants_1.API_KEY_ENV_VAR];
+        if (!apiKey) {
+            throw new Error(`No default client configured. Either call configure() or set ${constants_1.API_KEY_ENV_VAR} environment variable`);
+        }
+        defaultClient = new client_1.ApiClient({ apiKey });
+    }
+    return defaultClient;
+}
+function from(table) {
+    return getDefaultClient().from(table);
+}
+/**
+ * Check API health using default client
+ */
+async function health() {
+    return getDefaultClient().health();
+}
+function stoorplekFrom(table) {
+    return from(table);
+}
+/**
+ * Default stoorplek object for easy importing
+ *
+ * @example
+ * ```typescript
+ * const { stoorplek } = require('stoorplek-data-api');
+ *
+ * // Configure once (or use MY_API_KEY env var)
+ * stoorplek.configure({ apiKey: 'your-key' });
+ *
+ * // Use in queries
+ * const { data, error } = await stoorplek.from('countries').select('*');
+ * ```
+ */
+exports.scarif = {
+    from: stoorplekFrom,
+    configure,
+    createClient,
+    health,
+    ApiClient: client_1.ApiClient
+};
+// ===========================================
+// DEFAULT EXPORT
+// ===========================================
+exports.default = {
+    createClient,
+    configure,
+    from,
+    health,
+    ApiClient: client_1.ApiClient,
+    scarif: exports.scarif
+};

package/dist/types/api.d.ts

@@ -0,0 +1,37 @@
+export interface ApiClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export interface ApiResponse<T = any> {
+    data: T;
+    error: {
+        message: string;
+        code?: string;
+        details?: any;
+    } | null;
+    status: number;
+}
+/**
+ * Expected structure of successful API response
+ */
+export interface ApiSuccessResponse<T> {
+    data: T;
+}
+/**
+ * Expected structure of error API response
+ */
+export interface ApiErrorResponse {
+    message?: string;
+    code?: string;
+    details?: any;
+}
+/**
+ * Type guard to check if response has data property
+ */
+export declare function isApiSuccessResponse<T>(response: unknown): response is ApiSuccessResponse<T>;
+/**
+ * Type guard to check if response is an error response
+ */
+export declare function isApiErrorResponse(response: unknown): response is ApiErrorResponse;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,GAAG,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;CAClB;AACD;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,GAAG,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAM5F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,gBAAgB,CAMlF"}

package/dist/types/api.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isApiSuccessResponse = isApiSuccessResponse;
+exports.isApiErrorResponse = isApiErrorResponse;
+/**
+ * Type guard to check if response has data property
+ */
+function isApiSuccessResponse(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        'data' in response);
+}
+/**
+ * Type guard to check if response is an error response
+ */
+function isApiErrorResponse(response) {
+    return (typeof response === 'object' &&
+        response !== null &&
+        ('message' in response || 'code' in response));
+}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Central exports for all types
+ */
+export * from './api';
+export * from './tables';
+export * from './queries';
+export { isApiSuccessResponse, isApiErrorResponse } from './api';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Central exports for all types
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isApiErrorResponse = exports.isApiSuccessResponse = void 0;
+__exportStar(require("./api"), exports);
+__exportStar(require("./tables"), exports);
+__exportStar(require("./queries"), exports);
+// Explicitly re-export functions to ensure they work in CommonJS
+var api_1 = require("./api");
+Object.defineProperty(exports, "isApiSuccessResponse", { enumerable: true, get: function () { return api_1.isApiSuccessResponse; } });
+Object.defineProperty(exports, "isApiErrorResponse", { enumerable: true, get: function () { return api_1.isApiErrorResponse; } });

package/dist/types/queries.d.ts

@@ -0,0 +1,53 @@
+export type OrderDirection = 'asc' | 'desc';
+export interface ParsedRelation {
+    table: string;
+    columns?: string[];
+}
+export interface QueryBuilder<T = any> {
+    select(query: string): this;
+    eq(column: string, value: any): this;
+    neq(column: string, value: any): this;
+    gt(column: string, value: any): this;
+    gte(column: string, value: any): this;
+    lt(column: string, value: any): this;
+    lte(column: string, value: any): this;
+    like(column: string, value: string): this;
+    ilike(column: string, value: string): this;
+    in(column: string, values: any[]): this;
+    notIn(column: string, values: any[]): this;
+    isNull(column: string): this;
+    isNotNull(column: string): this;
+    order(column: string, direction?: OrderDirection): this;
+    limit(count: number): this;
+    offset(count: number): this;
+    range(from: number, to: number): this;
+    single(): this;
+}
+export interface QueryState {
+    select?: {
+        primaryColumns: string[];
+        associatedTables: ParsedRelation[];
+    };
+    filters: {
+        eq?: Record<string, any>;
+        neq?: Record<string, any>;
+        gt?: Record<string, any>;
+        gte?: Record<string, any>;
+        lt?: Record<string, any>;
+        lte?: Record<string, any>;
+        like?: Record<string, any>;
+        ilike?: Record<string, any>;
+        in?: Record<string, string[]>;
+        notIn?: Record<string, string[]>;
+        isNull?: string[];
+        isNotNull?: string[];
+    };
+    order?: Array<{
+        column: string;
+        direction: OrderDirection;
+    }>;
+    limit?: number;
+    offset?: number;
+    single?: boolean;
+}
+//# sourceMappingURL=queries.d.ts.map

package/dist/types/queries.d.ts.map

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

package/dist/types/queries.js

@@ -0,0 +1,5 @@
+"use strict";
+// ===========================================
+// QUERY BUILDER TYPES
+// ===========================================
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/tables.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Database table type definitions
+ * Add your table interfaces here as your schema grows
+ */
+export interface Country {
+    id: number;
+    name: string;
+    iso: string;
+}
+export interface TableTypes {
+    countries: Country;
+}
+//# sourceMappingURL=tables.d.ts.map

package/dist/types/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/types/tables.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACf;AAOD,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,OAAO,CAAC;CAItB"}

package/dist/types/tables.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Database table type definitions
+ * Add your table interfaces here as your schema grows
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/types.d.ts

@@ -0,0 +1,22 @@
+export interface ApiClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    count?: number;
+    error?: string;
+    message?: string;
+}
+export interface ApiError {
+    error: string;
+    message: string;
+    statusCode: number;
+}
+export declare class ApiClientError extends Error {
+    statusCode: number;
+    error: string;
+    constructor(message: string, statusCode: number, error: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAe,SAAQ,KAAK;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAMjE"}

package/dist/types/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClientError = void 0;
+class ApiClientError extends Error {
+    constructor(message, statusCode, error) {
+        super(message);
+        this.name = 'ApiClientError';
+        this.statusCode = statusCode;
+        this.error = error;
+    }
+}
+exports.ApiClientError = ApiClientError;

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+export interface ApiClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    count?: number;
+    error?: string;
+    message?: string;
+}
+export interface ApiError {
+    error: string;
+    message: string;
+    statusCode: number;
+}
+export declare class ApiClientError extends Error {
+    statusCode: number;
+    error: string;
+    constructor(message: string, statusCode: number, error: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAe,SAAQ,KAAK;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAMjE"}

package/dist/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClientError = void 0;
+class ApiClientError extends Error {
+    constructor(message, statusCode, error) {
+        super(message);
+        this.name = 'ApiClientError';
+        this.statusCode = statusCode;
+        this.error = error;
+    }
+}
+exports.ApiClientError = ApiClientError;

package/dist/utils/query-builder.d.ts

@@ -0,0 +1,84 @@
+import { ApiResponse, OrderDirection, QueryBuilder, QueryState } from "../types";
+/**
+ * Chainable query builder implementation
+ */
+export declare class QueryBuilderImpl<T = any> implements QueryBuilder<T> {
+    private table;
+    private executeFn;
+    private state;
+    constructor(table: string, executeFn: (table: string, state: QueryState) => Promise<ApiResponse<T[]>>);
+    /**
+     * Validates that a number is non-negative
+     */
+    private validateNonNegative;
+    /**
+     * Validates that a value is not null or undefined
+     */
+    private validateNotNull;
+    /**
+     * Validates that an array is not empty
+     */
+    private validateNonEmptyArray;
+    /**
+     * Validates column name is a non-empty string
+     */
+    private validateColumnName;
+    select(query: string): this;
+    /**
+     * Helper method to add object-based filters (eq, neq, gt, etc.)
+     */
+    private addObjectFilter;
+    /**
+     * Helper method to add array-based filters (in, notIn)
+     */
+    private addArrayFilter;
+    /**
+     * Helper method to add column list filters (isNull, isNotNull)
+     */
+    private addColumnListFilter;
+    eq(column: string, value: any): this;
+    neq(column: string, value: any): this;
+    gt(column: string, value: any): this;
+    gte(column: string, value: any): this;
+    lt(column: string, value: any): this;
+    lte(column: string, value: any): this;
+    like(column: string, value: string): this;
+    ilike(column: string, value: string): this;
+    in(column: string, values: any[]): this;
+    notIn(column: string, values: any[]): this;
+    isNull(column: string): this;
+    isNotNull(column: string): this;
+    order(column: string, direction?: OrderDirection): this;
+    limit(count: number): this;
+    offset(count: number): this;
+    range(from: number, to: number): this;
+    single(): this;
+    then<TResult1 = ApiResponse<T | T[]>, TResult2 = never>(onfulfilled?: ((value: ApiResponse<T | T[]>) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): Promise<ApiResponse<T | T[]> | TResult>;
+}
+/**
+ * Builds URL query string from QueryState
+ *
+ * Transforms the internal QueryState structure into URL query parameters
+ * following the API's expected format:
+ * - Select columns: `select=col1,col2`
+ * - Relations: `with=table(col1,col2)`
+ * - Filters: `column[filterType]=value`
+ * - Ordering: `order=column.direction`
+ * - Pagination: `limit=N&offset=N`
+ *
+ * @param state - The query state containing all filters, selections, and modifiers
+ * @returns Query string with leading '?' if params exist, empty string otherwise
+ *
+ * @example
+ * ```typescript
+ * const state: QueryState = {
+ *   select: { primaryColumns: ['id', 'name'], associatedTables: [] },
+ *   filters: { eq: { status: 'active' } },
+ *   limit: 10
+ * };
+ * buildQueryString(state); // "?select=id,name&status[eq]=active&limit=10"
+ * ```
+ */
+export declare function buildQueryString(state: QueryState): string;
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/utils/query-builder.d.ts.map

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