Write offers and codes

import { addOfferCodes } from '@tassyir/app';

const influencers = ['SARA10', 'OMAR10', 'LINA10'];

// 1. A draft: 10% off everything, only with a code, until the end of the year.
const { data: offer } = await admin.post('/offers', {
  body: {
    storeId: '741000000000000100',
    kind: 'product_discount',
    method: 'code',
    title: 'Autumn influencers',
    label: { ar: 'خصم المؤثرين' },
    config: { valueType: 'percent', value: 10 },
    targets: [{ refType: 'all' }],
    perBuyerLimit: 1,
    endsAt: '2026-12-31',
  },
});

// 2. One code each. 250 per call is the API's limit: addOfferCodes cuts the
// list into calls of 250 and gathers the answers in the order you sent.
const added = await addOfferCodes(
  admin,
  offer.id,
  influencers.map((code) => ({ code, usageLimit: 50 })),
);

// The call is partial by design: a code that cannot be created is reported on
// its own entry and the others are created.
const refused = added.results.filter((entry) => entry.outcome !== 'created');
for (const entry of refused) console.warn(entry.code, entry.outcome);

// 3. Put it live (at least one enabled code is required for a code offer).
await admin.post('/offers/{id}/publish', { path: { id: offer.id } });

{
  "id": "741000000000000300",
  "code": "SARA10",
  "usageLimit": 50,
  "uses": 12,
  "disabled": false,
  "disabledAt": null,
  "createdAt": "2026-10-02T10:00:00.000Z"
}

{ "id": "741000000000002000", "deleted": false, "archived": true }

const { data: changed } = await admin.patch('/offers/{id}', {
  path: { id: '741000000000002000' },
  body: { endsAt: '2027-01-15', totalUsageLimit: 1000 },
});
console.log(changed.status, changed.endsAt);

// How many orders each code brought, counting the uses that stand.
const perCode = new Map<string, number>();
for await (const redemption of admin.paginate('/offers/{id}/redemptions', {
  path: { id: '741000000000002000' },
})) {
  if (redemption.state === 'released') continue;
  const code = redemption.code ?? 'automatic';
  perCode.set(code, (perCode.get(code) ?? 0) + 1);
}
console.log([...perCode]);

{
  "id": "741000000000000400",
  "orderId": "741000000000000401",
  "codeId": "741000000000000300",
  "code": "SARA10",
  "amount": "900.00",
  "currency": "DZD",
  "state": "final",
  "createdAt": "2026-10-04T10:00:00.000Z"
}

const { data: order, rejectedCodes } = await admin.post('/orders', {
  body: {
    buyer: { name: 'Amina B.', phone: '+213555123456' },
    items: [{ productId: '741000000000000500', quantity: 2 }],
    codes: ['SARA10'],
  },
});

for (const entry of rejectedCodes ?? []) {
  console.log(`${entry.code} was not used: ${entry.reason}`);
}
console.log(order.discountTotal, order.discounts);

name        = "Wheely"
handle      = "wheely"
api_version = "2026-10"

[access]
scopes = ["write_offers", "read_products"]

[access.scope_reasons]
write_offers  = "Create the offers your merchants set up in Wheely"
read_products = "Let a merchant pick the products an offer applies to"

[hosting]
mode = "external"
url  = "https://wheely.example.com"

[admin]
page = "/"

[[offers.types]]
handle      = "mix-match"
class       = "product"
path        = "/offers/mix-match"
label       = { ar = "اخلط واختر", en = "Mix and match" }
description = { ar = "القطعة الثالثة مجانًا", en = "The third piece free" }

import type { AppOfferConfig } from '@tassyir/app';

// The third piece free on a collection, in two wilayas.
const config: AppOfferConfig = {
  typeHandle: 'mix-match',
  rule: {
    class: 'product',
    when: {
      all: [
        { 'lines.collection': '741000000000000900', 'quantity.gte': 3 },
        { 'delivery.wilaya.in': ['16', '31'] },
      ],
    },
    then: [
      { 'discount.cheapest': { percent: 100, count: 1 } },
      { label: { ar: 'القطعة الثالثة مجانًا', en: 'The third piece free' } },
    ],
  },
};

const { data: offer } = await admin.post('/offers', {
  body: {
    storeId: '741000000000000100',
    kind: 'app',
    method: 'automatic',
    title: 'Mix and match, autumn',
    config,
  },
});