@tspvivek/baasix-sdk 0.1.0-alpha.1

package/dist/modules/items.js

@@ -0,0 +1,651 @@
+// 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
+   * await items.updateMany(['id1', 'id2'], { status: 'archived' });
+   * ```
+   */
+  async updateMany(ids, data) {
+    const response = await this.client.patch(
+      `/items/${this.collection}/bulk`,
+      { ids, data }
+    );
+    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`, {
+      params: { 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, {
+   *   delimiter: ',',
+   *   skipFirstRow: true
+   * });
+   * 
+   * console.log(`Imported ${result.created} items`);
+   * ```
+   */
+  async importCSV(file, options) {
+    const formData = new FormData();
+    if (file instanceof File) {
+      formData.append("file", file);
+    } else {
+      formData.append("file", file);
+    }
+    if (options?.delimiter) {
+      formData.append("delimiter", options.delimiter);
+    }
+    if (options?.skipFirstRow !== void 0) {
+      formData.append("skipFirstRow", String(options.skipFirstRow));
+    }
+    if (options?.dateFormat) {
+      formData.append("dateFormat", options.dateFormat);
+    }
+    if (options?.fieldMapping) {
+      formData.append("fieldMapping", JSON.stringify(options.fieldMapping));
+    }
+    const response = await this.client.post(
+      `/items/${this.collection}/import/csv`,
+      formData
+    );
+    return response.data;
+  }
+  /**
+   * 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.created} items`);
+   * ```
+   */
+  async importJSON(file, options) {
+    const formData = new FormData();
+    if (file instanceof File) {
+      formData.append("file", file);
+    } else {
+      formData.append("file", file);
+    }
+    if (options?.fieldMapping) {
+      formData.append("fieldMapping", JSON.stringify(options.fieldMapping));
+    }
+    const response = await this.client.post(
+      `/items/${this.collection}/import/json`,
+      formData
+    );
+    return response.data;
+  }
+  /**
+   * 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 another)
+   *
+   * @example
+   * ```typescript
+   * // Move item1 before item2
+   * await baasix.items('products').sortItem('item1-uuid', 'item2-uuid');
+   * ```
+   */
+  async sortItem(itemId, beforeItemId) {
+    await this.client.post("/utils/sort", {
+      collection: this.collection,
+      item: itemId,
+      to: beforeItemId
+    });
+  }
+  /**
+   * 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", {
+        collection: this.collection,
+        item: orderedIds[i],
+        to: orderedIds[i - 1]
+      });
+    }
+  }
+};
+
+export { ItemsModule, QueryBuilder };
+//# sourceMappingURL=items.js.map
+//# sourceMappingURL=items.js.map