@baasix/sdk 0.1.0

package/dist/modules/items.js

@@ -0,0 +1,637 @@
+// src/modules/items.ts
+var QueryBuilder = class {
+  collection;
+  client;
+  queryParams = {};
+  constructor(collection, client) {
+    this.collection = collection;
+    this.client = client;
+  }
+  /**
+   * Select specific fields to return
+   *
+   * @example
+   * ```typescript
+   * items.select(['id', 'name', 'author.*'])
+   * items.select('*', 'category.name')
+   * ```
+   */
+  select(...fields) {
+    const flatFields = fields.length === 1 && Array.isArray(fields[0]) ? fields[0] : fields;
+    this.queryParams.fields = flatFields;
+    return this;
+  }
+  /**
+   * Alias for select()
+   */
+  fields(...fields) {
+    return this.select(...fields);
+  }
+  /**
+   * Add filter conditions
+   *
+   * @example
+   * ```typescript
+   * // Simple equality
+   * items.filter({ status: { eq: 'active' } })
+   *
+   * // Multiple conditions
+   * items.filter({
+   *   AND: [
+   *     { status: { eq: 'active' } },
+   *     { price: { gte: 100 } }
+   *   ]
+   * })
+   *
+   * // Relation filtering
+   * items.filter({ 'author.name': { like: 'John' } })
+   * ```
+   */
+  filter(filter) {
+    this.queryParams.filter = filter;
+    return this;
+  }
+  /**
+   * Alias for filter()
+   */
+  where(filter) {
+    return this.filter(filter);
+  }
+  /**
+   * Sort results
+   *
+   * @example
+   * ```typescript
+   * // Object notation
+   * items.sort({ createdAt: 'desc', name: 'asc' })
+   *
+   * // Array notation with prefix
+   * items.sort(['-createdAt', 'name'])
+   *
+   * // String shorthand
+   * items.sort('createdAt:desc')
+   * ```
+   */
+  sort(sort) {
+    this.queryParams.sort = sort;
+    return this;
+  }
+  /**
+   * Alias for sort()
+   */
+  orderBy(sort) {
+    return this.sort(sort);
+  }
+  /**
+   * Limit number of results
+   *
+   * @example
+   * ```typescript
+   * items.limit(20)
+   * items.limit(-1) // All results
+   * ```
+   */
+  limit(limit) {
+    this.queryParams.limit = limit;
+    return this;
+  }
+  /**
+   * Set page number (1-indexed)
+   *
+   * @example
+   * ```typescript
+   * items.page(2).limit(20)
+   * ```
+   */
+  page(page) {
+    this.queryParams.page = page;
+    return this;
+  }
+  /**
+   * Skip a number of results
+   *
+   * @example
+   * ```typescript
+   * items.offset(20)
+   * ```
+   */
+  offset(offset) {
+    this.queryParams.offset = offset;
+    return this;
+  }
+  /**
+   * Full-text search
+   *
+   * @example
+   * ```typescript
+   * items.search('keyword', ['title', 'description'])
+   * ```
+   */
+  search(query, fields) {
+    this.queryParams.search = query;
+    if (fields) {
+      this.queryParams.searchFields = fields;
+    }
+    return this;
+  }
+  /**
+   * Include soft-deleted items
+   *
+   * @example
+   * ```typescript
+   * items.withDeleted()
+   * ```
+   */
+  withDeleted() {
+    this.queryParams.paranoid = false;
+    return this;
+  }
+  /**
+   * Filter related items in O2M/M2M relations
+   *
+   * @example
+   * ```typescript
+   * // Only show approved comments
+   * items.relFilter({
+   *   comments: { approved: { eq: true } }
+   * })
+   * ```
+   */
+  relFilter(conditions) {
+    this.queryParams.relConditions = conditions;
+    return this;
+  }
+  /**
+   * Get the built query parameters
+   */
+  getQuery() {
+    return { ...this.queryParams };
+  }
+  /**
+   * Execute the query and return results
+   *
+   * @example
+   * ```typescript
+   * const { data, totalCount } = await items
+   *   .filter({ status: { eq: 'active' } })
+   *   .sort({ createdAt: 'desc' })
+   *   .limit(10)
+   *   .get();
+   * ```
+   */
+  async get() {
+    return this.client.get(`/items/${this.collection}`, {
+      params: this.buildParams()
+    });
+  }
+  /**
+   * Execute the query and return the first result
+   *
+   * @example
+   * ```typescript
+   * const item = await items
+   *   .filter({ slug: { eq: 'my-post' } })
+   *   .first();
+   * ```
+   */
+  async first() {
+    const result = await this.limit(1).get();
+    return result.data[0] || null;
+  }
+  /**
+   * Count matching items
+   *
+   * @example
+   * ```typescript
+   * const count = await items.filter({ status: { eq: 'active' } }).count();
+   * ```
+   */
+  async count() {
+    const result = await this.client.get(
+      `/items/${this.collection}`,
+      {
+        params: {
+          ...this.buildParams(),
+          limit: 0
+        }
+      }
+    );
+    return result.totalCount || 0;
+  }
+  /**
+   * Build query parameters for the request
+   */
+  buildParams() {
+    const params = {};
+    if (this.queryParams.fields) {
+      params.fields = this.queryParams.fields;
+    }
+    if (this.queryParams.filter) {
+      params.filter = this.queryParams.filter;
+    }
+    if (this.queryParams.sort) {
+      params.sort = this.queryParams.sort;
+    }
+    if (this.queryParams.limit !== void 0) {
+      params.limit = this.queryParams.limit;
+    }
+    if (this.queryParams.page !== void 0) {
+      params.page = this.queryParams.page;
+    }
+    if (this.queryParams.offset !== void 0) {
+      params.offset = this.queryParams.offset;
+    }
+    if (this.queryParams.search) {
+      params.search = this.queryParams.search;
+    }
+    if (this.queryParams.searchFields) {
+      params.searchFields = this.queryParams.searchFields;
+    }
+    if (this.queryParams.paranoid !== void 0) {
+      params.paranoid = this.queryParams.paranoid;
+    }
+    if (this.queryParams.relConditions) {
+      params.relConditions = this.queryParams.relConditions;
+    }
+    if (this.queryParams.aggregate) {
+      params.aggregate = this.queryParams.aggregate;
+    }
+    if (this.queryParams.groupBy) {
+      params.groupBy = this.queryParams.groupBy;
+    }
+    return params;
+  }
+};
+var ItemsModule = class {
+  collection;
+  client;
+  constructor(collection, config) {
+    this.collection = collection;
+    this.client = config.client;
+  }
+  /**
+   * Create a query builder for fluent query construction
+   *
+   * @example
+   * ```typescript
+   * const results = await baasix.items('posts')
+   *   .query()
+   *   .select('*', 'author.*')
+   *   .filter({ status: { eq: 'published' } })
+   *   .sort({ createdAt: 'desc' })
+   *   .limit(10)
+   *   .get();
+   * ```
+   */
+  query() {
+    return new QueryBuilder(this.collection, this.client);
+  }
+  /**
+   * Find items with optional query parameters
+   *
+   * @example
+   * ```typescript
+   * // Simple query
+   * const { data } = await items.find();
+   *
+   * // With parameters
+   * const { data, totalCount } = await items.find({
+   *   filter: { status: { eq: 'active' } },
+   *   sort: { createdAt: 'desc' },
+   *   limit: 20,
+   *   page: 1,
+   *   fields: ['id', 'name', 'price']
+   * });
+   * ```
+   */
+  async find(params) {
+    return this.client.get(`/items/${this.collection}`, {
+      params
+    });
+  }
+  /**
+   * Alias for find()
+   */
+  async findMany(params) {
+    return this.find(params);
+  }
+  /**
+   * Find a single item by ID
+   *
+   * @example
+   * ```typescript
+   * const product = await items.findOne('product-uuid');
+   *
+   * // With specific fields
+   * const product = await items.findOne('product-uuid', {
+   *   fields: ['id', 'name', 'category.*']
+   * });
+   * ```
+   */
+  async findOne(id, params) {
+    const response = await this.client.get(
+      `/items/${this.collection}/${id}`,
+      { params }
+    );
+    return response.data;
+  }
+  /**
+   * Alias for findOne()
+   */
+  async get(id, params) {
+    return this.findOne(id, params);
+  }
+  /**
+   * Create a new item
+   *
+   * @example
+   * ```typescript
+   * const id = await items.create({
+   *   name: 'New Product',
+   *   price: 29.99,
+   *   status: 'draft'
+   * });
+   * ```
+   */
+  async create(data) {
+    const response = await this.client.post(
+      `/items/${this.collection}`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Alias for create()
+   */
+  async insert(data) {
+    return this.create(data);
+  }
+  /**
+   * Create multiple items at once
+   *
+   * @example
+   * ```typescript
+   * const ids = await items.createMany([
+   *   { name: 'Product 1', price: 10 },
+   *   { name: 'Product 2', price: 20 }
+   * ]);
+   * ```
+   */
+  async createMany(data) {
+    const response = await this.client.post(
+      `/items/${this.collection}/bulk`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Alias for createMany()
+   */
+  async insertMany(data) {
+    return this.createMany(data);
+  }
+  /**
+   * Update an existing item
+   *
+   * @example
+   * ```typescript
+   * await items.update('product-uuid', {
+   *   price: 24.99,
+   *   status: 'published'
+   * });
+   * ```
+   */
+  async update(id, data) {
+    const response = await this.client.patch(
+      `/items/${this.collection}/${id}`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Update multiple items at once
+   *
+   * @example
+   * ```typescript
+   * // Update by IDs with same data
+   * await items.updateMany(['id1', 'id2'], { status: 'archived' });
+   * ```
+   */
+  async updateMany(ids, data) {
+    const updates = ids.map((id) => ({ id, data }));
+    const response = await this.client.patch(
+      `/items/${this.collection}/bulk`,
+      updates
+    );
+    return response.data;
+  }
+  /**
+   * Upsert an item (create if not exists, update if exists)
+   *
+   * @example
+   * ```typescript
+   * const id = await items.upsert(
+   *   { sku: 'WIDGET-001' },
+   *   { name: 'Widget', price: 29.99, sku: 'WIDGET-001' }
+   * );
+   * ```
+   */
+  async upsert(filter, data) {
+    const existing = await this.find({ filter, limit: 1 });
+    if (existing.data.length > 0) {
+      return this.update(existing.data[0].id, data);
+    }
+    return this.create(data);
+  }
+  /**
+   * Delete an item by ID
+   *
+   * @example
+   * ```typescript
+   * await items.delete('product-uuid');
+   * ```
+   */
+  async delete(id) {
+    await this.client.delete(`/items/${this.collection}/${id}`);
+  }
+  /**
+   * Delete multiple items
+   *
+   * @example
+   * ```typescript
+   * await items.deleteMany(['id1', 'id2', 'id3']);
+   * ```
+   */
+  async deleteMany(ids) {
+    await this.client.delete(`/items/${this.collection}/bulk`, {
+      body: JSON.stringify(ids)
+    });
+  }
+  /**
+   * Soft delete an item (if paranoid mode is enabled)
+   *
+   * @example
+   * ```typescript
+   * await items.softDelete('product-uuid');
+   * ```
+   */
+  async softDelete(id) {
+    await this.update(id, { deletedAt: (/* @__PURE__ */ new Date()).toISOString() });
+  }
+  /**
+   * Restore a soft-deleted item
+   *
+   * @example
+   * ```typescript
+   * await items.restore('product-uuid');
+   * ```
+   */
+  async restore(id) {
+    await this.update(id, { deletedAt: null });
+  }
+  /**
+   * Aggregate data with grouping
+   *
+   * @example
+   * ```typescript
+   * const results = await items.aggregate({
+   *   aggregate: {
+   *     total: { function: 'sum', field: 'amount' },
+   *     count: { function: 'count', field: 'id' },
+   *     avgPrice: { function: 'avg', field: 'price' }
+   *   },
+   *   groupBy: ['category', 'status'],
+   *   filter: { createdAt: { gte: '$NOW-DAYS_30' } }
+   * });
+   * ```
+   */
+  async aggregate(params) {
+    const response = await this.client.get(
+      `/items/${this.collection}`,
+      { params }
+    );
+    return response.data;
+  }
+  // ===================
+  // Import Operations
+  // ===================
+  /**
+   * Import items from a CSV file
+   *
+   * @example
+   * ```typescript
+   * // Browser
+   * const fileInput = document.querySelector('input[type="file"]');
+   * const file = fileInput.files[0];
+   * 
+   * const result = await baasix.items('products').importCSV(file);
+   * 
+   * console.log(`Imported ${result.imported} items`);
+   * ```
+   */
+  async importCSV(file) {
+    const formData = new FormData();
+    if (file instanceof File) {
+      formData.append("csvFile", file);
+    } else {
+      formData.append("csvFile", file);
+    }
+    const response = await this.client.post(
+      `/items/${this.collection}/import-csv`,
+      formData
+    );
+    return response.results;
+  }
+  /**
+   * Import items from a JSON file
+   *
+   * @example
+   * ```typescript
+   * const file = fileInput.files[0]; // JSON file
+   * const result = await baasix.items('products').importJSON(file);
+   * 
+   * console.log(`Imported ${result.imported} items`);
+   * ```
+   */
+  async importJSON(file) {
+    const formData = new FormData();
+    if (file instanceof File) {
+      formData.append("jsonFile", file);
+    } else {
+      formData.append("jsonFile", file);
+    }
+    const response = await this.client.post(
+      `/items/${this.collection}/import-json`,
+      formData
+    );
+    return response.results;
+  }
+  /**
+   * Import items from an array of objects
+   *
+   * @example
+   * ```typescript
+   * const data = [
+   *   { name: 'Product 1', price: 29.99 },
+   *   { name: 'Product 2', price: 39.99 }
+   * ];
+   * 
+   * const result = await baasix.items('products').importData(data);
+   * ```
+   */
+  async importData(data) {
+    const response = await this.client.post(
+      `/items/${this.collection}/bulk`,
+      data
+    );
+    return response;
+  }
+  // ===================
+  // Sort Operations
+  // ===================
+  /**
+   * Sort/reorder items (move item before or after another)
+   *
+   * @example
+   * ```typescript
+   * // Move item1 before item2
+   * await baasix.items('products').sortItem('item1-uuid', 'item2-uuid');
+   * 
+   * // Move item1 after item2
+   * await baasix.items('products').sortItem('item1-uuid', 'item2-uuid', 'after');
+   * ```
+   */
+  async sortItem(itemId, targetItemId, mode = "before") {
+    await this.client.post(`/utils/sort/${this.collection}`, {
+      item: itemId,
+      to: targetItemId,
+      mode
+    });
+  }
+  /**
+   * Reorder multiple items
+   *
+   * @example
+   * ```typescript
+   * // Set explicit order
+   * await baasix.items('products').reorder([
+   *   'item3-uuid',
+   *   'item1-uuid',
+   *   'item2-uuid'
+   * ]);
+   * ```
+   */
+  async reorder(orderedIds) {
+    for (let i = 1; i < orderedIds.length; i++) {
+      await this.client.post(`/utils/sort/${this.collection}`, {
+        item: orderedIds[i],
+        to: orderedIds[i - 1],
+        mode: "after"
+      });
+    }
+  }
+};
+
+export { ItemsModule, QueryBuilder };
+//# sourceMappingURL=items.js.map
+//# sourceMappingURL=items.js.map

package/dist/modules/items.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/items.ts"],"names":[],"mappings":"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","file":"items.js","sourcesContent":["import type { HttpClient } from \"../client\";\nimport type {\n  BaseItem,\n  BulkResponse,\n  DeleteResponse,\n  Filter,\n  MutationResponse,\n  PaginatedResponse,\n  QueryParams,\n  SingleResponse,\n  Sort,\n} from \"../types\";\n\nexport interface ItemsModuleConfig {\n  client: HttpClient;\n}\n\n/**\n * Query builder for constructing type-safe queries\n */\nexport class QueryBuilder<T extends BaseItem = BaseItem> {\n  private collection: string;\n  private client: HttpClient;\n  private queryParams: QueryParams = {};\n\n  constructor(collection: string, client: HttpClient) {\n    this.collection = collection;\n    this.client = client;\n  }\n\n  /**\n   * Select specific fields to return\n   *\n   * @example\n   * ```typescript\n   * items.select(['id', 'name', 'author.*'])\n   * items.select('*', 'category.name')\n   * ```\n   */\n  select(...fields: string[] | [string[]]): this {\n    const flatFields = fields.length === 1 && Array.isArray(fields[0])\n      ? fields[0]\n      : (fields as string[]);\n    this.queryParams.fields = flatFields;\n    return this;\n  }\n\n  /**\n   * Alias for select()\n   */\n  fields(...fields: string[] | [string[]]): this {\n    return this.select(...fields);\n  }\n\n  /**\n   * Add filter conditions\n   *\n   * @example\n   * ```typescript\n   * // Simple equality\n   * items.filter({ status: { eq: 'active' } })\n   *\n   * // Multiple conditions\n   * items.filter({\n   *   AND: [\n   *     { status: { eq: 'active' } },\n   *     { price: { gte: 100 } }\n   *   ]\n   * })\n   *\n   * // Relation filtering\n   * items.filter({ 'author.name': { like: 'John' } })\n   * ```\n   */\n  filter(filter: Filter): this {\n    this.queryParams.filter = filter;\n    return this;\n  }\n\n  /**\n   * Alias for filter()\n   */\n  where(filter: Filter): this {\n    return this.filter(filter);\n  }\n\n  /**\n   * Sort results\n   *\n   * @example\n   * ```typescript\n   * // Object notation\n   * items.sort({ createdAt: 'desc', name: 'asc' })\n   *\n   * // Array notation with prefix\n   * items.sort(['-createdAt', 'name'])\n   *\n   * // String shorthand\n   * items.sort('createdAt:desc')\n   * ```\n   */\n  sort(sort: Sort): this {\n    this.queryParams.sort = sort;\n    return this;\n  }\n\n  /**\n   * Alias for sort()\n   */\n  orderBy(sort: Sort): this {\n    return this.sort(sort);\n  }\n\n  /**\n   * Limit number of results\n   *\n   * @example\n   * ```typescript\n   * items.limit(20)\n   * items.limit(-1) // All results\n   * ```\n   */\n  limit(limit: number): this {\n    this.queryParams.limit = limit;\n    return this;\n  }\n\n  /**\n   * Set page number (1-indexed)\n   *\n   * @example\n   * ```typescript\n   * items.page(2).limit(20)\n   * ```\n   */\n  page(page: number): this {\n    this.queryParams.page = page;\n    return this;\n  }\n\n  /**\n   * Skip a number of results\n   *\n   * @example\n   * ```typescript\n   * items.offset(20)\n   * ```\n   */\n  offset(offset: number): this {\n    this.queryParams.offset = offset;\n    return this;\n  }\n\n  /**\n   * Full-text search\n   *\n   * @example\n   * ```typescript\n   * items.search('keyword', ['title', 'description'])\n   * ```\n   */\n  search(query: string, fields?: string[]): this {\n    this.queryParams.search = query;\n    if (fields) {\n      this.queryParams.searchFields = fields;\n    }\n    return this;\n  }\n\n  /**\n   * Include soft-deleted items\n   *\n   * @example\n   * ```typescript\n   * items.withDeleted()\n   * ```\n   */\n  withDeleted(): this {\n    this.queryParams.paranoid = false;\n    return this;\n  }\n\n  /**\n   * Filter related items in O2M/M2M relations\n   *\n   * @example\n   * ```typescript\n   * // Only show approved comments\n   * items.relFilter({\n   *   comments: { approved: { eq: true } }\n   * })\n   * ```\n   */\n  relFilter(conditions: Record<string, Filter>): this {\n    this.queryParams.relConditions = conditions;\n    return this;\n  }\n\n  /**\n   * Get the built query parameters\n   */\n  getQuery(): QueryParams {\n    return { ...this.queryParams };\n  }\n\n  /**\n   * Execute the query and return results\n   *\n   * @example\n   * ```typescript\n   * const { data, totalCount } = await items\n   *   .filter({ status: { eq: 'active' } })\n   *   .sort({ createdAt: 'desc' })\n   *   .limit(10)\n   *   .get();\n   * ```\n   */\n  async get(): Promise<PaginatedResponse<T>> {\n    return this.client.get<PaginatedResponse<T>>(`/items/${this.collection}`, {\n      params: this.buildParams(),\n    });\n  }\n\n  /**\n   * Execute the query and return the first result\n   *\n   * @example\n   * ```typescript\n   * const item = await items\n   *   .filter({ slug: { eq: 'my-post' } })\n   *   .first();\n   * ```\n   */\n  async first(): Promise<T | null> {\n    const result = await this.limit(1).get();\n    return result.data[0] || null;\n  }\n\n  /**\n   * Count matching items\n   *\n   * @example\n   * ```typescript\n   * const count = await items.filter({ status: { eq: 'active' } }).count();\n   * ```\n   */\n  async count(): Promise<number> {\n    const result = await this.client.get<PaginatedResponse<T>>(\n      `/items/${this.collection}`,\n      {\n        params: {\n          ...this.buildParams(),\n          limit: 0,\n        },\n      }\n    );\n    return result.totalCount || 0;\n  }\n\n  /**\n   * Build query parameters for the request\n   */\n  private buildParams(): Record<string, unknown> {\n    const params: Record<string, unknown> = {};\n\n    if (this.queryParams.fields) {\n      params.fields = this.queryParams.fields;\n    }\n    if (this.queryParams.filter) {\n      params.filter = this.queryParams.filter;\n    }\n    if (this.queryParams.sort) {\n      params.sort = this.queryParams.sort;\n    }\n    if (this.queryParams.limit !== undefined) {\n      params.limit = this.queryParams.limit;\n    }\n    if (this.queryParams.page !== undefined) {\n      params.page = this.queryParams.page;\n    }\n    if (this.queryParams.offset !== undefined) {\n      params.offset = this.queryParams.offset;\n    }\n    if (this.queryParams.search) {\n      params.search = this.queryParams.search;\n    }\n    if (this.queryParams.searchFields) {\n      params.searchFields = this.queryParams.searchFields;\n    }\n    if (this.queryParams.paranoid !== undefined) {\n      params.paranoid = this.queryParams.paranoid;\n    }\n    if (this.queryParams.relConditions) {\n      params.relConditions = this.queryParams.relConditions;\n    }\n    if (this.queryParams.aggregate) {\n      params.aggregate = this.queryParams.aggregate;\n    }\n    if (this.queryParams.groupBy) {\n      params.groupBy = this.queryParams.groupBy;\n    }\n\n    return params;\n  }\n}\n\n/**\n * Items module for CRUD operations on collections.\n *\n * @example\n * ```typescript\n * const items = baasix.items('products');\n *\n * // List items\n * const products = await items.find({ filter: { status: { eq: 'active' } } });\n *\n * // Get single item\n * const product = await items.findOne('product-id');\n *\n * // Create item\n * const newProduct = await items.create({ name: 'Widget', price: 29.99 });\n *\n * // Update item\n * await items.update('product-id', { price: 24.99 });\n *\n * // Delete item\n * await items.delete('product-id');\n * ```\n */\nexport class ItemsModule<T extends BaseItem = BaseItem> {\n  private collection: string;\n  private client: HttpClient;\n\n  constructor(collection: string, config: ItemsModuleConfig) {\n    this.collection = collection;\n    this.client = config.client;\n  }\n\n  /**\n   * Create a query builder for fluent query construction\n   *\n   * @example\n   * ```typescript\n   * const results = await baasix.items('posts')\n   *   .query()\n   *   .select('*', 'author.*')\n   *   .filter({ status: { eq: 'published' } })\n   *   .sort({ createdAt: 'desc' })\n   *   .limit(10)\n   *   .get();\n   * ```\n   */\n  query(): QueryBuilder<T> {\n    return new QueryBuilder<T>(this.collection, this.client);\n  }\n\n  /**\n   * Find items with optional query parameters\n   *\n   * @example\n   * ```typescript\n   * // Simple query\n   * const { data } = await items.find();\n   *\n   * // With parameters\n   * const { data, totalCount } = await items.find({\n   *   filter: { status: { eq: 'active' } },\n   *   sort: { createdAt: 'desc' },\n   *   limit: 20,\n   *   page: 1,\n   *   fields: ['id', 'name', 'price']\n   * });\n   * ```\n   */\n  async find(params?: QueryParams): Promise<PaginatedResponse<T>> {\n    return this.client.get<PaginatedResponse<T>>(`/items/${this.collection}`, {\n      params: params as Record<string, unknown>,\n    });\n  }\n\n  /**\n   * Alias for find()\n   */\n  async findMany(params?: QueryParams): Promise<PaginatedResponse<T>> {\n    return this.find(params);\n  }\n\n  /**\n   * Find a single item by ID\n   *\n   * @example\n   * ```typescript\n   * const product = await items.findOne('product-uuid');\n   *\n   * // With specific fields\n   * const product = await items.findOne('product-uuid', {\n   *   fields: ['id', 'name', 'category.*']\n   * });\n   * ```\n   */\n  async findOne(\n    id: string,\n    params?: Pick<QueryParams, \"fields\">\n  ): Promise<T> {\n    const response = await this.client.get<SingleResponse<T>>(\n      `/items/${this.collection}/${id}`,\n      { params: params as Record<string, unknown> }\n    );\n    return response.data;\n  }\n\n  /**\n   * Alias for findOne()\n   */\n  async get(id: string, params?: Pick<QueryParams, \"fields\">): Promise<T> {\n    return this.findOne(id, params);\n  }\n\n  /**\n   * Create a new item\n   *\n   * @example\n   * ```typescript\n   * const id = await items.create({\n   *   name: 'New Product',\n   *   price: 29.99,\n   *   status: 'draft'\n   * });\n   * ```\n   */\n  async create(data: Partial<T>): Promise<string> {\n    const response = await this.client.post<MutationResponse<string>>(\n      `/items/${this.collection}`,\n      data\n    );\n    return response.data;\n  }\n\n  /**\n   * Alias for create()\n   */\n  async insert(data: Partial<T>): Promise<string> {\n    return this.create(data);\n  }\n\n  /**\n   * Create multiple items at once\n   *\n   * @example\n   * ```typescript\n   * const ids = await items.createMany([\n   *   { name: 'Product 1', price: 10 },\n   *   { name: 'Product 2', price: 20 }\n   * ]);\n   * ```\n   */\n  async createMany(data: Partial<T>[]): Promise<string[]> {\n    const response = await this.client.post<BulkResponse<string[]>>(\n      `/items/${this.collection}/bulk`,\n      data\n    );\n    return response.data;\n  }\n\n  /**\n   * Alias for createMany()\n   */\n  async insertMany(data: Partial<T>[]): Promise<string[]> {\n    return this.createMany(data);\n  }\n\n  /**\n   * Update an existing item\n   *\n   * @example\n   * ```typescript\n   * await items.update('product-uuid', {\n   *   price: 24.99,\n   *   status: 'published'\n   * });\n   * ```\n   */\n  async update(id: string, data: Partial<T>): Promise<string> {\n    const response = await this.client.patch<MutationResponse<string>>(\n      `/items/${this.collection}/${id}`,\n      data\n    );\n    return response.data;\n  }\n\n  /**\n   * Update multiple items at once\n   *\n   * @example\n   * ```typescript\n   * // Update by IDs with same data\n   * await items.updateMany(['id1', 'id2'], { status: 'archived' });\n   * ```\n   */\n  async updateMany(ids: string[], data: Partial<T>): Promise<string[]> {\n    // Transform to array format expected by API: [{id, data}, {id, data}, ...]\n    const updates = ids.map(id => ({ id, data }));\n    const response = await this.client.patch<BulkResponse<string[]>>(\n      `/items/${this.collection}/bulk`,\n      updates\n    );\n    return response.data;\n  }\n\n  /**\n   * Upsert an item (create if not exists, update if exists)\n   *\n   * @example\n   * ```typescript\n   * const id = await items.upsert(\n   *   { sku: 'WIDGET-001' },\n   *   { name: 'Widget', price: 29.99, sku: 'WIDGET-001' }\n   * );\n   * ```\n   */\n  async upsert(\n    filter: Filter,\n    data: Partial<T>\n  ): Promise<string> {\n    // Try to find existing\n    const existing = await this.find({ filter, limit: 1 });\n    if (existing.data.length > 0) {\n      return this.update(existing.data[0].id, data);\n    }\n    return this.create(data);\n  }\n\n  /**\n   * Delete an item by ID\n   *\n   * @example\n   * ```typescript\n   * await items.delete('product-uuid');\n   * ```\n   */\n  async delete(id: string): Promise<void> {\n    await this.client.delete<DeleteResponse>(`/items/${this.collection}/${id}`);\n  }\n\n  /**\n   * Delete multiple items\n   *\n   * @example\n   * ```typescript\n   * await items.deleteMany(['id1', 'id2', 'id3']);\n   * ```\n   */\n  async deleteMany(ids: string[]): Promise<void> {\n    await this.client.delete<DeleteResponse>(`/items/${this.collection}/bulk`, {\n      body: JSON.stringify(ids),\n    });\n  }\n\n  /**\n   * Soft delete an item (if paranoid mode is enabled)\n   *\n   * @example\n   * ```typescript\n   * await items.softDelete('product-uuid');\n   * ```\n   */\n  async softDelete(id: string): Promise<void> {\n    await this.update(id, { deletedAt: new Date().toISOString() } as unknown as Partial<T>);\n  }\n\n  /**\n   * Restore a soft-deleted item\n   *\n   * @example\n   * ```typescript\n   * await items.restore('product-uuid');\n   * ```\n   */\n  async restore(id: string): Promise<void> {\n    await this.update(id, { deletedAt: null } as unknown as Partial<T>);\n  }\n\n  /**\n   * Aggregate data with grouping\n   *\n   * @example\n   * ```typescript\n   * const results = await items.aggregate({\n   *   aggregate: {\n   *     total: { function: 'sum', field: 'amount' },\n   *     count: { function: 'count', field: 'id' },\n   *     avgPrice: { function: 'avg', field: 'price' }\n   *   },\n   *   groupBy: ['category', 'status'],\n   *   filter: { createdAt: { gte: '$NOW-DAYS_30' } }\n   * });\n   * ```\n   */\n  async aggregate(\n    params: Pick<QueryParams, \"aggregate\" | \"groupBy\" | \"filter\">\n  ): Promise<Record<string, unknown>[]> {\n    const response = await this.client.get<PaginatedResponse<Record<string, unknown>>>(\n      `/items/${this.collection}`,\n      { params: params as Record<string, unknown> }\n    );\n    return response.data;\n  }\n\n  // ===================\n  // Import Operations\n  // ===================\n\n  /**\n   * Import items from a CSV file\n   *\n   * @example\n   * ```typescript\n   * // Browser\n   * const fileInput = document.querySelector('input[type=\"file\"]');\n   * const file = fileInput.files[0];\n   * \n   * const result = await baasix.items('products').importCSV(file);\n   * \n   * console.log(`Imported ${result.imported} items`);\n   * ```\n   */\n  async importCSV(\n    file: File | { uri: string; name: string; type: string }\n  ): Promise<ImportResult> {\n    const formData = new FormData();\n    \n    if (file instanceof File) {\n      formData.append(\"csvFile\", file);\n    } else {\n      // React Native style file\n      formData.append(\"csvFile\", file as any);\n    }\n\n    const response = await this.client.post<{ results: ImportResult }>(\n      `/items/${this.collection}/import-csv`,\n      formData\n    );\n    return response.results;\n  }\n\n  /**\n   * Import items from a JSON file\n   *\n   * @example\n   * ```typescript\n   * const file = fileInput.files[0]; // JSON file\n   * const result = await baasix.items('products').importJSON(file);\n   * \n   * console.log(`Imported ${result.imported} items`);\n   * ```\n   */\n  async importJSON(\n    file: File | { uri: string; name: string; type: string }\n  ): Promise<ImportResult> {\n    const formData = new FormData();\n    \n    if (file instanceof File) {\n      formData.append(\"jsonFile\", file);\n    } else {\n      formData.append(\"jsonFile\", file as any);\n    }\n\n    const response = await this.client.post<{ results: ImportResult }>(\n      `/items/${this.collection}/import-json`,\n      formData\n    );\n    return response.results;\n  }\n\n  /**\n   * Import items from an array of objects\n   *\n   * @example\n   * ```typescript\n   * const data = [\n   *   { name: 'Product 1', price: 29.99 },\n   *   { name: 'Product 2', price: 39.99 }\n   * ];\n   * \n   * const result = await baasix.items('products').importData(data);\n   * ```\n   */\n  async importData(data: Partial<T>[]): Promise<BulkResponse> {\n    const response = await this.client.post<BulkResponse>(\n      `/items/${this.collection}/bulk`,\n      data\n    );\n    return response;\n  }\n\n  // ===================\n  // Sort Operations\n  // ===================\n\n  /**\n   * Sort/reorder items (move item before or after another)\n   *\n   * @example\n   * ```typescript\n   * // Move item1 before item2\n   * await baasix.items('products').sortItem('item1-uuid', 'item2-uuid');\n   * \n   * // Move item1 after item2\n   * await baasix.items('products').sortItem('item1-uuid', 'item2-uuid', 'after');\n   * ```\n   */\n  async sortItem(\n    itemId: string,\n    targetItemId: string,\n    mode: \"before\" | \"after\" = \"before\"\n  ): Promise<void> {\n    await this.client.post(`/utils/sort/${this.collection}`, {\n      item: itemId,\n      to: targetItemId,\n      mode,\n    });\n  }\n\n  /**\n   * Reorder multiple items\n   *\n   * @example\n   * ```typescript\n   * // Set explicit order\n   * await baasix.items('products').reorder([\n   *   'item3-uuid',\n   *   'item1-uuid',\n   *   'item2-uuid'\n   * ]);\n   * ```\n   */\n  async reorder(orderedIds: string[]): Promise<void> {\n    // Sort items one by one to achieve the desired order\n    for (let i = 1; i < orderedIds.length; i++) {\n      await this.client.post(`/utils/sort/${this.collection}`, {\n        item: orderedIds[i],\n        to: orderedIds[i - 1],\n        mode: \"after\",\n      });\n    }\n  }\n}\n\nexport interface ImportResult {\n  imported: number;\n  failed: number;\n  errors: Array<{ row: number; data: Record<string, unknown>; error: string }>;\n}\n\n// Re-export types from types.ts\nexport type {\n  BaseItem,\n  BulkResponse,\n  DeleteResponse,\n  Filter,\n  MutationResponse,\n  PaginatedResponse,\n  QueryParams,\n  SingleResponse,\n  Sort,\n};\n"]}