@curless/shopify-storefront 0.1.0

package/dist/config.js

@@ -0,0 +1,65 @@
+/**
+ * One storefront's identity, vocabulary and shop wiring.
+ *
+ * The single-tenant connector this grew out of held all of it as literals:
+ * 'Moody Lenses', 'https://moodycosmetics.com', `list_moody_lenses`. That reads
+ * fine until there is a second merchant, at which point the only way to add one
+ * is to copy 2,443 lines and rename 172 strings — and then fix every bug twice.
+ *
+ * What is NOT here is as deliberate as what is. The product model stays generic
+ * Shopify: no per-merchant fields, no category enums. The moment a merchant
+ * needs a bespoke field, it belongs in their Shopify metafields, not in this
+ * type.
+ */
+export const vocabulary = (config) => ({
+    merchant: config.server.title,
+    noun: config.naming?.noun ?? 'product',
+    nounPlural: config.naming?.nounPlural ?? `${config.naming?.noun ?? 'product'}s`,
+    hints: {
+        browse: config.hints?.browse ?? '',
+        product: config.hints?.product ?? '',
+        checkout: config.hints?.checkout ?? '',
+        example: config.hints?.example ?? '',
+    },
+});
+/**
+ * `prefix` and `noun` are woven into identifiers, so anything that is not
+ * `[a-z0-9_]` would produce a tool name a host may reject outright. Sanitised
+ * rather than rejected: a merchant called "Els-Pet" should not fail to boot
+ * over a hyphen.
+ */
+const slug = (s) => s
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '_')
+    .replace(/^_+|_+$/g, '');
+export const toolNames = (config) => {
+    const prefix = config.naming?.prefix ? slug(config.naming.prefix) : '';
+    const noun = slug(config.naming?.noun ?? 'product');
+    const plural = slug(config.naming?.nounPlural ?? `${noun}s`);
+    const p = prefix ? `${prefix}_` : '';
+    return {
+        list: `list_${p}${plural}`,
+        get: `get_${p}${noun}`,
+        checkout: `create_${p}checkout`,
+        lookupOrder: `lookup_${p}order`,
+    };
+};
+const bare = (u) => u.replace(/\/$/, '');
+export const resolveStorefront = (config) => {
+    const appUrl = bare(config.urls.appUrl);
+    return {
+        config,
+        tools: toolNames(config),
+        vocab: vocabulary(config),
+        appUrl,
+        publicUrl: bare(config.urls.publicUrl ?? appUrl),
+        // Fixed by the code, not the merchant: it is registered with Shopify as an
+        // allowed redirection URL, and a config that could drift from what was
+        // registered would fail only at install time, on someone else's screen.
+        redirectUri: `${appUrl}/auth/callback`,
+        scopes: config.shopify.scopes ?? 'read_products,read_orders,read_discounts',
+        tokenPath: config.shopify.tokenPath ?? `/app/data/${config.id}-token.json`,
+        cardUriPrefix: `ui://${config.id}/`,
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+GH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAwB,EAAc,EAAE,CAAC,CAAC;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,GAAG;IAC/E,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,EAAE;QAClC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE;QACpC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE;QACtC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE;KACrC;CACF,CAAC,CAAC;AAUH;;;;;GAKG;AACH,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CACjC,CAAC;KACE,WAAW,EAAE;KACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;KAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAE7B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAwB,EAAa,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,EAAE;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;QACtB,QAAQ,EAAE,UAAU,CAAC,UAAU;QAC/B,WAAW,EAAE,UAAU,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAezD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAsB,EAAE;IAChF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO;QACL,MAAM;QACN,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC;QACxB,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;QACzB,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAChD,2EAA2E;QAC3E,uEAAuE;QACvE,wEAAwE;QACxE,WAAW,EAAE,GAAG,MAAM,gBAAgB;QACtC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,0CAA0C;QAC3E,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,aAAa,MAAM,CAAC,EAAE,aAAa;QAC1E,aAAa,EAAE,QAAQ,MAAM,CAAC,EAAE,GAAG;KACpC,CAAC;AACJ,CAAC,CAAC"}

package/dist/connection.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shopify says 401 for a revoked or expired token and 403 for one whose scopes
+ * no longer cover the call. Both mean "these credentials are no longer good",
+ * which is the merchant's to fix. Anything else — 500, 429, a network blip — is
+ * ours, and sending them off to reauthorise over it is pointless work.
+ */
+export declare const credentialsRejected: (lastError: string | undefined) => boolean;
+/** No token at all, or one that is being refused. */
+export declare const needsAuth: (connected: boolean, lastError: string | undefined) => boolean;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,GAAG,SAAS,KAAG,OAC7B,CAAC;AAExC,qDAAqD;AACrD,eAAO,MAAM,SAAS,GAAI,WAAW,OAAO,EAAE,WAAW,MAAM,GAAG,SAAS,KAAG,OAChC,CAAC"}

package/dist/connection.js

@@ -0,0 +1,21 @@
+// Is this store connected, and does the merchant have to do something about it?
+//
+// Three states, not two — and conflating two of them locked a merchant out of
+// fixing the third. Reinstalling the app elsewhere REVOKES the access token we
+// hold; ours started answering 401, but "connected" was computed from "a token
+// file exists", so the status page kept saying Connected and the branch that
+// auto-starts OAuth kept skipping. They approved the app, came back, and were
+// told by the one page that could have helped that nothing was wrong.
+//
+// Its own module because `index.ts` starts a server on import, so nothing there
+// can be unit-tested — and this is exactly the logic that has to be.
+/**
+ * Shopify says 401 for a revoked or expired token and 403 for one whose scopes
+ * no longer cover the call. Both mean "these credentials are no longer good",
+ * which is the merchant's to fix. Anything else — 500, 429, a network blip — is
+ * ours, and sending them off to reauthorise over it is pointless work.
+ */
+export const credentialsRejected = (lastError) => /HTTP 40[13]\b/.test(lastError ?? '');
+/** No token at all, or one that is being refused. */
+export const needsAuth = (connected, lastError) => !connected || credentialsRejected(lastError);
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,sEAAsE;AACtE,EAAE;AACF,gFAAgF;AAChF,qEAAqE;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAA6B,EAAW,EAAE,CAC5E,eAAe,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;AAExC,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAkB,EAAE,SAA6B,EAAW,EAAE,CACtF,CAAC,SAAS,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}