@conseqa/connector-shopify 0.0.0-reserved.0 → 0.1.8

package/dist/correlation.d.ts

@@ -0,0 +1,35 @@
+/** Time-ordered, 29 characters: short enough for every provider's reference field. */
+export declare function createShopifyCorrelationKey(nowMs?: number, random?: Uint8Array): string;
+/** The marker written into a refund's note, which Shopify stores and returns on every read. */
+export declare function correlationToken(providerCorrelationKey: string): string;
+/** A refund note that carries the key after whatever the agent wrote for people to read. */
+export declare function correlationNote(providerCorrelationKey: string, note?: string | null): string;
+/** Every Conseqa key found in a note. More than one means the note cannot identify one call. */
+export declare function correlationKeysIn(note: string | null | undefined): string[];
+/**
+ * The refundCreate mutation an application sends. The same key goes into the
+ * refund's note, where a read-only reader can find it, and into Shopify's
+ * @idempotent directive, which stops a retried call from refunding twice.
+ * Shopify does not store the idempotency key where it can be read, which is why
+ * the note carries it too.
+ */
+export declare const SHOPIFY_REFUND_CREATE_MUTATION = "mutation ConseqaRefundCreate($input: RefundInput!, $idempotencyKey: String!) {\n  refundCreate(input: $input) @idempotent(key: $idempotencyKey) {\n    refund {\n      id\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}";
+export interface ShopifyRefundInput {
+    readonly orderId: string;
+    readonly note?: string | null;
+    readonly [field: string]: unknown;
+}
+export interface ShopifyRefundRequestDecoration {
+    readonly providerCorrelationKey: string;
+    readonly query: string;
+    readonly variables: {
+        readonly input: ShopifyRefundInput & {
+            readonly orderId: string;
+            readonly note: string;
+        };
+        readonly idempotencyKey: string;
+    };
+}
+/** Builds the request for an application's existing refund: its input, plus the key. */
+export declare function decorateShopifyRefundRequest(input: ShopifyRefundInput, providerCorrelationKey: string): ShopifyRefundRequestDecoration;
+//# sourceMappingURL=correlation.d.ts.map

package/dist/correlation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../src/correlation.ts"],"names":[],"mappings":"AAoCA,sFAAsF;AACtF,wBAAgB,2BAA2B,CACzC,KAAK,SAAa,EAClB,MAAM,GAAE,UAA4B,GACnC,MAAM,CAER;AAID,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,sBAAsB,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,sBAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI5F;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAE3E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,kPAUzC,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG;YAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACzF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,wFAAwF;AACxF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kBAAkB,EACzB,sBAAsB,EAAE,MAAM,GAC7B,8BAA8B,CAahC"}

package/dist/correlation.js

@@ -0,0 +1,87 @@
+import { randomBytes } from "node:crypto";
+import { toShopifyOrderGid } from "./types.js";
+const alphabet = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+function uuidV7Bytes(nowMs, random) {
+    if (random.length < 10)
+        throw new Error("UUIDv7 requires ten random bytes");
+    const bytes = new Uint8Array(16);
+    let timestamp = BigInt(Math.trunc(nowMs));
+    for (let index = 5; index >= 0; index -= 1) {
+        bytes[index] = Number(timestamp & 0xffn);
+        timestamp >>= 8n;
+    }
+    bytes.set(random.slice(0, 10), 6);
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x70;
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;
+    return bytes;
+}
+function base32(bytes) {
+    let accumulator = 0;
+    let bits = 0;
+    let output = "";
+    for (const byte of bytes) {
+        accumulator = (accumulator << 8) | byte;
+        bits += 8;
+        while (bits >= 5) {
+            output += alphabet[(accumulator >>> (bits - 5)) & 31];
+            bits -= 5;
+        }
+        accumulator &= (1 << bits) - 1;
+    }
+    if (bits > 0)
+        output += alphabet[(accumulator << (5 - bits)) & 31];
+    return output;
+}
+/** Time-ordered, 29 characters: short enough for every provider's reference field. */
+export function createShopifyCorrelationKey(nowMs = Date.now(), random = randomBytes(10)) {
+    return `cq_${base32(uuidV7Bytes(nowMs, random)).toLowerCase()}`;
+}
+const TOKEN = /\[conseqa:(cq_[0-9a-z]{26})\]/gu;
+/** The marker written into a refund's note, which Shopify stores and returns on every read. */
+export function correlationToken(providerCorrelationKey) {
+    return `[conseqa:${providerCorrelationKey}]`;
+}
+/** A refund note that carries the key after whatever the agent wrote for people to read. */
+export function correlationNote(providerCorrelationKey, note) {
+    const human = note?.trim();
+    const token = correlationToken(providerCorrelationKey);
+    return human ? `${human} ${token}` : token;
+}
+/** Every Conseqa key found in a note. More than one means the note cannot identify one call. */
+export function correlationKeysIn(note) {
+    return [...(note ?? "").matchAll(TOKEN)].map((match) => match[1]);
+}
+/**
+ * The refundCreate mutation an application sends. The same key goes into the
+ * refund's note, where a read-only reader can find it, and into Shopify's
+ * @idempotent directive, which stops a retried call from refunding twice.
+ * Shopify does not store the idempotency key where it can be read, which is why
+ * the note carries it too.
+ */
+export const SHOPIFY_REFUND_CREATE_MUTATION = `mutation ConseqaRefundCreate($input: RefundInput!, $idempotencyKey: String!) {
+  refundCreate(input: $input) @idempotent(key: $idempotencyKey) {
+    refund {
+      id
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}`;
+/** Builds the request for an application's existing refund: its input, plus the key. */
+export function decorateShopifyRefundRequest(input, providerCorrelationKey) {
+    return {
+        providerCorrelationKey,
+        query: SHOPIFY_REFUND_CREATE_MUTATION,
+        variables: {
+            input: {
+                ...input,
+                orderId: toShopifyOrderGid(input.orderId),
+                note: correlationNote(providerCorrelationKey, input.note),
+            },
+            idempotencyKey: providerCorrelationKey,
+        },
+    };
+}
+//# sourceMappingURL=correlation.js.map

package/dist/correlation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.js","sourceRoot":"","sources":["../src/correlation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAEpD,SAAS,WAAW,CAAC,KAAa,EAAE,MAAkB;IACpD,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;QACzC,SAAS,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,KAAiB;IAC/B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QACxC,IAAI,IAAI,CAAC,CAAC;QACV,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,QAAQ,CAAC,CAAC,WAAW,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACtD,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;QACD,WAAW,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,2BAA2B,CACzC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,EAClB,SAAqB,WAAW,CAAC,EAAE,CAAC;IAEpC,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,KAAK,GAAG,iCAAiC,CAAC;AAEhD,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,sBAA8B;IAC7D,OAAO,YAAY,sBAAsB,GAAG,CAAC;AAC/C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAAC,sBAA8B,EAAE,IAAoB;IAClF,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7C,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,IAA+B;IAC/D,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;;;;;;;EAU5C,CAAC;AAiBH,wFAAwF;AACxF,MAAM,UAAU,4BAA4B,CAC1C,KAAyB,EACzB,sBAA8B;IAE9B,OAAO;QACL,sBAAsB;QACtB,KAAK,EAAE,8BAA8B;QACrC,SAAS,EAAE;YACT,KAAK,EAAE;gBACL,GAAG,KAAK;gBACR,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,IAAI,EAAE,eAAe,CAAC,sBAAsB,EAAE,KAAK,CAAC,IAAI,CAAC;aAC1D;YACD,cAAc,EAAE,sBAAsB;SACvC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./client.js";
+export * from "./contract.js";
+export * from "./correlation.js";
+export * from "./money.js";
+export * from "./refund.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./client.js";
+export * from "./contract.js";
+export * from "./correlation.js";
+export * from "./money.js";
+export * from "./refund.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/money.d.ts

@@ -0,0 +1,9 @@
+/** How many minor units a currency has: 2 for INR and USD, 0 for JPY, 3 for KWD. */
+export declare function currencyExponent(currency: string): number;
+/**
+ * Shopify reports money as decimal strings ("25.00"). This converts one exactly
+ * to minor units, and returns null rather than rounding when it cannot: a
+ * verifier that rounds can call a wrong amount right.
+ */
+export declare function toMinorUnits(amount: string, currency: string): number | null;
+//# sourceMappingURL=money.d.ts.map

package/dist/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5E"}

package/dist/money.js

@@ -0,0 +1,29 @@
+/** How many minor units a currency has: 2 for INR and USD, 0 for JPY, 3 for KWD. */
+export function currencyExponent(currency) {
+    try {
+        return (new Intl.NumberFormat("en", { style: "currency", currency }).resolvedOptions()
+            .maximumFractionDigits ?? 2);
+    }
+    catch {
+        return 2;
+    }
+}
+/**
+ * Shopify reports money as decimal strings ("25.00"). This converts one exactly
+ * to minor units, and returns null rather than rounding when it cannot: a
+ * verifier that rounds can call a wrong amount right.
+ */
+export function toMinorUnits(amount, currency) {
+    const match = /^(-)?(\d+)(?:\.(\d+))?$/u.exec(amount.trim());
+    if (!match)
+        return null;
+    const exponent = currencyExponent(currency);
+    const fraction = match[3] ?? "";
+    if (fraction.length > exponent && /[^0]/u.test(fraction.slice(exponent)))
+        return null;
+    const value = Number(`${match[2]}${fraction.slice(0, exponent).padEnd(exponent, "0")}`);
+    if (!Number.isSafeInteger(value))
+        return null;
+    return match[1] ? -value : value;
+}
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,OAAO,CACL,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,eAAe,EAAE;aAC3E,qBAAqB,IAAI,CAAC,CAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,QAAgB;IAC3D,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC"}

package/dist/refund.d.ts

@@ -0,0 +1,48 @@
+import type { VerifierResult } from "@conseqa/verifiers";
+import type { ShopifyReadApi, ShopifyRefundBinding, ShopifyRefundDiscoveryResult, ShopifyRefundIntent, ShopifyRefundObservation, ShopifyRefundResource } from "./types.js";
+export interface ShopifyRefundDiscoveryContext {
+    readonly intent: ShopifyRefundIntent;
+    readonly providerCorrelationKey: string;
+    readonly dispatchStartedAt: string;
+    readonly discoveryDeadline: string;
+    readonly signal?: AbortSignal;
+}
+export declare function isExactRefundCandidate(refund: ShopifyRefundResource, context: ShopifyRefundDiscoveryContext): boolean;
+/**
+ * Finds the refund an agent's call made when its reply was lost. The order is
+ * named by the intent; the refund is the one whose note carries this call's
+ * key. Nothing is ever sent that could refund again.
+ */
+export declare function discoverShopifyRefund(api: ShopifyReadApi, context: ShopifyRefundDiscoveryContext): Promise<ShopifyRefundDiscoveryResult>;
+/**
+ * Reads the refund and decides. A refund record alone does not prove money
+ * moved: Shopify records the refund and then its transactions, whose status is
+ * what settles it. Verified needs every refund transaction to have succeeded
+ * and their sum to equal the intended amount.
+ */
+export declare function verifyShopifyRefund(api: ShopifyReadApi, intent: ShopifyRefundIntent, binding: ShopifyRefundBinding, signal?: AbortSignal, expectedCorrelationKey?: string): Promise<VerifierResult<ShopifyRefundObservation>>;
+/** The refund's ID from what the application's call returned, or null when it did not say. */
+export declare function bindShopifyRefundResult(result: unknown): ShopifyRefundBinding | null;
+/**
+ * Use this only when application code can prove the request was rejected
+ * locally before any network dispatch. A generic TypeError or AbortError is not
+ * proof, because either can also occur after the request reached Shopify.
+ */
+export declare class ShopifyRefundNotDispatchedError extends Error {
+    readonly code = "shopify_refund_not_dispatched";
+    constructor(message: string, options?: ErrorOptions);
+}
+export interface ShopifyRefundExceptionClassification {
+    readonly certainty: "rejected" | "ambiguous" | "not_executed";
+    readonly ambiguous: boolean;
+    readonly retryable: boolean;
+    readonly reason: string;
+}
+/**
+ * What an exception from the application's refundCreate call proves. Shopify
+ * answers a refusal it validated with userErrors and creates nothing, which is
+ * a definite rejection. Everything else may have happened, so it is ambiguous
+ * and the runner looks for the refund.
+ */
+export declare function classifyShopifyRefundException(error: unknown): ShopifyRefundExceptionClassification;
+//# sourceMappingURL=refund.d.ts.map

package/dist/refund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refund.d.ts","sourceRoot":"","sources":["../src/refund.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAQD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAUT;AAaD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CA0CvC;AAeD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,oBAAoB,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC,CAuJnD;AAgBD,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAIpF;AAED;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,IAAI,mCAAmC;gBAEpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;IAC9D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,oCAAoC,CAkDtC"}

package/dist/refund.js

@@ -0,0 +1,323 @@
+import { ShopifyReadError } from "./client.js";
+import { correlationKeysIn } from "./correlation.js";
+import { toMinorUnits } from "./money.js";
+/** The refund's note names this call, and only this call. */
+function carriesKey(refund, key) {
+    const keys = correlationKeysIn(refund.note);
+    return keys.length === 1 && keys[0] === key;
+}
+export function isExactRefundCandidate(refund, context) {
+    if (!carriesKey(refund, context.providerCorrelationKey))
+        return false;
+    if (refund.createdAt) {
+        const createdAtMs = new Date(refund.createdAt).getTime();
+        const lowerBound = new Date(context.dispatchStartedAt).getTime() - 60_000;
+        const upperBound = new Date(context.discoveryDeadline).getTime();
+        if (!Number.isFinite(createdAtMs) || createdAtMs < lowerBound || createdAtMs > upperBound)
+            return false;
+    }
+    return true;
+}
+function failureKind(error) {
+    const shopifyError = error instanceof ShopifyReadError ? error : undefined;
+    if (shopifyError?.kind === "schema")
+        return { reason: "schema", retryable: false };
+    if (shopifyError?.kind === "authentication" || shopifyError?.kind === "authorization")
+        return { reason: "authentication", retryable: false };
+    return { reason: "provider", retryable: shopifyError ? shopifyError.kind === "retryable" : true };
+}
+/**
+ * Finds the refund an agent's call made when its reply was lost. The order is
+ * named by the intent; the refund is the one whose note carries this call's
+ * key. Nothing is ever sent that could refund again.
+ */
+export async function discoverShopifyRefund(api, context) {
+    try {
+        const order = await api.getOrderRefunds(context.intent.orderId, context.signal);
+        if (!order) {
+            return {
+                kind: "inconclusive",
+                reason: "order_unreadable",
+                message: "The order cannot be read with this token. It needs read_orders, and read_all_orders for orders older than 60 days.",
+                retryable: false,
+            };
+        }
+        const candidates = order.refunds.filter((refund) => isExactRefundCandidate(refund, context));
+        if (candidates.length > 1) {
+            return {
+                kind: "inconclusive",
+                reason: "multiple_candidates",
+                message: `${candidates.length} refunds carry this call's key`,
+                candidateCount: candidates.length,
+            };
+        }
+        if (candidates.length === 1)
+            return { kind: "found", binding: { refundId: candidates[0].id, recovered: true } };
+        // Absence is only proof when every refund on the order was read.
+        if (!order.refundsComplete) {
+            return {
+                kind: "inconclusive",
+                reason: "too_many_refunds",
+                message: "The order has more refunds than one read returns, so absence cannot be proven",
+                retryable: false,
+            };
+        }
+        return { kind: "not_found" };
+    }
+    catch (error) {
+        const { reason, retryable } = failureKind(error);
+        return {
+            kind: "inconclusive",
+            reason,
+            message: error instanceof Error ? error.message : String(error),
+            retryable,
+        };
+    }
+}
+/** A transaction's amount in the intended currency, from whichever of its two amounts uses it. */
+function amountIn(transaction, currency) {
+    for (const money of [transaction.amountSet.shopMoney, transaction.amountSet.presentmentMoney]) {
+        if (money && money.currencyCode.toUpperCase() === currency)
+            return toMinorUnits(money.amount, currency);
+    }
+    return null;
+}
+const SETTLED_FAILED = new Set(["FAILURE", "ERROR"]);
+const UNSETTLED = new Set(["PENDING", "AWAITING_RESPONSE", "UNKNOWN"]);
+const KNOWN = new Set(["SUCCESS", ...SETTLED_FAILED, ...UNSETTLED]);
+/**
+ * Reads the refund and decides. A refund record alone does not prove money
+ * moved: Shopify records the refund and then its transactions, whose status is
+ * what settles it. Verified needs every refund transaction to have succeeded
+ * and their sum to equal the intended amount.
+ */
+export async function verifyShopifyRefund(api, intent, binding, signal, expectedCorrelationKey) {
+    try {
+        const refund = await api.getRefund(binding.refundId, signal);
+        if (!refund) {
+            return {
+                verdict: "inconclusive",
+                errorKind: "provider",
+                message: "Shopify has no readable refund with this ID",
+                retryable: true,
+            };
+        }
+        const refundTransactions = refund.transactions.filter((transaction) => transaction.kind === "REFUND");
+        const amounts = refundTransactions.map((transaction) => amountIn(transaction, intent.currency));
+        const statuses = refundTransactions.map((transaction) => transaction.status);
+        const amountMinor = amounts.reduce((sum, amount) => sum + (amount ?? 0), 0);
+        const status = refundTransactions.length === 0
+            ? "no_transactions"
+            : statuses.some((value) => SETTLED_FAILED.has(value))
+                ? "failed"
+                : statuses.every((value) => value === "SUCCESS")
+                    ? "succeeded"
+                    : "pending";
+        const keys = correlationKeysIn(refund.note);
+        const observation = {
+            refundId: refund.id,
+            orderId: refund.orderId ?? null,
+            correlationKey: keys.length === 1 ? keys[0] : null,
+            amountMinor,
+            currency: amounts.length > 0 && amounts.every((amount) => amount !== null) ? intent.currency : null,
+            transactionStatuses: statuses,
+            status,
+            settled: status === "succeeded" || status === "failed",
+            createdAt: refund.createdAt ?? null,
+        };
+        const exactIdentity = refund.id === binding.refundId &&
+            (refund.orderId === undefined || refund.orderId === intent.orderId) &&
+            (expectedCorrelationKey === undefined || carriesKey(refund, expectedCorrelationKey));
+        if (!exactIdentity) {
+            return {
+                verdict: "inconclusive",
+                observation,
+                errorKind: "schema",
+                message: "Shopify returned a refund that does not belong to this call",
+                retryable: false,
+            };
+        }
+        if (!refund.transactionsComplete) {
+            return {
+                verdict: "inconclusive",
+                observation,
+                errorKind: "provider",
+                message: "The refund has more transactions than one read returns",
+                retryable: false,
+            };
+        }
+        const unknownStatus = statuses.find((value) => !KNOWN.has(value));
+        if (unknownStatus !== undefined) {
+            return {
+                verdict: "inconclusive",
+                observation,
+                errorKind: "schema",
+                message: `Unknown Shopify transaction status: ${unknownStatus}`,
+                retryable: false,
+            };
+        }
+        if (amounts.some((amount) => amount === null)) {
+            return {
+                verdict: "inconclusive",
+                observation,
+                errorKind: "schema",
+                message: `Shopify reports the refund in a currency other than ${intent.currency}, or an amount that is not exact`,
+                retryable: false,
+            };
+        }
+        const evidence = (statusPassed, amountPassed) => ({
+            source: "shopify.refund.node",
+            observedAt: new Date().toISOString(),
+            fields: observation,
+            checks: [
+                {
+                    path: "/status",
+                    operator: "equals",
+                    expected: "succeeded",
+                    observed: status,
+                    passed: statusPassed,
+                },
+                {
+                    path: "/amountMinor",
+                    operator: "equals",
+                    expected: intent.amountMinor,
+                    observed: amountMinor,
+                    passed: amountPassed,
+                },
+            ],
+        });
+        if (status === "failed")
+            return {
+                verdict: "violated",
+                observation,
+                evidence: evidence(false, amountMinor === intent.amountMinor),
+                retryable: false,
+            };
+        if (status === "succeeded") {
+            const amountPassed = amountMinor === intent.amountMinor;
+            return {
+                verdict: amountPassed ? "satisfied" : "violated",
+                observation,
+                evidence: evidence(true, amountPassed),
+                retryable: false,
+            };
+        }
+        // No transaction yet, or one Shopify has not settled: look again until the deadline.
+        return {
+            verdict: "pending",
+            observation,
+            evidence: evidence(false, amountMinor === intent.amountMinor),
+            message: status === "no_transactions"
+                ? "Shopify recorded the refund but no refund transaction yet"
+                : `Shopify still reports ${statuses.join(", ")}`,
+            retryable: true,
+        };
+    }
+    catch (error) {
+        const shopifyError = error instanceof ShopifyReadError ? error : undefined;
+        return {
+            verdict: "inconclusive",
+            errorKind: shopifyError?.kind === "authentication"
+                ? "authentication"
+                : shopifyError?.kind === "authorization"
+                    ? "authorization"
+                    : shopifyError?.kind === "schema"
+                        ? "schema"
+                        : shopifyError?.kind === "retryable"
+                            ? "rate_limited"
+                            : "provider",
+            message: error instanceof Error ? error.message : String(error),
+            retryable: shopifyError ? shopifyError.kind === "retryable" : true,
+            ...(shopifyError?.retryAfterMs === undefined
+                ? {}
+                : { retryAfterMs: shopifyError.retryAfterMs }),
+        };
+    }
+}
+const REFUND_GID = /^gid:\/\/shopify\/Refund\/\d{1,20}$/u;
+function record(value) {
+    return value !== null && typeof value === "object"
+        ? value
+        : undefined;
+}
+/** The refundCreate payload, from the shapes an application commonly returns. */
+function refundCreatePayload(result) {
+    const top = record(result);
+    return record(record(top?.data)?.refundCreate) ?? record(top?.refundCreate) ?? top;
+}
+/** The refund's ID from what the application's call returned, or null when it did not say. */
+export function bindShopifyRefundResult(result) {
+    const payload = refundCreatePayload(result);
+    const id = record(payload?.refund)?.id ?? payload?.id;
+    return typeof id === "string" && REFUND_GID.test(id) ? { refundId: id, recovered: false } : null;
+}
+/**
+ * Use this only when application code can prove the request was rejected
+ * locally before any network dispatch. A generic TypeError or AbortError is not
+ * proof, because either can also occur after the request reached Shopify.
+ */
+export class ShopifyRefundNotDispatchedError extends Error {
+    code = "shopify_refund_not_dispatched";
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ShopifyRefundNotDispatchedError";
+    }
+}
+/**
+ * What an exception from the application's refundCreate call proves. Shopify
+ * answers a refusal it validated with userErrors and creates nothing, which is
+ * a definite rejection. Everything else may have happened, so it is ambiguous
+ * and the runner looks for the refund.
+ */
+export function classifyShopifyRefundException(error) {
+    if (error instanceof ShopifyRefundNotDispatchedError) {
+        return { certainty: "not_executed", ambiguous: false, retryable: false, reason: error.code };
+    }
+    const top = record(error);
+    if (top) {
+        const payload = refundCreatePayload(top.response ?? top.body ?? top);
+        const userErrors = payload?.userErrors ?? top.userErrors;
+        const refundId = record(payload?.refund)?.id;
+        if (Array.isArray(userErrors) && userErrors.length > 0 && refundId === undefined) {
+            return {
+                certainty: "rejected",
+                ambiguous: false,
+                retryable: false,
+                reason: "shopify_user_errors",
+            };
+        }
+        const status = Number(top.statusCode ?? top.status ?? record(top.response)?.status);
+        if (status === 401 || status === 403) {
+            return {
+                certainty: "rejected",
+                ambiguous: false,
+                retryable: false,
+                reason: `definite_auth_http_${status}`,
+            };
+        }
+        const graphqlErrors = record(top.body)?.errors ?? top.errors;
+        const codes = Array.isArray(graphqlErrors)
+            ? graphqlErrors.map((entry) => String(record(record(entry)?.extensions)?.code ?? ""))
+            : [];
+        const throttled = codes.includes("THROTTLED");
+        return {
+            certainty: "ambiguous",
+            ambiguous: true,
+            retryable: throttled || status === 429 || status >= 500,
+            reason: throttled
+                ? "ambiguous_throttled"
+                : codes.some((code) => code.startsWith("IDEMPOTENCY"))
+                    ? "ambiguous_idempotency"
+                    : Number.isFinite(status)
+                        ? `ambiguous_http_${status}`
+                        : "unknown_provider_error",
+        };
+    }
+    return {
+        certainty: "ambiguous",
+        ambiguous: true,
+        retryable: true,
+        reason: error instanceof Error ? error.name : "unknown_provider_error",
+    };
+}
+//# sourceMappingURL=refund.js.map

package/dist/refund.js.map

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