Lightable Sdk

Query Builder Pattern

Supported chain methods:

• find(), findOne() return a chainable builder
• filter(obj), sort(obj), limit(n), skip(n), select(str|obj), lean()
• Extra for products/categories/stores:
  • thumbnailSize('200x200'), mainImageSize('500x500')
• Extra for products/services/orders/invoices/categories/stores:
  • byStoreId(storeId)

Supported operations (collection):

• find, findOne, count, countDocuments
• findOneAndUpdate, findById, findByIdAndUpdate
• deleteOne, deleteMany, updateOne, updateMany
• save, insertMany, aggregate, distinct, create

Examples

Node/React/Vite/Next:

import LightTable from '@labelflowai/lighttable';

const lightTable = new LightTable({
  baseUrl: 'https://lb01.genielabel.com/sdk/v1/lighttable',
  store: 'YOUR_STORE_ID',
  marketplaceKey: 'MARKETPLACE_KEY'
  token:"USER TOKEN"
});

// Example of a chainable query
const data = await lightTable
  .collection('myCollectionID')
  .find()
  .filter({ status: 'active' })
  .sort({ createdAt: -1 })
  .limit(10)
  .skip(20)
  .select('name age')
  .lean()
  .exec();

console.log(data);

const products = await lightTable
  .products()
  .findOne({ slug: 't-shirt-nike17991579' })
  .limit(2)
  .thumbnailSize('200x200')
  .mainImageSize('500x500')
  .lean(); // chainables: sort, skip, filter, select, lean, etc.

Example result (products):

{
  "images": [
    {
      "thumbnail": "https://example.com/jpg",
      "url": "https://example.com/jpg",
      "original": "https://example.com/jpg"
    }
  ],
  "price": 10000,
  "collections": [
    {
      "_id": "6827857adae4fab1d79f3c51",
      "title": "Fashion"
    }
  ],
  "_id": "6827853bdae4fab1d79f3c26",
  "name": "T-shirt nike",
  "slug": "t-shirt-nike57814059",
  "taxable": true,
  "formaterPrice": "10.000,00 CDF"
}

OTP (authOtp/verifyOtp):

await lightTable.authOtp({ type: 'email', email: '[email protected]' });
// l'utilisateur recoit un code OTP
const result = await lightTable.verifyOtp({ code: '1234', email: '[email protected]' });
console.log(result.token);

Me (profile):

const me = await lightTable.getMe();
const updated = await lightTable.updateMe({
  firstName: 'Jean',
  lastName: 'Dupont'
});

Categories:

const categories = await lightTable
  .categories()
  .find({})
  .byStoreId('STORE_ID')
  .thumbnailSize('200x200')
  .mainImageSize('500x500')
  .lean();

HTML:

<script src="https://unpkg.com/@labelflowai/[email protected]/lighttable.js"></script>
<script>
  const lightTable = new LightTable({
    baseUrl: 'https://lb01.genielabel.com/sdk/v1/lighttable',
    store: 'YOUR_STORE_ID'
  });
  lightTable.getMe().then(console.log);
</script>

Checkout:

const checkout = await lightTable.checkout({
  isInvoice: false,
  no_auth: true,
  items: [{ id: '_id:PRODUCT_ID', quantity: 1 }]
});

Error Handling

• SDK throws Error('HTTP <status>') when response is not OK.
• Error object may contain error.response.status and error.response.data.

When to Use This Skill

• When the user asks how to integrate LightTable in web apps (React/Vite/Next).
• When generating code samples for checkout, products, orders, invoices, or OTP.
• When debugging requests or auth issues in LightTable SDK.