hydrousdb 2.0.0 → 2.0.3

package/dist/records/index.d.ts

@@ -1,137 +0,0 @@
-import { a9 as HttpClient, G as GetRecordOptions, V as RequestOptions, v as GetRecordResponse, w as GetSnapshotResponse, S as RecordData, Q as QueryOptions, R as QueryResponse, I as InsertRecordPayload, J as InsertRecordResponse, a4 as UpdateRecordPayload, a5 as UpdateRecordResponse, o as DeleteRecordResponse, T as RecordExistsInfo, m as BatchUpdatePayload, n as BatchUpdateResponse, B as BatchDeletePayload, h as BatchDeleteResponse, i as BatchInsertPayload, j as BatchInsertResponse, z as HydrousRecord } from '../http-DTukpdAU.js';
-export { s as Filter, t as FilterOp, y as HistoryEntry } from '../http-DTukpdAU.js';
-
-/** Options accepted by every records method that needs a bucket */
-interface BucketOptions {
-    /**
-     * The bucket to read from or write to.
-     * Required on all records and analytics calls.
-     *
-     * @example
-     * await db.records.insert({ values: { name: 'Alice' } }, { bucketKey: 'users' });
-     */
-    bucketKey: string;
-}
-declare class RecordsClient {
-    private readonly http;
-    constructor(http: HttpClient);
-    /** Builds the base path for a given bucket: /api/:bucketKey/:securityKey */
-    private path;
-    /**
-     * Fetch a single record by ID.
-     *
-     * @example
-     * const { data } = await db.records.get('rec_abc123', { bucketKey: 'users' });
-     * const { data, history } = await db.records.get('rec_abc123', { bucketKey: 'users', showHistory: true });
-     */
-    get(recordId: string, options: GetRecordOptions & BucketOptions & RequestOptions): Promise<GetRecordResponse>;
-    /**
-     * Fetch a specific historical version (generation) of a record.
-     *
-     * @example
-     * const { data } = await db.records.getSnapshot('rec_abc123', '1700000000000000', { bucketKey: 'users' });
-     */
-    getSnapshot(recordId: string, generation: string, options: BucketOptions & RequestOptions): Promise<GetSnapshotResponse>;
-    /**
-     * Query a collection with optional filters, sorting, and pagination.
-     *
-     * @example
-     * // Simple query
-     * const { data, meta } = await db.records.query({ bucketKey: 'orders', limit: 50 });
-     *
-     * // Filtered query
-     * const { data } = await db.records.query({
-     *   bucketKey: 'orders',
-     *   filters: [{ field: 'status', op: '==', value: 'active' }],
-     *   timeScope: '7d',
-     * });
-     *
-     * // Paginated
-     * let cursor: string | null = null;
-     * do {
-     *   const result = await db.records.query({ bucketKey: 'orders', limit: 100, cursor: cursor ?? undefined });
-     *   cursor = result.meta.nextCursor;
-     * } while (cursor);
-     */
-    query<T extends RecordData = RecordData>(options: QueryOptions & BucketOptions & RequestOptions): Promise<QueryResponse<T>>;
-    /**
-     * Insert a new record into the specified bucket.
-     *
-     * @example
-     * const { data, meta } = await db.records.insert(
-     *   { values: { name: 'Alice', score: 99 }, queryableFields: ['name'] },
-     *   { bucketKey: 'users' }
-     * );
-     */
-    insert(payload: InsertRecordPayload, options: BucketOptions & RequestOptions): Promise<InsertRecordResponse>;
-    /**
-     * Update an existing record.
-     *
-     * @example
-     * await db.records.update(
-     *   { recordId: 'rec_abc123', values: { score: 100 }, track_record_history: true },
-     *   { bucketKey: 'users' }
-     * );
-     */
-    update(payload: UpdateRecordPayload, options: BucketOptions & RequestOptions): Promise<UpdateRecordResponse>;
-    /**
-     * Delete a record permanently.
-     *
-     * @example
-     * await db.records.delete('rec_abc123', { bucketKey: 'users' });
-     */
-    delete(recordId: string, options: BucketOptions & RequestOptions): Promise<DeleteRecordResponse>;
-    /**
-     * Check whether a record exists without fetching its full data.
-     * Returns `null` if the record is not found.
-     *
-     * @example
-     * const info = await db.records.exists('rec_abc123', { bucketKey: 'users' });
-     * if (info?.exists) console.log('found at', info.updatedAt);
-     */
-    exists(recordId: string, options: BucketOptions & RequestOptions): Promise<RecordExistsInfo | null>;
-    /**
-     * Update up to 500 records in a single request.
-     *
-     * @example
-     * await db.records.batchUpdate(
-     *   { updates: [{ recordId: 'rec_1', values: { status: 'archived' } }] },
-     *   { bucketKey: 'orders' }
-     * );
-     */
-    batchUpdate(payload: BatchUpdatePayload, options: BucketOptions & RequestOptions): Promise<BatchUpdateResponse>;
-    /**
-     * Delete up to 500 records in a single request.
-     *
-     * @example
-     * await db.records.batchDelete(
-     *   { recordIds: ['rec_1', 'rec_2'] },
-     *   { bucketKey: 'orders' }
-     * );
-     */
-    batchDelete(payload: BatchDeletePayload, options: BucketOptions & RequestOptions): Promise<BatchDeleteResponse>;
-    /**
-     * Insert up to 500 records in a single request.
-     * Returns HTTP 207 (multi-status) — check `meta.failed` for partial failures.
-     *
-     * @example
-     * const result = await db.records.batchInsert(
-     *   { records: [{ name: 'Alice' }, { name: 'Bob' }], queryableFields: ['name'] },
-     *   { bucketKey: 'users' }
-     * );
-     */
-    batchInsert(payload: BatchInsertPayload, options: BucketOptions & RequestOptions): Promise<BatchInsertResponse>;
-    /**
-     * Fetch ALL records matching a query, automatically following cursors.
-     * Use with care on large collections — prefer `query()` with manual pagination.
-     *
-     * @example
-     * const allRecords = await db.records.queryAll({
-     *   bucketKey: 'orders',
-     *   filters: [{ field: 'type', op: '==', value: 'invoice' }],
-     * });
-     */
-    queryAll<T extends RecordData = RecordData>(options: Omit<QueryOptions, 'cursor'> & BucketOptions & RequestOptions): Promise<(T & HydrousRecord)[]>;
-}
-
-export { BatchDeletePayload, BatchDeleteResponse, BatchInsertPayload, BatchInsertResponse, BatchUpdatePayload, BatchUpdateResponse, type BucketOptions, DeleteRecordResponse, GetRecordOptions, GetRecordResponse, GetSnapshotResponse, HydrousRecord, InsertRecordPayload, InsertRecordResponse, QueryOptions, QueryResponse, RecordData, RecordExistsInfo, RecordsClient, UpdateRecordPayload, UpdateRecordResponse };

package/dist/records/index.js

@@ -1,228 +0,0 @@
-'use strict';
-
-// src/utils/query.ts
-function buildQueryParams(opts) {
-  const params = {};
-  if (opts.timeScope) params["timeScope"] = opts.timeScope;
-  if (opts.year) params["year"] = opts.year;
-  if (opts.sortOrder) params["sortOrder"] = opts.sortOrder;
-  if (opts.limit) params["limit"] = opts.limit;
-  if (opts.cursor) params["cursor"] = opts.cursor;
-  if (opts.fields) params["fields"] = opts.fields;
-  for (const filter of opts.filters ?? []) {
-    const paramKey = filter.op === "==" ? filter.field : `${filter.field}[${filter.op}]`;
-    params[paramKey] = filter.value;
-  }
-  return params;
-}
-function validateFilters(filters) {
-  const VALID_OPS = /* @__PURE__ */ new Set(["==", "!=", ">", "<", ">=", "<=", "contains"]);
-  if (filters.length > 3) {
-    throw new Error("HydrousDB supports a maximum of 3 filters per query.");
-  }
-  for (const f of filters) {
-    if (!VALID_OPS.has(f.op)) {
-      throw new Error(
-        `Invalid filter operator "${f.op}". Valid operators: ${[...VALID_OPS].join(", ")}`
-      );
-    }
-    if (!f.field || typeof f.field !== "string") {
-      throw new Error('Each filter must have a non-empty "field" string.');
-    }
-  }
-}
-
-// src/records/client.ts
-var RecordsClient = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /** Builds the base path for a given bucket: /api/:bucketKey/:securityKey */
-  path(bucketKey) {
-    return `/api/${bucketKey}/${this.http.securityKey}`;
-  }
-  // ── GET — single record ────────────────────────────────────────────────────
-  /**
-   * Fetch a single record by ID.
-   *
-   * @example
-   * const { data } = await db.records.get('rec_abc123', { bucketKey: 'users' });
-   * const { data, history } = await db.records.get('rec_abc123', { bucketKey: 'users', showHistory: true });
-   */
-  async get(recordId, options) {
-    const { bucketKey, showHistory, ...rest } = options;
-    const params = { recordId };
-    if (showHistory) params["showHistory"] = "true";
-    return this.http.get(this.path(bucketKey), params, rest);
-  }
-  // ── GET — historical snapshot ──────────────────────────────────────────────
-  /**
-   * Fetch a specific historical version (generation) of a record.
-   *
-   * @example
-   * const { data } = await db.records.getSnapshot('rec_abc123', '1700000000000000', { bucketKey: 'users' });
-   */
-  async getSnapshot(recordId, generation, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.get(this.path(bucketKey), { recordId, generation }, rest);
-  }
-  // ── GET — collection query ─────────────────────────────────────────────────
-  /**
-   * Query a collection with optional filters, sorting, and pagination.
-   *
-   * @example
-   * // Simple query
-   * const { data, meta } = await db.records.query({ bucketKey: 'orders', limit: 50 });
-   *
-   * // Filtered query
-   * const { data } = await db.records.query({
-   *   bucketKey: 'orders',
-   *   filters: [{ field: 'status', op: '==', value: 'active' }],
-   *   timeScope: '7d',
-   * });
-   *
-   * // Paginated
-   * let cursor: string | null = null;
-   * do {
-   *   const result = await db.records.query({ bucketKey: 'orders', limit: 100, cursor: cursor ?? undefined });
-   *   cursor = result.meta.nextCursor;
-   * } while (cursor);
-   */
-  async query(options) {
-    const { bucketKey, ...rest } = options;
-    if (rest.filters) validateFilters(rest.filters);
-    const params = buildQueryParams(rest);
-    return this.http.get(this.path(bucketKey), params, rest);
-  }
-  // ── POST — insert ──────────────────────────────────────────────────────────
-  /**
-   * Insert a new record into the specified bucket.
-   *
-   * @example
-   * const { data, meta } = await db.records.insert(
-   *   { values: { name: 'Alice', score: 99 }, queryableFields: ['name'] },
-   *   { bucketKey: 'users' }
-   * );
-   */
-  async insert(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(this.path(bucketKey), payload, rest);
-  }
-  // ── PATCH — update ─────────────────────────────────────────────────────────
-  /**
-   * Update an existing record.
-   *
-   * @example
-   * await db.records.update(
-   *   { recordId: 'rec_abc123', values: { score: 100 }, track_record_history: true },
-   *   { bucketKey: 'users' }
-   * );
-   */
-  async update(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.patch(this.path(bucketKey), payload, rest);
-  }
-  // ── DELETE ─────────────────────────────────────────────────────────────────
-  /**
-   * Delete a record permanently.
-   *
-   * @example
-   * await db.records.delete('rec_abc123', { bucketKey: 'users' });
-   */
-  async delete(recordId, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.delete(this.path(bucketKey), { recordId }, rest);
-  }
-  // ── HEAD — existence check ─────────────────────────────────────────────────
-  /**
-   * Check whether a record exists without fetching its full data.
-   * Returns `null` if the record is not found.
-   *
-   * @example
-   * const info = await db.records.exists('rec_abc123', { bucketKey: 'users' });
-   * if (info?.exists) console.log('found at', info.updatedAt);
-   */
-  async exists(recordId, options) {
-    const { bucketKey, ...rest } = options;
-    const res = await this.http.head(this.path(bucketKey), { recordId }, rest);
-    if (res.status === 404) return null;
-    if (!res.ok) return null;
-    return {
-      exists: true,
-      id: res.headers.get("X-Record-Id") ?? recordId,
-      createdAt: res.headers.get("X-Created-At") ?? "",
-      updatedAt: res.headers.get("X-Updated-At") ?? "",
-      sizeBytes: res.headers.get("X-Size-Bytes") ?? ""
-    };
-  }
-  // ── Batch — update ─────────────────────────────────────────────────────────
-  /**
-   * Update up to 500 records in a single request.
-   *
-   * @example
-   * await db.records.batchUpdate(
-   *   { updates: [{ recordId: 'rec_1', values: { status: 'archived' } }] },
-   *   { bucketKey: 'orders' }
-   * );
-   */
-  async batchUpdate(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(`${this.path(bucketKey)}/batch/update`, payload, rest);
-  }
-  // ── Batch — delete ─────────────────────────────────────────────────────────
-  /**
-   * Delete up to 500 records in a single request.
-   *
-   * @example
-   * await db.records.batchDelete(
-   *   { recordIds: ['rec_1', 'rec_2'] },
-   *   { bucketKey: 'orders' }
-   * );
-   */
-  async batchDelete(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(`${this.path(bucketKey)}/batch/delete`, payload, rest);
-  }
-  // ── Batch — insert ─────────────────────────────────────────────────────────
-  /**
-   * Insert up to 500 records in a single request.
-   * Returns HTTP 207 (multi-status) — check `meta.failed` for partial failures.
-   *
-   * @example
-   * const result = await db.records.batchInsert(
-   *   { records: [{ name: 'Alice' }, { name: 'Bob' }], queryableFields: ['name'] },
-   *   { bucketKey: 'users' }
-   * );
-   */
-  async batchInsert(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(`${this.path(bucketKey)}/batch/insert`, payload, rest);
-  }
-  // ── Helpers ────────────────────────────────────────────────────────────────
-  /**
-   * Fetch ALL records matching a query, automatically following cursors.
-   * Use with care on large collections — prefer `query()` with manual pagination.
-   *
-   * @example
-   * const allRecords = await db.records.queryAll({
-   *   bucketKey: 'orders',
-   *   filters: [{ field: 'type', op: '==', value: 'invoice' }],
-   * });
-   */
-  async queryAll(options) {
-    const all = [];
-    let cursor = null;
-    do {
-      const result = await this.query(
-        cursor ? { ...options, cursor } : { ...options }
-      );
-      all.push(...result.data);
-      cursor = result.meta.nextCursor ?? null;
-    } while (cursor);
-    return all;
-  }
-};
-
-exports.RecordsClient = RecordsClient;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/records/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/query.ts","../../src/records/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Filter, QueryOptions } from '../types/index.js';\n\n/**\n * Converts a QueryOptions object into a flat Record suitable for URLSearchParams.\n *\n * Filter fields use the `field[op]=value` convention:\n *   { field: 'status', op: '==', value: 'active' }  → status=active\n *   { field: 'score',  op: '>',  value: 50 }         → score[>]=50\n */\nexport function buildQueryParams(\n  opts: QueryOptions\n): Record<string, string | number | boolean> {\n  const params: Record<string, string | number | boolean> = {};\n\n  if (opts.timeScope)  params['timeScope']  = opts.timeScope;\n  if (opts.year)       params['year']       = opts.year;\n  if (opts.sortOrder)  params['sortOrder']  = opts.sortOrder;\n  if (opts.limit)      params['limit']      = opts.limit;\n  if (opts.cursor)     params['cursor']     = opts.cursor;\n  if (opts.fields)     params['fields']     = opts.fields;\n\n  for (const filter of opts.filters ?? []) {\n    const paramKey = filter.op === '==' ? filter.field : `${filter.field}[${filter.op}]`;\n    params[paramKey] = filter.value as string | number | boolean;\n  }\n\n  return params;\n}\n\n/**\n * Validates a filter array and throws a descriptive error if invalid.\n */\nexport function validateFilters(filters: Filter[]): void {\n  const VALID_OPS = new Set(['==', '!=', '>', '<', '>=', '<=', 'contains']);\n\n  if (filters.length > 3) {\n    throw new Error('HydrousDB supports a maximum of 3 filters per query.');\n  }\n\n  for (const f of filters) {\n    if (!VALID_OPS.has(f.op)) {\n      throw new Error(\n        `Invalid filter operator \"${f.op}\". Valid operators: ${[...VALID_OPS].join(', ')}`\n      );\n    }\n    if (!f.field || typeof f.field !== 'string') {\n      throw new Error('Each filter must have a non-empty \"field\" string.');\n    }\n  }\n}\n","import type { HttpClient } from '../utils/http.js';\nimport { buildQueryParams, validateFilters } from '../utils/query.js';\nimport type {\n  GetRecordOptions,\n  GetRecordResponse,\n  GetSnapshotResponse,\n  QueryOptions,\n  QueryResponse,\n  InsertRecordPayload,\n  InsertRecordResponse,\n  UpdateRecordPayload,\n  UpdateRecordResponse,\n  DeleteRecordResponse,\n  RecordExistsInfo,\n  BatchUpdatePayload,\n  BatchUpdateResponse,\n  BatchDeletePayload,\n  BatchDeleteResponse,\n  BatchInsertPayload,\n  BatchInsertResponse,\n  RecordData,\n  HydrousRecord,\n  RequestOptions,\n} from '../types/index.js';\n\n/** Options accepted by every records method that needs a bucket */\nexport interface BucketOptions {\n  /**\n   * The bucket to read from or write to.\n   * Required on all records and analytics calls.\n   *\n   * @example\n   * await db.records.insert({ values: { name: 'Alice' } }, { bucketKey: 'users' });\n   */\n  bucketKey: string;\n}\n\nexport class RecordsClient {\n  constructor(private readonly http: HttpClient) {}\n\n  /** Builds the base path for a given bucket: /api/:bucketKey/:securityKey */\n  private path(bucketKey: string): string {\n    return `/api/${bucketKey}/${this.http.securityKey}`;\n  }\n\n  // ── GET — single record ────────────────────────────────────────────────────\n\n  /**\n   * Fetch a single record by ID.\n   *\n   * @example\n   * const { data } = await db.records.get('rec_abc123', { bucketKey: 'users' });\n   * const { data, history } = await db.records.get('rec_abc123', { bucketKey: 'users', showHistory: true });\n   */\n  async get(\n    recordId: string,\n    options: GetRecordOptions & BucketOptions & RequestOptions\n  ): Promise<GetRecordResponse> {\n    const { bucketKey, showHistory, ...rest } = options;\n    const params: Record<string, string | number | boolean | undefined | null> = { recordId };\n    if (showHistory) params['showHistory'] = 'true';\n    return this.http.get<GetRecordResponse>(this.path(bucketKey), params, rest);\n  }\n\n  // ── GET — historical snapshot ──────────────────────────────────────────────\n\n  /**\n   * Fetch a specific historical version (generation) of a record.\n   *\n   * @example\n   * const { data } = await db.records.getSnapshot('rec_abc123', '1700000000000000', { bucketKey: 'users' });\n   */\n  async getSnapshot(\n    recordId: string,\n    generation: string,\n    options: BucketOptions & RequestOptions\n  ): Promise<GetSnapshotResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.get<GetSnapshotResponse>(this.path(bucketKey), { recordId, generation }, rest);\n  }\n\n  // ── GET — collection query ─────────────────────────────────────────────────\n\n  /**\n   * Query a collection with optional filters, sorting, and pagination.\n   *\n   * @example\n   * // Simple query\n   * const { data, meta } = await db.records.query({ bucketKey: 'orders', limit: 50 });\n   *\n   * // Filtered query\n   * const { data } = await db.records.query({\n   *   bucketKey: 'orders',\n   *   filters: [{ field: 'status', op: '==', value: 'active' }],\n   *   timeScope: '7d',\n   * });\n   *\n   * // Paginated\n   * let cursor: string | null = null;\n   * do {\n   *   const result = await db.records.query({ bucketKey: 'orders', limit: 100, cursor: cursor ?? undefined });\n   *   cursor = result.meta.nextCursor;\n   * } while (cursor);\n   */\n  async query<T extends RecordData = RecordData>(\n    options: QueryOptions & BucketOptions & RequestOptions\n  ): Promise<QueryResponse<T>> {\n    const { bucketKey, ...rest } = options;\n    if (rest.filters) validateFilters(rest.filters);\n    const params = buildQueryParams(rest);\n    return this.http.get<QueryResponse<T>>(this.path(bucketKey), params, rest);\n  }\n\n  // ── POST — insert ──────────────────────────────────────────────────────────\n\n  /**\n   * Insert a new record into the specified bucket.\n   *\n   * @example\n   * const { data, meta } = await db.records.insert(\n   *   { values: { name: 'Alice', score: 99 }, queryableFields: ['name'] },\n   *   { bucketKey: 'users' }\n   * );\n   */\n  async insert(\n    payload: InsertRecordPayload,\n    options: BucketOptions & RequestOptions\n  ): Promise<InsertRecordResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.post<InsertRecordResponse>(this.path(bucketKey), payload, rest);\n  }\n\n  // ── PATCH — update ─────────────────────────────────────────────────────────\n\n  /**\n   * Update an existing record.\n   *\n   * @example\n   * await db.records.update(\n   *   { recordId: 'rec_abc123', values: { score: 100 }, track_record_history: true },\n   *   { bucketKey: 'users' }\n   * );\n   */\n  async update(\n    payload: UpdateRecordPayload,\n    options: BucketOptions & RequestOptions\n  ): Promise<UpdateRecordResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.patch<UpdateRecordResponse>(this.path(bucketKey), payload, rest);\n  }\n\n  // ── DELETE ─────────────────────────────────────────────────────────────────\n\n  /**\n   * Delete a record permanently.\n   *\n   * @example\n   * await db.records.delete('rec_abc123', { bucketKey: 'users' });\n   */\n  async delete(\n    recordId: string,\n    options: BucketOptions & RequestOptions\n  ): Promise<DeleteRecordResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.delete<DeleteRecordResponse>(this.path(bucketKey), { recordId }, rest);\n  }\n\n  // ── HEAD — existence check ─────────────────────────────────────────────────\n\n  /**\n   * Check whether a record exists without fetching its full data.\n   * Returns `null` if the record is not found.\n   *\n   * @example\n   * const info = await db.records.exists('rec_abc123', { bucketKey: 'users' });\n   * if (info?.exists) console.log('found at', info.updatedAt);\n   */\n  async exists(\n    recordId: string,\n    options: BucketOptions & RequestOptions\n  ): Promise<RecordExistsInfo | null> {\n    const { bucketKey, ...rest } = options;\n    const res = await this.http.head(this.path(bucketKey), { recordId }, rest);\n\n    if (res.status === 404) return null;\n    if (!res.ok) return null;\n\n    return {\n      exists:    true,\n      id:        res.headers.get('X-Record-Id')    ?? recordId,\n      createdAt: res.headers.get('X-Created-At')   ?? '',\n      updatedAt: res.headers.get('X-Updated-At')   ?? '',\n      sizeBytes: res.headers.get('X-Size-Bytes')   ?? '',\n    };\n  }\n\n  // ── Batch — update ─────────────────────────────────────────────────────────\n\n  /**\n   * Update up to 500 records in a single request.\n   *\n   * @example\n   * await db.records.batchUpdate(\n   *   { updates: [{ recordId: 'rec_1', values: { status: 'archived' } }] },\n   *   { bucketKey: 'orders' }\n   * );\n   */\n  async batchUpdate(\n    payload: BatchUpdatePayload,\n    options: BucketOptions & RequestOptions\n  ): Promise<BatchUpdateResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.post<BatchUpdateResponse>(`${this.path(bucketKey)}/batch/update`, payload, rest);\n  }\n\n  // ── Batch — delete ─────────────────────────────────────────────────────────\n\n  /**\n   * Delete up to 500 records in a single request.\n   *\n   * @example\n   * await db.records.batchDelete(\n   *   { recordIds: ['rec_1', 'rec_2'] },\n   *   { bucketKey: 'orders' }\n   * );\n   */\n  async batchDelete(\n    payload: BatchDeletePayload,\n    options: BucketOptions & RequestOptions\n  ): Promise<BatchDeleteResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.post<BatchDeleteResponse>(`${this.path(bucketKey)}/batch/delete`, payload, rest);\n  }\n\n  // ── Batch — insert ─────────────────────────────────────────────────────────\n\n  /**\n   * Insert up to 500 records in a single request.\n   * Returns HTTP 207 (multi-status) — check `meta.failed` for partial failures.\n   *\n   * @example\n   * const result = await db.records.batchInsert(\n   *   { records: [{ name: 'Alice' }, { name: 'Bob' }], queryableFields: ['name'] },\n   *   { bucketKey: 'users' }\n   * );\n   */\n  async batchInsert(\n    payload: BatchInsertPayload,\n    options: BucketOptions & RequestOptions\n  ): Promise<BatchInsertResponse> {\n    const { bucketKey, ...rest } = options;\n    return this.http.post<BatchInsertResponse>(`${this.path(bucketKey)}/batch/insert`, payload, rest);\n  }\n\n  // ── Helpers ────────────────────────────────────────────────────────────────\n\n  /**\n   * Fetch ALL records matching a query, automatically following cursors.\n   * Use with care on large collections — prefer `query()` with manual pagination.\n   *\n   * @example\n   * const allRecords = await db.records.queryAll({\n   *   bucketKey: 'orders',\n   *   filters: [{ field: 'type', op: '==', value: 'invoice' }],\n   * });\n   */\n  async queryAll<T extends RecordData = RecordData>(\n    options: Omit<QueryOptions, 'cursor'> & BucketOptions & RequestOptions\n  ): Promise<(T & HydrousRecord)[]> {\n    const all: (T & HydrousRecord)[] = [];\n    let cursor: string | null = null;\n\n    do {\n      const result: any = await this.query<T>(\n        cursor ? { ...options, cursor } : { ...options }\n      );\n      all.push(...result.data);\n      cursor = result.meta.nextCursor ?? null;\n    } while (cursor);\n\n    return all;\n  }\n}\n"]}

package/dist/records/index.mjs

@@ -1,226 +0,0 @@
-// src/utils/query.ts
-function buildQueryParams(opts) {
-  const params = {};
-  if (opts.timeScope) params["timeScope"] = opts.timeScope;
-  if (opts.year) params["year"] = opts.year;
-  if (opts.sortOrder) params["sortOrder"] = opts.sortOrder;
-  if (opts.limit) params["limit"] = opts.limit;
-  if (opts.cursor) params["cursor"] = opts.cursor;
-  if (opts.fields) params["fields"] = opts.fields;
-  for (const filter of opts.filters ?? []) {
-    const paramKey = filter.op === "==" ? filter.field : `${filter.field}[${filter.op}]`;
-    params[paramKey] = filter.value;
-  }
-  return params;
-}
-function validateFilters(filters) {
-  const VALID_OPS = /* @__PURE__ */ new Set(["==", "!=", ">", "<", ">=", "<=", "contains"]);
-  if (filters.length > 3) {
-    throw new Error("HydrousDB supports a maximum of 3 filters per query.");
-  }
-  for (const f of filters) {
-    if (!VALID_OPS.has(f.op)) {
-      throw new Error(
-        `Invalid filter operator "${f.op}". Valid operators: ${[...VALID_OPS].join(", ")}`
-      );
-    }
-    if (!f.field || typeof f.field !== "string") {
-      throw new Error('Each filter must have a non-empty "field" string.');
-    }
-  }
-}
-
-// src/records/client.ts
-var RecordsClient = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /** Builds the base path for a given bucket: /api/:bucketKey/:securityKey */
-  path(bucketKey) {
-    return `/api/${bucketKey}/${this.http.securityKey}`;
-  }
-  // ── GET — single record ────────────────────────────────────────────────────
-  /**
-   * Fetch a single record by ID.
-   *
-   * @example
-   * const { data } = await db.records.get('rec_abc123', { bucketKey: 'users' });
-   * const { data, history } = await db.records.get('rec_abc123', { bucketKey: 'users', showHistory: true });
-   */
-  async get(recordId, options) {
-    const { bucketKey, showHistory, ...rest } = options;
-    const params = { recordId };
-    if (showHistory) params["showHistory"] = "true";
-    return this.http.get(this.path(bucketKey), params, rest);
-  }
-  // ── GET — historical snapshot ──────────────────────────────────────────────
-  /**
-   * Fetch a specific historical version (generation) of a record.
-   *
-   * @example
-   * const { data } = await db.records.getSnapshot('rec_abc123', '1700000000000000', { bucketKey: 'users' });
-   */
-  async getSnapshot(recordId, generation, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.get(this.path(bucketKey), { recordId, generation }, rest);
-  }
-  // ── GET — collection query ─────────────────────────────────────────────────
-  /**
-   * Query a collection with optional filters, sorting, and pagination.
-   *
-   * @example
-   * // Simple query
-   * const { data, meta } = await db.records.query({ bucketKey: 'orders', limit: 50 });
-   *
-   * // Filtered query
-   * const { data } = await db.records.query({
-   *   bucketKey: 'orders',
-   *   filters: [{ field: 'status', op: '==', value: 'active' }],
-   *   timeScope: '7d',
-   * });
-   *
-   * // Paginated
-   * let cursor: string | null = null;
-   * do {
-   *   const result = await db.records.query({ bucketKey: 'orders', limit: 100, cursor: cursor ?? undefined });
-   *   cursor = result.meta.nextCursor;
-   * } while (cursor);
-   */
-  async query(options) {
-    const { bucketKey, ...rest } = options;
-    if (rest.filters) validateFilters(rest.filters);
-    const params = buildQueryParams(rest);
-    return this.http.get(this.path(bucketKey), params, rest);
-  }
-  // ── POST — insert ──────────────────────────────────────────────────────────
-  /**
-   * Insert a new record into the specified bucket.
-   *
-   * @example
-   * const { data, meta } = await db.records.insert(
-   *   { values: { name: 'Alice', score: 99 }, queryableFields: ['name'] },
-   *   { bucketKey: 'users' }
-   * );
-   */
-  async insert(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(this.path(bucketKey), payload, rest);
-  }
-  // ── PATCH — update ─────────────────────────────────────────────────────────
-  /**
-   * Update an existing record.
-   *
-   * @example
-   * await db.records.update(
-   *   { recordId: 'rec_abc123', values: { score: 100 }, track_record_history: true },
-   *   { bucketKey: 'users' }
-   * );
-   */
-  async update(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.patch(this.path(bucketKey), payload, rest);
-  }
-  // ── DELETE ─────────────────────────────────────────────────────────────────
-  /**
-   * Delete a record permanently.
-   *
-   * @example
-   * await db.records.delete('rec_abc123', { bucketKey: 'users' });
-   */
-  async delete(recordId, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.delete(this.path(bucketKey), { recordId }, rest);
-  }
-  // ── HEAD — existence check ─────────────────────────────────────────────────
-  /**
-   * Check whether a record exists without fetching its full data.
-   * Returns `null` if the record is not found.
-   *
-   * @example
-   * const info = await db.records.exists('rec_abc123', { bucketKey: 'users' });
-   * if (info?.exists) console.log('found at', info.updatedAt);
-   */
-  async exists(recordId, options) {
-    const { bucketKey, ...rest } = options;
-    const res = await this.http.head(this.path(bucketKey), { recordId }, rest);
-    if (res.status === 404) return null;
-    if (!res.ok) return null;
-    return {
-      exists: true,
-      id: res.headers.get("X-Record-Id") ?? recordId,
-      createdAt: res.headers.get("X-Created-At") ?? "",
-      updatedAt: res.headers.get("X-Updated-At") ?? "",
-      sizeBytes: res.headers.get("X-Size-Bytes") ?? ""
-    };
-  }
-  // ── Batch — update ─────────────────────────────────────────────────────────
-  /**
-   * Update up to 500 records in a single request.
-   *
-   * @example
-   * await db.records.batchUpdate(
-   *   { updates: [{ recordId: 'rec_1', values: { status: 'archived' } }] },
-   *   { bucketKey: 'orders' }
-   * );
-   */
-  async batchUpdate(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(`${this.path(bucketKey)}/batch/update`, payload, rest);
-  }
-  // ── Batch — delete ─────────────────────────────────────────────────────────
-  /**
-   * Delete up to 500 records in a single request.
-   *
-   * @example
-   * await db.records.batchDelete(
-   *   { recordIds: ['rec_1', 'rec_2'] },
-   *   { bucketKey: 'orders' }
-   * );
-   */
-  async batchDelete(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(`${this.path(bucketKey)}/batch/delete`, payload, rest);
-  }
-  // ── Batch — insert ─────────────────────────────────────────────────────────
-  /**
-   * Insert up to 500 records in a single request.
-   * Returns HTTP 207 (multi-status) — check `meta.failed` for partial failures.
-   *
-   * @example
-   * const result = await db.records.batchInsert(
-   *   { records: [{ name: 'Alice' }, { name: 'Bob' }], queryableFields: ['name'] },
-   *   { bucketKey: 'users' }
-   * );
-   */
-  async batchInsert(payload, options) {
-    const { bucketKey, ...rest } = options;
-    return this.http.post(`${this.path(bucketKey)}/batch/insert`, payload, rest);
-  }
-  // ── Helpers ────────────────────────────────────────────────────────────────
-  /**
-   * Fetch ALL records matching a query, automatically following cursors.
-   * Use with care on large collections — prefer `query()` with manual pagination.
-   *
-   * @example
-   * const allRecords = await db.records.queryAll({
-   *   bucketKey: 'orders',
-   *   filters: [{ field: 'type', op: '==', value: 'invoice' }],
-   * });
-   */
-  async queryAll(options) {
-    const all = [];
-    let cursor = null;
-    do {
-      const result = await this.query(
-        cursor ? { ...options, cursor } : { ...options }
-      );
-      all.push(...result.data);
-      cursor = result.meta.nextCursor ?? null;
-    } while (cursor);
-    return all;
-  }
-};
-
-export { RecordsClient };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map