@curless/shopify-adapter 0.5.0 → 0.7.0

package/dist/checkout.d.ts

@@ -0,0 +1,21 @@
+import type { ShopifyConfig } from './types.js';
+export type CartLine = {
+    /** Shopify variant NUMERIC id (CatalogItem.variantId), not the gid://. */
+    variantId: string;
+    quantity: number;
+};
+export declare const cartPermalink: (config: Pick<ShopifyConfig, "shopDomain">, lines: CartLine[], opts?: {
+    discountCode?: string;
+    note?: string;
+    /**
+     * Cart attributes — `attributes[key]=value`, which Shopify records on the
+     * order and shows the merchant under its additional details.
+     *
+     * This is the ONLY place an order can carry where it came from. The order's
+     * `Channel` says "Online Store" because that is literally the channel that
+     * created it, and changing that would mean being a registered sales-channel
+     * app rather than a link.
+     */
+    attributes?: Record<string, string>;
+}) => string;
+//# sourceMappingURL=checkout.d.ts.map

package/dist/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../src/checkout.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAAG;IACrB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAQF,eAAO,MAAM,aAAa,GACxB,QAAQ,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,EACzC,OAAO,QAAQ,EAAE,EACjB,OAAM;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,KACL,MAoBF,CAAC"}

package/dist/checkout.js

@@ -0,0 +1,29 @@
+// `https://shop.myshopify.com/cart/{variantId}:{qty},{variantId}:{qty}?…`
+//
+// The permalink is a documented Shopify entry point, and it is the reason this
+// path needs no app permissions at all — anyone holding a variant id can build
+// one. That also means it must never carry anything private: no buyer email, no
+// internal ids, nothing but what the buyer is buying.
+export const cartPermalink = (config, lines, opts = {}) => {
+    const usable = lines.filter((l) => l.variantId && Number.isInteger(l.quantity) && l.quantity > 0);
+    if (usable.length === 0) {
+        throw new Error('cartPermalink: need at least one line with a variantId and a positive quantity');
+    }
+    // A gid:// slipped in here would 404 the buyer at the checkout with no hint
+    // why, so take the numeric tail rather than trusting the caller's shape.
+    const path = usable
+        .map((l) => `${String(l.variantId).replace(/^.*\//, '')}:${l.quantity}`)
+        .join(',');
+    const qs = new URLSearchParams();
+    if (opts.discountCode)
+        qs.set('discount', opts.discountCode);
+    if (opts.note)
+        qs.set('note', opts.note);
+    for (const [k, v] of Object.entries(opts.attributes ?? {})) {
+        if (k && v)
+            qs.set(`attributes[${k}]`, v);
+    }
+    const query = qs.toString();
+    return `https://${config.shopDomain}/cart/${path}${query ? `?${query}` : ''}`;
+};
+//# sourceMappingURL=checkout.js.map

package/dist/checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../src/checkout.ts"],"names":[],"mappings":"AAeA,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAyC,EACzC,KAAiB,EACjB,OAaI,EAAE,EACE,EAAE;IACV,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,4EAA4E;IAC5E,yEAAyE;IACzE,MAAM,IAAI,GAAG,MAAM;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;SACvE,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,YAAY;QAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,IAAI;QAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC;YAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,OAAO,WAAW,MAAM,CAAC,UAAU,SAAS,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAChF,CAAC,CAAC"}

package/dist/discounts.d.ts

@@ -0,0 +1,51 @@
+import type { ShopifyConfig } from './types.js';
+export type ShopifyDiscount = {
+    /**
+     * The merchant's own words, which is usually the whole story — they write
+     * "Buy 2 get 5% OFF | Buy 3 get 10% OFF" precisely because it is what the
+     * shopper reads on the product page.
+     */
+    title: string;
+    /** ACTIVE / SCHEDULED / EXPIRED, straight from Shopify. */
+    status: string;
+    /**
+     * How it applies, when Shopify says so in a form we can read:
+     *   percentage  a plain "10% off" automatic discount
+     *   amount      a fixed sum off
+     *   bxgy        buy X get Y
+     *   app         a discount FUNCTION — the tiers live in the app's own
+     *               metafields and are not readable generically. The title is
+     *               what we have, and it is usually enough.
+     */
+    kind: 'percentage' | 'amount' | 'bxgy' | 'app' | 'unknown';
+    /** For `percentage`, e.g. 0.05 for 5%. */
+    percentage?: number;
+    /** For `amount`, in minor units of the shop's currency. */
+    amountOffMinor?: number;
+    /** Minimum spend that unlocks it, in minor units, when there is one. */
+    minSubtotalMinor?: number;
+    /** Minimum quantity that unlocks it, when there is one. */
+    minQuantity?: number;
+    /** ISO timestamps, for a promotion that has not started or is ending. */
+    startsAt?: string;
+    endsAt?: string;
+};
+export type DiscountsResult = {
+    ok: true;
+    discounts: ShopifyDiscount[];
+}
+/**
+ * The token predates the scope. Distinguished from "no discounts" on purpose:
+ * one means the shop is not running any, the other means we cannot see them,
+ * and telling a merchant their promotions are invisible is only possible if we
+ * know which it is.
+ */
+ | {
+    ok: false;
+    reason: 'unauthorized' | 'failed';
+    detail: string;
+};
+export declare const fetchShopifyDiscounts: (config: ShopifyConfig, fetchImpl?: typeof fetch, first?: number) => Promise<DiscountsResult>;
+/** Only what a shopper can actually get right now. */
+export declare const activeDiscounts: (discounts: ShopifyDiscount[], now?: Date) => ShopifyDiscount[];
+//# sourceMappingURL=discounts.d.ts.map

package/dist/discounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discounts.d.ts","sourceRoot":"","sources":["../src/discounts.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC3D,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,eAAe,EAAE,CAAA;CAAE;AAC5C;;;;;GAKG;GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAqDrE,eAAO,MAAM,qBAAqB,GAChC,QAAQ,aAAa,EACrB,YAAW,OAAO,KAAa,EAC/B,cAAU,KACT,OAAO,CAAC,eAAe,CAmDzB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,eAAe,GAC1B,WAAW,eAAe,EAAE,EAC5B,UAAgB,KACf,eAAe,EAMd,CAAC"}

package/dist/discounts.js

@@ -0,0 +1,119 @@
+// The shop's live promotions — "Buy 2 get 5% OFF", "Gift over $66".
+//
+// These are NOT on the product or the variant. A merchant sets them up as
+// automatic discounts, so nothing about a lens says it is 5% off in threes; the
+// storefront reads them separately and prints the banner. A catalogue that only
+// reads products will show a price the buyer beats at checkout, and never
+// mention the offer that made them buy two.
+//
+// ⚠️ Needs the `read_discounts` scope. Scopes are granted at INSTALL, so adding
+// it to an app's config does nothing until the merchant reinstalls — until then
+// the query 403s. That must not take the storefront down, so `unauthorized` is a
+// first-class result rather than an exception: the catalogue keeps serving and
+// the caller can say what is missing and why.
+import { exchangeToken, shopifyGraphql } from './client.js';
+import { toMinor } from './money.js';
+// Automatic discounts only. Code discounts need the shopper to type a code, and
+// a storefront advertising one it cannot apply is worse than silence.
+const QUERY = `
+  query Discounts($first: Int!) {
+    shop { currencyCode }
+    automaticDiscountNodes(first: $first) {
+      nodes {
+        automaticDiscount {
+          __typename
+          ... on DiscountAutomaticBasic {
+            title status startsAt endsAt
+            customerGets {
+              value {
+                ... on DiscountPercentage { percentage }
+                ... on DiscountAmount { amount { amount } }
+              }
+            }
+            minimumRequirement {
+              ... on DiscountMinimumSubtotal { greaterThanOrEqualToSubtotal { amount } }
+              ... on DiscountMinimumQuantity { greaterThanOrEqualToQuantity }
+            }
+          }
+          ... on DiscountAutomaticBxgy { title status startsAt endsAt }
+          ... on DiscountAutomaticApp { title status startsAt endsAt }
+        }
+      }
+    }
+  }
+`;
+const kindOf = (typename) => {
+    if (typename === 'DiscountAutomaticBxgy')
+        return 'bxgy';
+    if (typename === 'DiscountAutomaticApp')
+        return 'app';
+    return 'unknown';
+};
+export const fetchShopifyDiscounts = async (config, fetchImpl = fetch, first = 25) => {
+    let token;
+    try {
+        token = await exchangeToken(config, fetchImpl);
+    }
+    catch (err) {
+        return { ok: false, reason: 'failed', detail: err instanceof Error ? err.message : 'auth' };
+    }
+    let page;
+    try {
+        page = await shopifyGraphql(config, token, QUERY, { first }, fetchImpl);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        // Shopify says ACCESS_DENIED when the scope is missing. Anything else is a
+        // real failure and should read as one.
+        const denied = /ACCESS_DENIED|access denied|not approved|required access/i.test(detail);
+        return { ok: false, reason: denied ? 'unauthorized' : 'failed', detail };
+    }
+    const currency = page.shop?.currencyCode ?? 'USD';
+    const out = [];
+    for (const n of page.automaticDiscountNodes?.nodes ?? []) {
+        const d = n.automaticDiscount;
+        if (!d?.title)
+            continue;
+        const pct = d.customerGets?.value?.percentage;
+        const amt = d.customerGets?.value?.amount?.amount;
+        const minSub = d.minimumRequirement?.greaterThanOrEqualToSubtotal?.amount;
+        const minQty = d.minimumRequirement?.greaterThanOrEqualToQuantity;
+        // A price that cannot be parsed is left off rather than guessed — a wrong
+        // discount is a wrong price, and the buyer finds out at checkout.
+        const money = (v) => {
+            if (v === undefined)
+                return undefined;
+            try {
+                return toMinor(v, currency);
+            }
+            catch {
+                return undefined;
+            }
+        };
+        out.push({
+            title: d.title,
+            status: d.status ?? 'UNKNOWN',
+            kind: pct !== undefined ? 'percentage' : amt !== undefined ? 'amount' : kindOf(d.__typename),
+            ...(pct !== undefined ? { percentage: pct } : {}),
+            ...(money(amt) !== undefined ? { amountOffMinor: money(amt) } : {}),
+            ...(money(minSub) !== undefined ? { minSubtotalMinor: money(minSub) } : {}),
+            ...(minQty !== undefined && Number.isFinite(Number(minQty))
+                ? { minQuantity: Number(minQty) }
+                : {}),
+            ...(d.startsAt ? { startsAt: d.startsAt } : {}),
+            ...(d.endsAt ? { endsAt: d.endsAt } : {}),
+        });
+    }
+    return { ok: true, discounts: out };
+};
+/** Only what a shopper can actually get right now. */
+export const activeDiscounts = (discounts, now = new Date()) => discounts.filter((d) => {
+    if (d.status !== 'ACTIVE')
+        return false;
+    if (d.startsAt && new Date(d.startsAt) > now)
+        return false;
+    if (d.endsAt && new Date(d.endsAt) < now)
+        return false;
+    return true;
+});
+//# sourceMappingURL=discounts.js.map

package/dist/discounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discounts.js","sourceRoot":"","sources":["../src/discounts.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,14 @@
 export { shopifyConfigFromEnv, exchangeToken, shopifyGraphql } from './client.js';
 export { fetchShopifyCatalog, productsToItems } from './catalog.js';
 export { writebackShopifyOrder, refundShopifyOrder } from './orders.js';
+export { fetchShopifyProducts, fetchProductVariants, resolveVariant, snapChoices, } from './products.js';
+export { lookupShopifyOrder } from './order-lookup.js';
+export { fetchShopifyDiscounts, activeDiscounts } from './discounts.js';
+export { cartPermalink } from './checkout.js';
 export { decimalsFor, toMinor, toMajorString } from './money.js';
+export type { ShopifyProduct, ProductVariant, ProductOption } from './products.js';
+export type { OrderLookupResult, OrderLookupLine } from './order-lookup.js';
+export type { ShopifyDiscount, DiscountsResult } from './discounts.js';
+export type { CartLine } from './checkout.js';
 export type { CatalogItem, ShopifyConfig, OrderWriteback, WritebackResult, OrderRefund, RefundResult, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -15,5 +15,9 @@
 export { shopifyConfigFromEnv, exchangeToken, shopifyGraphql } from './client.js';
 export { fetchShopifyCatalog, productsToItems } from './catalog.js';
 export { writebackShopifyOrder, refundShopifyOrder } from './orders.js';
+export { fetchShopifyProducts, fetchProductVariants, resolveVariant, snapChoices, } from './products.js';
+export { lookupShopifyOrder } from './order-lookup.js';
+export { fetchShopifyDiscounts, activeDiscounts } from './discounts.js';
+export { cartPermalink } from './checkout.js';
 export { decimalsFor, toMinor, toMajorString } from './money.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8DAA8D;AAC9D,EAAE;AACF,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,iFAAiF;AACjF,uFAAuF;AACvF,4EAA4E;AAC5E,gDAAgD;AAChD,4FAA4F;AAC5F,wEAAwE;AACxE,8EAA8E;AAC9E,qEAAqE;AACrE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8DAA8D;AAC9D,EAAE;AACF,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,iFAAiF;AACjF,uFAAuF;AACvF,4EAA4E;AAC5E,gDAAgD;AAChD,4FAA4F;AAC5F,wEAAwE;AACxE,8EAA8E;AAC9E,qEAAqE;AACrE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/order-lookup.d.ts

@@ -0,0 +1,33 @@
+import type { ShopifyConfig } from './types.js';
+export type OrderLookupLine = {
+    title: string;
+    variantTitle?: string;
+    quantity: number;
+    priceMinor: number;
+    imageUrl?: string;
+};
+export type OrderLookupResult = {
+    found: true;
+    /** The merchant-facing number, e.g. "#1052". */
+    name: string;
+    createdAt: string;
+    currency: string;
+    totalMinor: number;
+    /** Shopify's own vocabulary: PAID / REFUNDED / PARTIALLY_REFUNDED / … */
+    financialStatus: string;
+    /** UNFULFILLED / FULFILLED / …, or undefined when Shopify reports none. */
+    fulfillmentStatus?: string;
+    lines: OrderLookupLine[];
+    /** Carrier tracking URLs, when the merchant has shipped and entered them. */
+    trackingUrls: string[];
+    /** Shopify's own status page for this order — the buyer's canonical view. */
+    statusUrl?: string;
+} | {
+    found: false;
+    reason: 'not-found';
+};
+export declare const lookupShopifyOrder: (config: ShopifyConfig, input: {
+    orderNumber: string;
+    email: string;
+}, fetchImpl?: typeof fetch) => Promise<OrderLookupResult>;
+//# sourceMappingURL=order-lookup.d.ts.map

package/dist/order-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-lookup.d.ts","sourceRoot":"","sources":["../src/order-lookup.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAiD1C,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,aAAa,EACrB,OAAO;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC7C,YAAW,OAAO,KAAa,KAC9B,OAAO,CAAC,iBAAiB,CAoD3B,CAAC"}

package/dist/order-lookup.js

@@ -0,0 +1,83 @@
+// "Where is my order?" — for a storefront where the buyer has no account.
+//
+// ⚠️ THE WHOLE DESIGN IS THE TWO-FACTOR CHECK. Checkout happens on Shopify's own
+// page, so nothing here knows who is asking: an agent typing an order number is
+// not proof of anything. Requiring the order number AND the email it was placed
+// with is the same bar Shopify's own guest order lookup sets — one alone is
+// guessable (order numbers are sequential), both together are not.
+//
+// So: never return an order because the number matched. The email must match
+// too, and a mismatch is reported exactly like a miss — telling the caller
+// "right order, wrong email" would confirm that the order exists, which is half
+// the answer they were not entitled to.
+import { exchangeToken, shopifyGraphql } from './client.js';
+import { toMinor } from './money.js';
+const QUERY = `
+  query FindOrder($q: String!) {
+    orders(first: 5, query: $q) {
+      nodes {
+        name createdAt email
+        displayFinancialStatus displayFulfillmentStatus statusPageUrl
+        currentTotalPriceSet { shopMoney { amount currencyCode } }
+        lineItems(first: 20) {
+          nodes {
+            title variantTitle quantity
+            originalUnitPriceSet { shopMoney { amount } }
+            image { url }
+          }
+        }
+        fulfillments(first: 10) { trackingInfo { url } }
+      }
+    }
+  }
+`;
+// Shopify's search syntax is space-separated terms; a stray quote or colon in
+// caller input would change the query's meaning rather than fail it. Keep only
+// what an order number can legitimately contain.
+const safeOrderNumber = (raw) => raw.trim().replace(/[^0-9A-Za-z#_-]/g, '');
+export const lookupShopifyOrder = async (config, input, fetchImpl = fetch) => {
+    const number = safeOrderNumber(input.orderNumber);
+    const email = input.email.trim().toLowerCase();
+    // Both are required. An empty one must not degrade into "match on the other".
+    if (!number || !email.includes('@'))
+        return { found: false, reason: 'not-found' };
+    const token = await exchangeToken(config, fetchImpl);
+    const withHash = number.startsWith('#') ? number : `#${number}`;
+    const data = await shopifyGraphql(config, token, QUERY, { q: `name:${JSON.stringify(withHash)}` }, fetchImpl);
+    const order = data.orders.nodes.find((o) => o.name === withHash && (o.email ?? '').trim().toLowerCase() === email);
+    // Deliberately the same answer as "no such order": see the header.
+    if (!order)
+        return { found: false, reason: 'not-found' };
+    const currency = order.currentTotalPriceSet.shopMoney.currencyCode;
+    const minor = (amount) => {
+        try {
+            return toMinor(amount, currency);
+        }
+        catch {
+            return 0;
+        }
+    };
+    return {
+        found: true,
+        name: order.name,
+        createdAt: order.createdAt,
+        currency,
+        totalMinor: minor(order.currentTotalPriceSet.shopMoney.amount),
+        financialStatus: order.displayFinancialStatus ?? 'UNKNOWN',
+        ...(order.displayFulfillmentStatus
+            ? { fulfillmentStatus: order.displayFulfillmentStatus }
+            : {}),
+        lines: order.lineItems.nodes.map((l) => ({
+            title: l.title,
+            ...(l.variantTitle ? { variantTitle: l.variantTitle } : {}),
+            quantity: l.quantity,
+            priceMinor: minor(l.originalUnitPriceSet.shopMoney.amount),
+            ...(l.image?.url ? { imageUrl: l.image.url } : {}),
+        })),
+        trackingUrls: order.fulfillments
+            .flatMap((f) => f.trackingInfo.map((t) => t.url))
+            .filter((u) => Boolean(u)),
+        ...(order.statusPageUrl ? { statusUrl: order.statusPageUrl } : {}),
+    };
+};
+//# sourceMappingURL=order-lookup.js.map

package/dist/order-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-lookup.js","sourceRoot":"","sources":["../src/order-lookup.ts"],"names":[],"mappings":"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"}

package/dist/products.d.ts

@@ -0,0 +1,61 @@
+import type { ShopifyConfig } from './types.js';
+export type ProductOption = {
+    /** The merchant's own label — "Color", "度数", "Size". Never normalized. */
+    name: string;
+    /** In the merchant's own order, which is usually meaningful (-0.00 → -5.00). */
+    values: string[];
+};
+export type ProductVariant = {
+    /** Numeric variant id — what a cart permalink takes. */
+    variantId: string;
+    sku: string | null;
+    /** Shopify's own joined title, e.g. "Teal / -2.00". */
+    title: string;
+    priceMinor: number;
+    /** Struck-through price when the merchant set one, else undefined. */
+    compareAtMinor?: number;
+    available: boolean;
+    /** Which option values select this variant — the picker matches on these. */
+    options: {
+        name: string;
+        value: string;
+    }[];
+    imageUrl?: string;
+};
+export type ShopifyProduct = {
+    /** Shopify numeric product id. */
+    id: string;
+    /** URL slug — the storefront link a buyer can be sent to. */
+    handle: string;
+    /**
+     * The product's page on the merchant's OWN storefront, built from the shop's
+     * primary domain rather than the *.myshopify.com host — that is the address
+     * they advertise, the one with their reviews and size guide on it, and the one
+     * a buyer should land on if they want to read more before choosing.
+     */
+    url?: string;
+    title: string;
+    description: string;
+    productType: string;
+    tags: string[];
+    currency: string;
+    imageUrl?: string;
+    images: string[];
+    options: ProductOption[];
+    /**
+     * EMPTY from the bulk read. A pair of lenses is Left × Right, 676 variants,
+     * and 382 of those products is a quarter-million objects held in memory to
+     * answer "what colours do you have" — while still not being complete enough to
+     * resolve a purchase. Load them per product, when someone is buying one.
+     */
+    variants: ProductVariant[];
+    /** False until `fetchProductVariants` has filled them. Guards the resolver. */
+    variantsLoaded: boolean;
+    /** Cheapest available variant, for a list that shows one price per product. */
+    fromPriceMinor?: number;
+};
+export declare const fetchShopifyProducts: (config: ShopifyConfig, fetchImpl?: typeof fetch, warn?: (msg: string) => void) => Promise<ShopifyProduct[]>;
+export declare const resolveVariant: (variants: ProductVariant[], choices: Record<string, string>) => ProductVariant | null;
+export declare const snapChoices: (options: ProductOption[], choices: Record<string, string>) => Record<string, string>;
+export declare const fetchProductVariants: (config: ShopifyConfig, handle: string, fetchImpl?: typeof fetch, warn?: (msg: string) => void) => Promise<ProductVariant[]>;
+//# sourceMappingURL=products.d.ts.map

package/dist/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../src/products.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;IACxB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AA2DF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,EACrB,YAAW,OAAO,KAAa,EAC/B,OAAM,CAAC,GAAG,EAAE,MAAM,KAAK,IAA4C,KAClE,OAAO,CAAC,cAAc,EAAE,CAsD1B,CAAC;AAiCF,eAAO,MAAM,cAAc,GACzB,UAAU,cAAc,EAAE,EAC1B,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,cAAc,GAAG,IASnB,CAAC;AAeF,eAAO,MAAM,WAAW,GACtB,SAAS,aAAa,EAAE,EACxB,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CASvB,CAAC;AAyBF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,EACrB,QAAQ,MAAM,EACd,YAAW,OAAO,KAAa,EAC/B,OAAM,CAAC,GAAG,EAAE,MAAM,KAAK,IAA4C,KAClE,OAAO,CAAC,cAAc,EAAE,CAuD1B,CAAC"}

package/dist/products.js

@@ -0,0 +1,216 @@
+// Shopify store → PRODUCTS with their option matrix intact.
+//
+// `fetchShopifyCatalog` flattens every variant into a standalone CatalogItem,
+// which is right for a gateway quoting one sku. It is wrong for a storefront:
+// a buyer picks a product, then picks its options, and the two choices together
+// name the variant. Contact lenses are the clearest case — one product is
+// Colour × Prescription, and "Jade Flare" alone cannot be bought.
+//
+// So this returns the shape a picker needs: the option names in the merchant's
+// own words, their values in the merchant's own order, and every variant with
+// the option values that select it.
+import { exchangeToken, shopifyGraphql } from './client.js';
+import { toMinor } from './money.js';
+const PAGE = 50;
+// Shopify's own ceiling for a connection page. A pair of contact lenses is
+// Left × Right — 26 × 26 = 676 variants — so even the maximum does not fetch one
+// product whole, which is exactly why the bulk read no longer tries.
+const VARIANT_PAGE = 250;
+const QUERY = `
+  query Products($first: Int!, $after: String) {
+    shop { currencyCode primaryDomain { url } }
+    products(first: $first, after: $after, query: "status:active") {
+      pageInfo { hasNextPage endCursor }
+      nodes {
+        id handle title description productType tags status
+        featuredImage { url }
+        media(first: 8) { nodes { preview { image { url } } } }
+        options { name optionValues { name } }
+        priceRangeV2 { minVariantPrice { amount currencyCode } }
+      }
+    }
+  }
+`;
+// `gid://shopify/ProductVariant/123` → `123`. Cart permalinks and the Admin URL
+// both want the bare number, and a gid slipped into either fails in a way that
+// says nothing about why.
+const numericId = (gid) => gid.replace(/^.*\//, '');
+export const fetchShopifyProducts = async (config, fetchImpl = fetch, warn = (m) => console.warn(`[shopify] ${m}`)) => {
+    const token = await exchangeToken(config, fetchImpl);
+    const out = [];
+    let cursor = null;
+    let currency = 'USD';
+    let storefront;
+    do {
+        const page = await shopifyGraphql(config, token, QUERY, { first: PAGE, after: cursor }, fetchImpl);
+        currency = page.shop?.currencyCode ?? currency;
+        storefront = page.shop?.primaryDomain?.url ?? storefront;
+        for (const p of page.products.nodes) {
+            let fromPriceMinor;
+            const from = p.priceRangeV2?.minVariantPrice;
+            if (from) {
+                try {
+                    fromPriceMinor = toMinor(from.amount, from.currencyCode || currency);
+                }
+                catch {
+                    warn(`"${p.title}" has an unparseable price ${JSON.stringify(from.amount)}`);
+                }
+            }
+            const images = p.media.nodes
+                .map((n) => n.preview?.image?.url)
+                .filter((u) => Boolean(u));
+            out.push({
+                id: numericId(p.id),
+                handle: p.handle,
+                ...(storefront ? { url: `${storefront.replace(/\/$/, '')}/products/${p.handle}` } : {}),
+                title: p.title,
+                description: p.description ?? '',
+                productType: p.productType ?? '',
+                tags: p.tags ?? [],
+                currency,
+                ...(p.featuredImage?.url ? { imageUrl: p.featuredImage.url } : {}),
+                images,
+                options: p.options.map((o) => ({
+                    name: o.name,
+                    values: o.optionValues.map((v) => v.name),
+                })),
+                // EMPTY by design — see the type. Fetch them for the one product a buyer
+                // is actually looking at.
+                variants: [],
+                variantsLoaded: false,
+                ...(fromPriceMinor !== undefined ? { fromPriceMinor } : {}),
+            });
+        }
+        cursor = page.products.pageInfo.hasNextPage ? page.products.pageInfo.endCursor : null;
+    } while (cursor);
+    return out;
+};
+// Resolve a buyer's choices to ONE variant. Takes the VARIANTS, not the product:
+// a product from the bulk read carries none, and passing it here would resolve
+// to "nothing matches" — indistinguishable from a prescription the store does
+// not stock, and the caller would ask the buyer a question they already answered.
+//
+// Option names and values are matched case- and space-insensitively because the
+// buyer is typing, not clicking: they say "left" for "Left" and "-2.0" for
+// "-2.00".
+//
+// Returns null when the choices do not name exactly one variant — the caller
+// must then ask rather than pick, because guessing here means shipping someone
+// the wrong prescription.
+const norm = (s) => s.trim().toLowerCase().replace(/\s+/g, '');
+// A numeric choice compares numerically: "-2.0", "-2.00" and "−2.00" (with a
+// unicode minus, which is what a phone keyboard produces) are one value. The
+// empty string is NOT a number here — Number('') is 0, and a blank answer that
+// silently meant "0.00 dioptres" would be a plano lens nobody asked for.
+const asNumber = (s) => {
+    const t = s.trim().replace(/[−–—]/g, '-');
+    if (t === '')
+        return null;
+    const n = Number(t);
+    return Number.isFinite(n) ? n : null;
+};
+/** Whether two option names — or two option values — mean the same thing. */
+const same = (a, b) => {
+    const [na, nb] = [asNumber(a), asNumber(b)];
+    return na !== null && nb !== null ? na === nb : norm(a) === norm(b);
+};
+export const resolveVariant = (variants, choices) => {
+    const wanted = Object.entries(choices).filter(([, v]) => v !== undefined && v !== '');
+    if (wanted.length === 0)
+        return null;
+    const matches = variants.filter((v) => wanted.every(([name, value]) => v.options.some((o) => same(o.name, name) && same(o.value, value))));
+    return matches.length === 1 ? (matches[0] ?? null) : null;
+};
+// The buyer's choices, rewritten in the STORE's own words — `{left: '-2.0'}`
+// against a `Left: -2.00` option becomes `{Left: '-2.00'}`.
+//
+// This exists because those choices get handed onwards. A picker that shows the
+// buyer what was understood so far has to compare them against the option values
+// it draws, and comparing `-2.0` to `-2.00` as strings highlights nothing while
+// still counting as answered — so the buyer sees an unanswered question with the
+// Buy button live, presses it, and gets the same screen back. Snapping here, in
+// the one place that already knows how these compare, keeps that logic from
+// being reimplemented (differently) further out.
+//
+// Anything that does not name exactly one value is DROPPED, not guessed: an
+// unrecognised prescription has to come back as a question.
+export const snapChoices = (options, choices) => {
+    const out = {};
+    for (const [name, value] of Object.entries(choices)) {
+        if (value === undefined || value === '')
+            continue;
+        const opt = options.find((o) => same(o.name, name));
+        const hits = opt?.values.filter((v) => same(v, value)) ?? [];
+        if (opt && hits.length === 1 && hits[0] !== undefined)
+            out[opt.name] = hits[0];
+    }
+    return out;
+};
+const VARIANTS_QUERY = `
+  query ProductVariants($handle: String!, $first: Int!, $after: String) {
+    shop { currencyCode }
+    productByHandle(handle: $handle) {
+      variants(first: $first, after: $after) {
+        pageInfo { hasNextPage endCursor }
+        nodes {
+          id sku title price compareAtPrice availableForSale
+          selectedOptions { name value }
+          image { url }
+        }
+      }
+    }
+  }
+`;
+// Every variant of ONE product, paginated to completion.
+//
+// Completeness is the point. The bulk read used to take the first 100 of 676 and
+// warn about the rest — the warning was accurate and the behaviour was still
+// wrong, because a buyer asking for -6.50 in the right eye was told it does not
+// exist when it merely sat past a page boundary. Most of the store was
+// unbuyable and every refusal looked like a legitimate "we don't stock that".
+export const fetchProductVariants = async (config, handle, fetchImpl = fetch, warn = (m) => console.warn(`[shopify] ${m}`)) => {
+    const token = await exchangeToken(config, fetchImpl);
+    const out = [];
+    let cursor = null;
+    let currency = 'USD';
+    do {
+        const page = await shopifyGraphql(config, token, VARIANTS_QUERY, { handle, first: VARIANT_PAGE, after: cursor }, fetchImpl);
+        currency = page.shop?.currencyCode ?? currency;
+        const conn = page.productByHandle?.variants;
+        if (!conn)
+            return out;
+        for (const v of conn.nodes) {
+            let priceMinor;
+            try {
+                priceMinor = toMinor(v.price, currency);
+            }
+            catch {
+                warn(`skipping ${handle} / ${v.title} — unparseable price ${JSON.stringify(v.price)}`);
+                continue;
+            }
+            let compareAtMinor;
+            if (v.compareAtPrice) {
+                try {
+                    compareAtMinor = toMinor(v.compareAtPrice, currency);
+                }
+                catch {
+                    // Cosmetic only — drop the strike-through, keep the variant buyable.
+                    compareAtMinor = undefined;
+                }
+            }
+            out.push({
+                variantId: numericId(v.id),
+                sku: v.sku,
+                title: v.title,
+                priceMinor,
+                ...(compareAtMinor !== undefined ? { compareAtMinor } : {}),
+                available: v.availableForSale,
+                options: v.selectedOptions ?? [],
+                ...(v.image?.url ? { imageUrl: v.image.url } : {}),
+            });
+        }
+        cursor = conn.pageInfo.hasNextPage ? conn.pageInfo.endCursor : null;
+    } while (cursor);
+    return out;
+};
+//# sourceMappingURL=products.js.map

package/dist/products.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.js","sourceRoot":"","sources":["../src/products.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@curless/shopify-adapter",
-  "version": "0.5.0",
-  "description": "Use a Shopify store as an agentbank catalog source, and record agent-settled sales back as paid Shopify orders. Maps Shopify Admin products → a generic CatalogItem your merchant backend prices from, writes an order back after an agent pays through agentbank, and records the reversal when that sale is refunded. Zero runtime dependencies (uses the platform fetch).",
+  "version": "0.7.0",
+  "description": "Use a Shopify store as an agentbank catalog source, and record agent-settled sales back as paid Shopify orders. Maps Shopify Admin products \u2192 a generic CatalogItem your merchant backend prices from, writes an order back after an agent pays through agentbank, and records the reversal when that sale is refunded. Zero runtime dependencies (uses the platform fetch).",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -12,13 +12,17 @@
       "default": "./dist/index.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
+  "files": ["dist", "README.md"],
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
   "devDependencies": {
     "@types/node": "^22.10.1",
     "typescript": "^5.6.3",
@@ -41,11 +45,5 @@
     "url": "git+https://gitlab.com/robin-ruan/agentbank.git",
     "directory": "packages/sdks/shopify-adapter"
   },
-  "author": "robin",
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "clean": "rm -rf dist"
-  }
-}
+  "author": "robin"
+}