@amboras-dev/engraving 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,169 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+
+type EngravingElementType = 'text' | 'monogram' | 'dropdown' | 'buttons' | 'swatch' | 'checkbox';
+interface EngravingOption {
+    value: string;
+    label?: string;
+    swatch?: string;
+}
+type EngravingConditionOperator = 'equals' | 'not_equals' | 'exists' | 'not_exists';
+interface EngravingConditionRule {
+    elementId: string;
+    operator?: EngravingConditionOperator;
+    value?: string;
+    /** @deprecated legacy shorthand — read as { operator: 'equals', value: equals } */
+    equals?: string;
+}
+interface EngravingConditions {
+    /** 'all' = AND across rules, 'any' = OR */
+    logic: 'all' | 'any';
+    rules: EngravingConditionRule[];
+}
+interface EngravingPreviewPlacement {
+    x: number;
+    y: number;
+    fontSize?: number;
+    fontFamily?: string;
+    letterSpacing?: number;
+    color?: string;
+    align?: 'left' | 'center' | 'right';
+    rotation?: number;
+    /** Curved/circular text: total arc angle in degrees. 0 = straight. */
+    curve?: number;
+}
+interface EngravingElement {
+    id: string;
+    type: EngravingElementType;
+    label: string;
+    placeholder?: string;
+    helpText?: string;
+    required?: boolean;
+    maxLength?: number;
+    options?: EngravingOption[];
+    conditions?: EngravingConditions;
+    preview?: EngravingPreviewPlacement;
+}
+interface EngravingTemplate {
+    id: string;
+    name: string;
+    status: 'active' | 'draft';
+    /** merchant-entered fee in the store's default currency, minor units */
+    default_fee?: number;
+    /** per-currency fee map (minor units) */
+    fee: Record<string, number>;
+    elements: EngravingElement[];
+    /**
+     * Customer-selectable font families (CSS values). When non-empty, the drawer
+     * shows a font picker and the chosen font overrides each text element's
+     * preview font. Empty/absent = no picker.
+     */
+    fonts?: string[];
+    background?: {
+        source: 'product_image' | 'custom';
+        url?: string;
+    };
+    /** preview coordinate space (element x/y are in these units); default 800x800 */
+    canvas?: {
+        width: number;
+        height: number;
+    };
+}
+interface EngravingConfig {
+    enabled: boolean;
+    templates: EngravingTemplate[];
+}
+interface EngravingVariant {
+    id: string;
+    title?: string;
+    calculated_price?: {
+        calculated_amount?: number;
+        currency_code?: string;
+    };
+}
+interface EngravingProduct {
+    id: string;
+    title?: string;
+    thumbnail?: string | null;
+    images?: Array<{
+        url: string;
+    }>;
+    metadata?: Record<string, unknown> | null;
+    variants?: EngravingVariant[];
+}
+/** Field values keyed by element id. */
+type EngravingFieldValues = Record<string, string>;
+interface AddEngravingInput {
+    variant_id: string;
+    quantity?: number;
+    template_id: string;
+    fields: EngravingFieldValues;
+    preview_url?: string;
+    /** Customer-chosen font (validated server-side against template.fonts). */
+    font?: string;
+}
+interface AddEngravingResult {
+    ok: boolean;
+    error?: string;
+}
+/** Resolved engraving context for a product (config + product + its template). */
+interface ResolvedEngraving {
+    template: EngravingTemplate;
+    product: EngravingProduct;
+}
+
+/**
+ * Resolves whether a product can be engraved: engraving must be enabled on the
+ * store AND the product must carry `metadata.engraving_template_id` pointing at
+ * an active template. Returns null when engraving shouldn't show for this
+ * product, so the storefront button can simply render nothing.
+ *
+ * @example
+ * const { data } = useEngraving(product.id)
+ * if (!data) return null
+ * // data.template, data.product
+ */
+declare function useEngraving(productId: string): _tanstack_react_query.UseQueryResult<ResolvedEngraving | null, Error>;
+
+/**
+ * Live engraving fee for a template in a given currency, resolved server-side
+ * from the store's locked FX rate (so it covers every supported currency and
+ * matches exactly what the add-to-cart route charges). Returns `undefined`
+ * while loading and `null` when the currency is unsupported.
+ *
+ * @example
+ * const { data: fee, isLoading } = useEngravingFee(template.id, cart.currency_code)
+ */
+declare function useEngravingFee(templateId: string, currency: string): _tanstack_react_query.UseQueryResult<number | null, Error>;
+
+/** Public store headers — publishable key + (optional) multi-tenant env id. */
+declare function storeHeaders(extra?: Record<string, string>): Record<string, string>;
+/** Reads store.metadata.plugins.engraving via the public integrations endpoint. */
+declare function fetchEngravingConfig(): Promise<EngravingConfig | null>;
+/** First region id — used for pricing context when no cart region is known yet. */
+declare function fetchRegionId(): Promise<string | null>;
+/** Product with metadata, images and per-variant calculated price in a region. */
+declare function fetchEngravingProduct(productId: string, regionId: string): Promise<EngravingProduct | null>;
+/**
+ * Live per-currency fee, resolved server-side from the store's locked FX rate.
+ * Covers every currency the store supports — not just the ones in the template's
+ * stored fee map (which can go stale when a currency is added later). Returns
+ * null when the currency is genuinely unsupported.
+ */
+declare function fetchEngravingFee(templateId: string, currency: string): Promise<number | null>;
+/**
+ * Add an engraved line to a cart. The server reprices the line to base + the
+ * per-currency engraving fee and snapshots the selection on the line metadata.
+ */
+declare function addEngravingLine(cartId: string, input: AddEngravingInput): Promise<AddEngravingResult>;
+
+/**
+ * Conditional show/hide for an engraving field — mirrors the admin builder and
+ * the Medusa server-side validation so the storefront, preview and server agree.
+ */
+declare function isElementVisible(el: EngravingElement, values: EngravingFieldValues): boolean;
+/** Format a minor-unit amount as currency (e.g. 1000, 'sgd' → "SGD 10.00"). */
+declare function formatMoney(amountCents: number, currency: string): string;
+declare function variantPrice(v?: EngravingVariant): number | undefined;
+declare function variantCurrency(v?: EngravingVariant): string;
+
+export { type AddEngravingInput, type AddEngravingResult, type EngravingConditionOperator, type EngravingConditionRule, type EngravingConditions, type EngravingConfig, type EngravingElement, type EngravingElementType, type EngravingFieldValues, type EngravingOption, type EngravingPreviewPlacement, type EngravingProduct, type EngravingTemplate, type EngravingVariant, type ResolvedEngraving, addEngravingLine, fetchEngravingConfig, fetchEngravingFee, fetchEngravingProduct, fetchRegionId, formatMoney, isElementVisible, storeHeaders, useEngraving, useEngravingFee, variantCurrency, variantPrice };

package/dist/index.d.ts

@@ -0,0 +1,169 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+
+type EngravingElementType = 'text' | 'monogram' | 'dropdown' | 'buttons' | 'swatch' | 'checkbox';
+interface EngravingOption {
+    value: string;
+    label?: string;
+    swatch?: string;
+}
+type EngravingConditionOperator = 'equals' | 'not_equals' | 'exists' | 'not_exists';
+interface EngravingConditionRule {
+    elementId: string;
+    operator?: EngravingConditionOperator;
+    value?: string;
+    /** @deprecated legacy shorthand — read as { operator: 'equals', value: equals } */
+    equals?: string;
+}
+interface EngravingConditions {
+    /** 'all' = AND across rules, 'any' = OR */
+    logic: 'all' | 'any';
+    rules: EngravingConditionRule[];
+}
+interface EngravingPreviewPlacement {
+    x: number;
+    y: number;
+    fontSize?: number;
+    fontFamily?: string;
+    letterSpacing?: number;
+    color?: string;
+    align?: 'left' | 'center' | 'right';
+    rotation?: number;
+    /** Curved/circular text: total arc angle in degrees. 0 = straight. */
+    curve?: number;
+}
+interface EngravingElement {
+    id: string;
+    type: EngravingElementType;
+    label: string;
+    placeholder?: string;
+    helpText?: string;
+    required?: boolean;
+    maxLength?: number;
+    options?: EngravingOption[];
+    conditions?: EngravingConditions;
+    preview?: EngravingPreviewPlacement;
+}
+interface EngravingTemplate {
+    id: string;
+    name: string;
+    status: 'active' | 'draft';
+    /** merchant-entered fee in the store's default currency, minor units */
+    default_fee?: number;
+    /** per-currency fee map (minor units) */
+    fee: Record<string, number>;
+    elements: EngravingElement[];
+    /**
+     * Customer-selectable font families (CSS values). When non-empty, the drawer
+     * shows a font picker and the chosen font overrides each text element's
+     * preview font. Empty/absent = no picker.
+     */
+    fonts?: string[];
+    background?: {
+        source: 'product_image' | 'custom';
+        url?: string;
+    };
+    /** preview coordinate space (element x/y are in these units); default 800x800 */
+    canvas?: {
+        width: number;
+        height: number;
+    };
+}
+interface EngravingConfig {
+    enabled: boolean;
+    templates: EngravingTemplate[];
+}
+interface EngravingVariant {
+    id: string;
+    title?: string;
+    calculated_price?: {
+        calculated_amount?: number;
+        currency_code?: string;
+    };
+}
+interface EngravingProduct {
+    id: string;
+    title?: string;
+    thumbnail?: string | null;
+    images?: Array<{
+        url: string;
+    }>;
+    metadata?: Record<string, unknown> | null;
+    variants?: EngravingVariant[];
+}
+/** Field values keyed by element id. */
+type EngravingFieldValues = Record<string, string>;
+interface AddEngravingInput {
+    variant_id: string;
+    quantity?: number;
+    template_id: string;
+    fields: EngravingFieldValues;
+    preview_url?: string;
+    /** Customer-chosen font (validated server-side against template.fonts). */
+    font?: string;
+}
+interface AddEngravingResult {
+    ok: boolean;
+    error?: string;
+}
+/** Resolved engraving context for a product (config + product + its template). */
+interface ResolvedEngraving {
+    template: EngravingTemplate;
+    product: EngravingProduct;
+}
+
+/**
+ * Resolves whether a product can be engraved: engraving must be enabled on the
+ * store AND the product must carry `metadata.engraving_template_id` pointing at
+ * an active template. Returns null when engraving shouldn't show for this
+ * product, so the storefront button can simply render nothing.
+ *
+ * @example
+ * const { data } = useEngraving(product.id)
+ * if (!data) return null
+ * // data.template, data.product
+ */
+declare function useEngraving(productId: string): _tanstack_react_query.UseQueryResult<ResolvedEngraving | null, Error>;
+
+/**
+ * Live engraving fee for a template in a given currency, resolved server-side
+ * from the store's locked FX rate (so it covers every supported currency and
+ * matches exactly what the add-to-cart route charges). Returns `undefined`
+ * while loading and `null` when the currency is unsupported.
+ *
+ * @example
+ * const { data: fee, isLoading } = useEngravingFee(template.id, cart.currency_code)
+ */
+declare function useEngravingFee(templateId: string, currency: string): _tanstack_react_query.UseQueryResult<number | null, Error>;
+
+/** Public store headers — publishable key + (optional) multi-tenant env id. */
+declare function storeHeaders(extra?: Record<string, string>): Record<string, string>;
+/** Reads store.metadata.plugins.engraving via the public integrations endpoint. */
+declare function fetchEngravingConfig(): Promise<EngravingConfig | null>;
+/** First region id — used for pricing context when no cart region is known yet. */
+declare function fetchRegionId(): Promise<string | null>;
+/** Product with metadata, images and per-variant calculated price in a region. */
+declare function fetchEngravingProduct(productId: string, regionId: string): Promise<EngravingProduct | null>;
+/**
+ * Live per-currency fee, resolved server-side from the store's locked FX rate.
+ * Covers every currency the store supports — not just the ones in the template's
+ * stored fee map (which can go stale when a currency is added later). Returns
+ * null when the currency is genuinely unsupported.
+ */
+declare function fetchEngravingFee(templateId: string, currency: string): Promise<number | null>;
+/**
+ * Add an engraved line to a cart. The server reprices the line to base + the
+ * per-currency engraving fee and snapshots the selection on the line metadata.
+ */
+declare function addEngravingLine(cartId: string, input: AddEngravingInput): Promise<AddEngravingResult>;
+
+/**
+ * Conditional show/hide for an engraving field — mirrors the admin builder and
+ * the Medusa server-side validation so the storefront, preview and server agree.
+ */
+declare function isElementVisible(el: EngravingElement, values: EngravingFieldValues): boolean;
+/** Format a minor-unit amount as currency (e.g. 1000, 'sgd' → "SGD 10.00"). */
+declare function formatMoney(amountCents: number, currency: string): string;
+declare function variantPrice(v?: EngravingVariant): number | undefined;
+declare function variantCurrency(v?: EngravingVariant): string;
+
+export { type AddEngravingInput, type AddEngravingResult, type EngravingConditionOperator, type EngravingConditionRule, type EngravingConditions, type EngravingConfig, type EngravingElement, type EngravingElementType, type EngravingFieldValues, type EngravingOption, type EngravingPreviewPlacement, type EngravingProduct, type EngravingTemplate, type EngravingVariant, type ResolvedEngraving, addEngravingLine, fetchEngravingConfig, fetchEngravingFee, fetchEngravingProduct, fetchRegionId, formatMoney, isElementVisible, storeHeaders, useEngraving, useEngravingFee, variantCurrency, variantPrice };

package/dist/index.js

@@ -0,0 +1,205 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  addEngravingLine: () => addEngravingLine,
+  fetchEngravingConfig: () => fetchEngravingConfig,
+  fetchEngravingFee: () => fetchEngravingFee,
+  fetchEngravingProduct: () => fetchEngravingProduct,
+  fetchRegionId: () => fetchRegionId,
+  formatMoney: () => formatMoney,
+  isElementVisible: () => isElementVisible,
+  storeHeaders: () => storeHeaders,
+  useEngraving: () => useEngraving,
+  useEngravingFee: () => useEngravingFee,
+  variantCurrency: () => variantCurrency,
+  variantPrice: () => variantPrice
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/hooks/use-engraving.ts
+var import_react_query = require("@tanstack/react-query");
+
+// src/lib/fetch.ts
+function resolveEnv(key) {
+  if (key === "NEXT_PUBLIC_MEDUSA_BACKEND_URL") return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL;
+  if (key === "NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY") return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY;
+  if (key === "NEXT_PUBLIC_STORE_ID") return process.env.NEXT_PUBLIC_STORE_ID;
+  return void 0;
+}
+function baseUrl() {
+  return resolveEnv("NEXT_PUBLIC_MEDUSA_BACKEND_URL") ?? "http://localhost:9000";
+}
+function storeHeaders(extra) {
+  const headers = { ...extra ?? {} };
+  const key = resolveEnv("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY");
+  const storeId = resolveEnv("NEXT_PUBLIC_STORE_ID");
+  if (key) headers["x-publishable-api-key"] = key;
+  if (storeId) headers["x-store-environment-id"] = storeId;
+  return headers;
+}
+async function fetchEngravingConfig() {
+  try {
+    const res = await fetch(`${baseUrl()}/store/integrations/active`, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data && data.engraving || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchRegionId() {
+  try {
+    const res = await fetch(`${baseUrl()}/store/regions`, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.regions && data.regions[0] && data.regions[0].id || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchEngravingProduct(productId, regionId) {
+  try {
+    const fields = "id,title,thumbnail,metadata,*images,*variants,*variants.calculated_price";
+    const url = `${baseUrl()}/store/products/${productId}?region_id=${encodeURIComponent(regionId)}&fields=${encodeURIComponent(fields)}`;
+    const res = await fetch(url, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.product || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchEngravingFee(templateId, currency) {
+  try {
+    const url = `${baseUrl()}/store/engraving/fee?template_id=${encodeURIComponent(templateId)}&currency=${encodeURIComponent(currency)}`;
+    const res = await fetch(url, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data.fee === "number" ? data.fee : null;
+  } catch {
+    return null;
+  }
+}
+async function addEngravingLine(cartId, input) {
+  try {
+    const res = await fetch(`${baseUrl()}/store/carts/${cartId}/line-items-engraving`, {
+      method: "POST",
+      headers: storeHeaders({ "Content-Type": "application/json" }),
+      body: JSON.stringify(input)
+    });
+    if (res.ok) return { ok: true };
+    const data = await res.json().catch(() => ({}));
+    const error = data.errors && data.errors.join("; ") || data.error || data.message || `Could not add engraving (${res.status})`;
+    return { ok: false, error };
+  } catch (e) {
+    return { ok: false, error: e instanceof Error ? e.message : "Network error" };
+  }
+}
+
+// src/hooks/use-engraving.ts
+function useEngraving(productId) {
+  return (0, import_react_query.useQuery)({
+    queryKey: ["engraving-pdp", productId],
+    queryFn: async () => {
+      const config = await fetchEngravingConfig();
+      if (!config || !config.enabled) return null;
+      const regionId = await fetchRegionId();
+      if (!regionId) return null;
+      const product = await fetchEngravingProduct(productId, regionId);
+      if (!product) return null;
+      const templateId = product.metadata && product.metadata.engraving_template_id;
+      if (!templateId) return null;
+      const template = (config.templates || []).find(
+        (t) => t.id === templateId && t.status === "active"
+      );
+      if (!template) return null;
+      return { template, product };
+    },
+    staleTime: 1e3 * 60,
+    // 1 minute
+    enabled: !!productId
+  });
+}
+
+// src/hooks/use-engraving-fee.ts
+var import_react_query2 = require("@tanstack/react-query");
+function useEngravingFee(templateId, currency) {
+  return (0, import_react_query2.useQuery)({
+    queryKey: ["engraving-fee", templateId, currency],
+    queryFn: () => fetchEngravingFee(templateId, currency),
+    enabled: !!templateId && !!currency,
+    staleTime: 1e3 * 60
+  });
+}
+
+// src/lib/utils.ts
+function hasValue(v) {
+  const s = String(v == null ? "" : v).trim();
+  return s.length > 0 && s !== "false";
+}
+function isElementVisible(el, values) {
+  const rules = el.conditions && el.conditions.rules;
+  if (!rules || rules.length === 0) return true;
+  const logic = el.conditions && el.conditions.logic || "all";
+  const checks = rules.map((r) => {
+    const actual = values[r.elementId] || "";
+    const operator = r.operator || "equals";
+    const expected = r.value != null ? r.value : r.equals != null ? r.equals : "";
+    if (operator === "exists") return hasValue(actual);
+    if (operator === "not_exists") return !hasValue(actual);
+    if (operator === "not_equals") return actual !== expected;
+    return actual === expected;
+  });
+  return logic === "any" ? checks.some(Boolean) : checks.every(Boolean);
+}
+function formatMoney(amountCents, currency) {
+  try {
+    return new Intl.NumberFormat(void 0, {
+      style: "currency",
+      currency: (currency || "usd").toUpperCase()
+    }).format((amountCents || 0) / 100);
+  } catch {
+    return ((amountCents || 0) / 100).toFixed(2);
+  }
+}
+function variantPrice(v) {
+  return v && v.calculated_price ? v.calculated_price.calculated_amount : void 0;
+}
+function variantCurrency(v) {
+  return v && v.calculated_price && v.calculated_price.currency_code || "usd";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addEngravingLine,
+  fetchEngravingConfig,
+  fetchEngravingFee,
+  fetchEngravingProduct,
+  fetchRegionId,
+  formatMoney,
+  isElementVisible,
+  storeHeaders,
+  useEngraving,
+  useEngravingFee,
+  variantCurrency,
+  variantPrice
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/hooks/use-engraving.ts","../src/lib/fetch.ts","../src/hooks/use-engraving-fee.ts","../src/lib/utils.ts"],"sourcesContent":["// Storefront hooks\nexport { useEngraving } from './hooks/use-engraving'\nexport { useEngravingFee } from './hooks/use-engraving-fee'\n\n// Data helpers\nexport {\n  fetchEngravingConfig,\n  fetchRegionId,\n  fetchEngravingProduct,\n  fetchEngravingFee,\n  addEngravingLine,\n  storeHeaders,\n} from './lib/fetch'\n\n// Pure helpers\nexport { isElementVisible, formatMoney, variantPrice, variantCurrency } from './lib/utils'\n\n// Types\nexport type {\n  EngravingElementType,\n  EngravingOption,\n  EngravingConditionOperator,\n  EngravingConditionRule,\n  EngravingConditions,\n  EngravingPreviewPlacement,\n  EngravingElement,\n  EngravingTemplate,\n  EngravingConfig,\n  EngravingVariant,\n  EngravingProduct,\n  EngravingFieldValues,\n  AddEngravingInput,\n  AddEngravingResult,\n  ResolvedEngraving,\n} from './types'\n","'use client'\n\nimport { useQuery } from '@tanstack/react-query'\nimport { fetchEngravingConfig, fetchRegionId, fetchEngravingProduct } from '../lib/fetch'\nimport type { ResolvedEngraving } from '../types'\n\n/**\n * Resolves whether a product can be engraved: engraving must be enabled on the\n * store AND the product must carry `metadata.engraving_template_id` pointing at\n * an active template. Returns null when engraving shouldn't show for this\n * product, so the storefront button can simply render nothing.\n *\n * @example\n * const { data } = useEngraving(product.id)\n * if (!data) return null\n * // data.template, data.product\n */\nexport function useEngraving(productId: string) {\n  return useQuery<ResolvedEngraving | null>({\n    queryKey: ['engraving-pdp', productId],\n    queryFn: async () => {\n      const config = await fetchEngravingConfig()\n      if (!config || !config.enabled) return null\n      const regionId = await fetchRegionId()\n      if (!regionId) return null\n      const product = await fetchEngravingProduct(productId, regionId)\n      if (!product) return null\n      const templateId =\n        product.metadata && (product.metadata.engraving_template_id as string | undefined)\n      if (!templateId) return null\n      const template = (config.templates || []).find(\n        (t) => t.id === templateId && t.status === 'active',\n      )\n      if (!template) return null\n      return { template, product }\n    },\n    staleTime: 1000 * 60, // 1 minute\n    enabled: !!productId,\n  })\n}\n","'use client'\n\nimport type {\n  AddEngravingInput,\n  AddEngravingResult,\n  EngravingConfig,\n  EngravingProduct,\n} from '../types'\n\nfunction resolveEnv(key: string): string | undefined {\n  if (key === 'NEXT_PUBLIC_MEDUSA_BACKEND_URL') return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL\n  if (key === 'NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY') return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY\n  if (key === 'NEXT_PUBLIC_STORE_ID') return process.env.NEXT_PUBLIC_STORE_ID\n  return undefined\n}\n\nfunction baseUrl(): string {\n  return resolveEnv('NEXT_PUBLIC_MEDUSA_BACKEND_URL') ?? 'http://localhost:9000'\n}\n\n/** Public store headers — publishable key + (optional) multi-tenant env id. */\nexport function storeHeaders(extra?: Record<string, string>): Record<string, string> {\n  const headers: Record<string, string> = { ...(extra ?? {}) }\n  const key = resolveEnv('NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY')\n  const storeId = resolveEnv('NEXT_PUBLIC_STORE_ID')\n  if (key) headers['x-publishable-api-key'] = key\n  if (storeId) headers['x-store-environment-id'] = storeId\n  return headers\n}\n\n/** Reads store.metadata.plugins.engraving via the public integrations endpoint. */\nexport async function fetchEngravingConfig(): Promise<EngravingConfig | null> {\n  try {\n    const res = await fetch(`${baseUrl()}/store/integrations/active`, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as Record<string, unknown>\n    return (data && (data.engraving as EngravingConfig)) || null\n  } catch {\n    return null\n  }\n}\n\n/** First region id — used for pricing context when no cart region is known yet. */\nexport async function fetchRegionId(): Promise<string | null> {\n  try {\n    const res = await fetch(`${baseUrl()}/store/regions`, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as { regions?: Array<{ id: string }> }\n    return (data.regions && data.regions[0] && data.regions[0].id) || null\n  } catch {\n    return null\n  }\n}\n\n/** Product with metadata, images and per-variant calculated price in a region. */\nexport async function fetchEngravingProduct(\n  productId: string,\n  regionId: string,\n): Promise<EngravingProduct | null> {\n  try {\n    const fields = 'id,title,thumbnail,metadata,*images,*variants,*variants.calculated_price'\n    const url =\n      `${baseUrl()}/store/products/${productId}` +\n      `?region_id=${encodeURIComponent(regionId)}&fields=${encodeURIComponent(fields)}`\n    const res = await fetch(url, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as { product?: EngravingProduct }\n    return data.product || null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Live per-currency fee, resolved server-side from the store's locked FX rate.\n * Covers every currency the store supports — not just the ones in the template's\n * stored fee map (which can go stale when a currency is added later). Returns\n * null when the currency is genuinely unsupported.\n */\nexport async function fetchEngravingFee(\n  templateId: string,\n  currency: string,\n): Promise<number | null> {\n  try {\n    const url =\n      `${baseUrl()}/store/engraving/fee` +\n      `?template_id=${encodeURIComponent(templateId)}&currency=${encodeURIComponent(currency)}`\n    const res = await fetch(url, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as { fee?: number | null }\n    return typeof data.fee === 'number' ? data.fee : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Add an engraved line to a cart. The server reprices the line to base + the\n * per-currency engraving fee and snapshots the selection on the line metadata.\n */\nexport async function addEngravingLine(\n  cartId: string,\n  input: AddEngravingInput,\n): Promise<AddEngravingResult> {\n  try {\n    const res = await fetch(`${baseUrl()}/store/carts/${cartId}/line-items-engraving`, {\n      method: 'POST',\n      headers: storeHeaders({ 'Content-Type': 'application/json' }),\n      body: JSON.stringify(input),\n    })\n    if (res.ok) return { ok: true }\n    const data = (await res.json().catch(() => ({}))) as { message?: string; error?: string; errors?: string[] }\n    const error =\n      (data.errors && data.errors.join('; ')) ||\n      data.error ||\n      data.message ||\n      `Could not add engraving (${res.status})`\n    return { ok: false, error }\n  } catch (e) {\n    return { ok: false, error: e instanceof Error ? e.message : 'Network error' }\n  }\n}\n","'use client'\n\nimport { useQuery } from '@tanstack/react-query'\nimport { fetchEngravingFee } from '../lib/fetch'\n\n/**\n * Live engraving fee for a template in a given currency, resolved server-side\n * from the store's locked FX rate (so it covers every supported currency and\n * matches exactly what the add-to-cart route charges). Returns `undefined`\n * while loading and `null` when the currency is unsupported.\n *\n * @example\n * const { data: fee, isLoading } = useEngravingFee(template.id, cart.currency_code)\n */\nexport function useEngravingFee(templateId: string, currency: string) {\n  return useQuery<number | null>({\n    queryKey: ['engraving-fee', templateId, currency],\n    queryFn: () => fetchEngravingFee(templateId, currency),\n    enabled: !!templateId && !!currency,\n    staleTime: 1000 * 60,\n  })\n}\n","import type { EngravingElement, EngravingFieldValues, EngravingVariant } from '../types'\n\nfunction hasValue(v: string | undefined): boolean {\n  const s = String(v == null ? '' : v).trim()\n  return s.length > 0 && s !== 'false'\n}\n\n/**\n * Conditional show/hide for an engraving field — mirrors the admin builder and\n * the Medusa server-side validation so the storefront, preview and server agree.\n */\nexport function isElementVisible(\n  el: EngravingElement,\n  values: EngravingFieldValues,\n): boolean {\n  const rules = el.conditions && el.conditions.rules\n  if (!rules || rules.length === 0) return true\n  const logic = (el.conditions && el.conditions.logic) || 'all'\n  const checks = rules.map((r) => {\n    const actual = values[r.elementId] || ''\n    const operator = r.operator || 'equals'\n    const expected = r.value != null ? r.value : r.equals != null ? r.equals : ''\n    if (operator === 'exists') return hasValue(actual)\n    if (operator === 'not_exists') return !hasValue(actual)\n    if (operator === 'not_equals') return actual !== expected\n    return actual === expected\n  })\n  return logic === 'any' ? checks.some(Boolean) : checks.every(Boolean)\n}\n\n/** Format a minor-unit amount as currency (e.g. 1000, 'sgd' → \"SGD 10.00\"). */\nexport function formatMoney(amountCents: number, currency: string): string {\n  try {\n    return new Intl.NumberFormat(undefined, {\n      style: 'currency',\n      currency: (currency || 'usd').toUpperCase(),\n    }).format((amountCents || 0) / 100)\n  } catch {\n    return ((amountCents || 0) / 100).toFixed(2)\n  }\n}\n\nexport function variantPrice(v?: EngravingVariant): number | undefined {\n  return v && v.calculated_price ? v.calculated_price.calculated_amount : undefined\n}\n\nexport function variantCurrency(v?: EngravingVariant): string {\n  return (v && v.calculated_price && v.calculated_price.currency_code) || 'usd'\n}\n"],"mappings":"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","names":["import_react_query"]}

package/dist/index.mjs

@@ -0,0 +1,167 @@
+// src/hooks/use-engraving.ts
+import { useQuery } from "@tanstack/react-query";
+
+// src/lib/fetch.ts
+function resolveEnv(key) {
+  if (key === "NEXT_PUBLIC_MEDUSA_BACKEND_URL") return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL;
+  if (key === "NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY") return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY;
+  if (key === "NEXT_PUBLIC_STORE_ID") return process.env.NEXT_PUBLIC_STORE_ID;
+  return void 0;
+}
+function baseUrl() {
+  return resolveEnv("NEXT_PUBLIC_MEDUSA_BACKEND_URL") ?? "http://localhost:9000";
+}
+function storeHeaders(extra) {
+  const headers = { ...extra ?? {} };
+  const key = resolveEnv("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY");
+  const storeId = resolveEnv("NEXT_PUBLIC_STORE_ID");
+  if (key) headers["x-publishable-api-key"] = key;
+  if (storeId) headers["x-store-environment-id"] = storeId;
+  return headers;
+}
+async function fetchEngravingConfig() {
+  try {
+    const res = await fetch(`${baseUrl()}/store/integrations/active`, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data && data.engraving || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchRegionId() {
+  try {
+    const res = await fetch(`${baseUrl()}/store/regions`, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.regions && data.regions[0] && data.regions[0].id || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchEngravingProduct(productId, regionId) {
+  try {
+    const fields = "id,title,thumbnail,metadata,*images,*variants,*variants.calculated_price";
+    const url = `${baseUrl()}/store/products/${productId}?region_id=${encodeURIComponent(regionId)}&fields=${encodeURIComponent(fields)}`;
+    const res = await fetch(url, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.product || null;
+  } catch {
+    return null;
+  }
+}
+async function fetchEngravingFee(templateId, currency) {
+  try {
+    const url = `${baseUrl()}/store/engraving/fee?template_id=${encodeURIComponent(templateId)}&currency=${encodeURIComponent(currency)}`;
+    const res = await fetch(url, { headers: storeHeaders() });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data.fee === "number" ? data.fee : null;
+  } catch {
+    return null;
+  }
+}
+async function addEngravingLine(cartId, input) {
+  try {
+    const res = await fetch(`${baseUrl()}/store/carts/${cartId}/line-items-engraving`, {
+      method: "POST",
+      headers: storeHeaders({ "Content-Type": "application/json" }),
+      body: JSON.stringify(input)
+    });
+    if (res.ok) return { ok: true };
+    const data = await res.json().catch(() => ({}));
+    const error = data.errors && data.errors.join("; ") || data.error || data.message || `Could not add engraving (${res.status})`;
+    return { ok: false, error };
+  } catch (e) {
+    return { ok: false, error: e instanceof Error ? e.message : "Network error" };
+  }
+}
+
+// src/hooks/use-engraving.ts
+function useEngraving(productId) {
+  return useQuery({
+    queryKey: ["engraving-pdp", productId],
+    queryFn: async () => {
+      const config = await fetchEngravingConfig();
+      if (!config || !config.enabled) return null;
+      const regionId = await fetchRegionId();
+      if (!regionId) return null;
+      const product = await fetchEngravingProduct(productId, regionId);
+      if (!product) return null;
+      const templateId = product.metadata && product.metadata.engraving_template_id;
+      if (!templateId) return null;
+      const template = (config.templates || []).find(
+        (t) => t.id === templateId && t.status === "active"
+      );
+      if (!template) return null;
+      return { template, product };
+    },
+    staleTime: 1e3 * 60,
+    // 1 minute
+    enabled: !!productId
+  });
+}
+
+// src/hooks/use-engraving-fee.ts
+import { useQuery as useQuery2 } from "@tanstack/react-query";
+function useEngravingFee(templateId, currency) {
+  return useQuery2({
+    queryKey: ["engraving-fee", templateId, currency],
+    queryFn: () => fetchEngravingFee(templateId, currency),
+    enabled: !!templateId && !!currency,
+    staleTime: 1e3 * 60
+  });
+}
+
+// src/lib/utils.ts
+function hasValue(v) {
+  const s = String(v == null ? "" : v).trim();
+  return s.length > 0 && s !== "false";
+}
+function isElementVisible(el, values) {
+  const rules = el.conditions && el.conditions.rules;
+  if (!rules || rules.length === 0) return true;
+  const logic = el.conditions && el.conditions.logic || "all";
+  const checks = rules.map((r) => {
+    const actual = values[r.elementId] || "";
+    const operator = r.operator || "equals";
+    const expected = r.value != null ? r.value : r.equals != null ? r.equals : "";
+    if (operator === "exists") return hasValue(actual);
+    if (operator === "not_exists") return !hasValue(actual);
+    if (operator === "not_equals") return actual !== expected;
+    return actual === expected;
+  });
+  return logic === "any" ? checks.some(Boolean) : checks.every(Boolean);
+}
+function formatMoney(amountCents, currency) {
+  try {
+    return new Intl.NumberFormat(void 0, {
+      style: "currency",
+      currency: (currency || "usd").toUpperCase()
+    }).format((amountCents || 0) / 100);
+  } catch {
+    return ((amountCents || 0) / 100).toFixed(2);
+  }
+}
+function variantPrice(v) {
+  return v && v.calculated_price ? v.calculated_price.calculated_amount : void 0;
+}
+function variantCurrency(v) {
+  return v && v.calculated_price && v.calculated_price.currency_code || "usd";
+}
+export {
+  addEngravingLine,
+  fetchEngravingConfig,
+  fetchEngravingFee,
+  fetchEngravingProduct,
+  fetchRegionId,
+  formatMoney,
+  isElementVisible,
+  storeHeaders,
+  useEngraving,
+  useEngravingFee,
+  variantCurrency,
+  variantPrice
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/use-engraving.ts","../src/lib/fetch.ts","../src/hooks/use-engraving-fee.ts","../src/lib/utils.ts"],"sourcesContent":["'use client'\n\nimport { useQuery } from '@tanstack/react-query'\nimport { fetchEngravingConfig, fetchRegionId, fetchEngravingProduct } from '../lib/fetch'\nimport type { ResolvedEngraving } from '../types'\n\n/**\n * Resolves whether a product can be engraved: engraving must be enabled on the\n * store AND the product must carry `metadata.engraving_template_id` pointing at\n * an active template. Returns null when engraving shouldn't show for this\n * product, so the storefront button can simply render nothing.\n *\n * @example\n * const { data } = useEngraving(product.id)\n * if (!data) return null\n * // data.template, data.product\n */\nexport function useEngraving(productId: string) {\n  return useQuery<ResolvedEngraving | null>({\n    queryKey: ['engraving-pdp', productId],\n    queryFn: async () => {\n      const config = await fetchEngravingConfig()\n      if (!config || !config.enabled) return null\n      const regionId = await fetchRegionId()\n      if (!regionId) return null\n      const product = await fetchEngravingProduct(productId, regionId)\n      if (!product) return null\n      const templateId =\n        product.metadata && (product.metadata.engraving_template_id as string | undefined)\n      if (!templateId) return null\n      const template = (config.templates || []).find(\n        (t) => t.id === templateId && t.status === 'active',\n      )\n      if (!template) return null\n      return { template, product }\n    },\n    staleTime: 1000 * 60, // 1 minute\n    enabled: !!productId,\n  })\n}\n","'use client'\n\nimport type {\n  AddEngravingInput,\n  AddEngravingResult,\n  EngravingConfig,\n  EngravingProduct,\n} from '../types'\n\nfunction resolveEnv(key: string): string | undefined {\n  if (key === 'NEXT_PUBLIC_MEDUSA_BACKEND_URL') return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL\n  if (key === 'NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY') return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY\n  if (key === 'NEXT_PUBLIC_STORE_ID') return process.env.NEXT_PUBLIC_STORE_ID\n  return undefined\n}\n\nfunction baseUrl(): string {\n  return resolveEnv('NEXT_PUBLIC_MEDUSA_BACKEND_URL') ?? 'http://localhost:9000'\n}\n\n/** Public store headers — publishable key + (optional) multi-tenant env id. */\nexport function storeHeaders(extra?: Record<string, string>): Record<string, string> {\n  const headers: Record<string, string> = { ...(extra ?? {}) }\n  const key = resolveEnv('NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY')\n  const storeId = resolveEnv('NEXT_PUBLIC_STORE_ID')\n  if (key) headers['x-publishable-api-key'] = key\n  if (storeId) headers['x-store-environment-id'] = storeId\n  return headers\n}\n\n/** Reads store.metadata.plugins.engraving via the public integrations endpoint. */\nexport async function fetchEngravingConfig(): Promise<EngravingConfig | null> {\n  try {\n    const res = await fetch(`${baseUrl()}/store/integrations/active`, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as Record<string, unknown>\n    return (data && (data.engraving as EngravingConfig)) || null\n  } catch {\n    return null\n  }\n}\n\n/** First region id — used for pricing context when no cart region is known yet. */\nexport async function fetchRegionId(): Promise<string | null> {\n  try {\n    const res = await fetch(`${baseUrl()}/store/regions`, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as { regions?: Array<{ id: string }> }\n    return (data.regions && data.regions[0] && data.regions[0].id) || null\n  } catch {\n    return null\n  }\n}\n\n/** Product with metadata, images and per-variant calculated price in a region. */\nexport async function fetchEngravingProduct(\n  productId: string,\n  regionId: string,\n): Promise<EngravingProduct | null> {\n  try {\n    const fields = 'id,title,thumbnail,metadata,*images,*variants,*variants.calculated_price'\n    const url =\n      `${baseUrl()}/store/products/${productId}` +\n      `?region_id=${encodeURIComponent(regionId)}&fields=${encodeURIComponent(fields)}`\n    const res = await fetch(url, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as { product?: EngravingProduct }\n    return data.product || null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Live per-currency fee, resolved server-side from the store's locked FX rate.\n * Covers every currency the store supports — not just the ones in the template's\n * stored fee map (which can go stale when a currency is added later). Returns\n * null when the currency is genuinely unsupported.\n */\nexport async function fetchEngravingFee(\n  templateId: string,\n  currency: string,\n): Promise<number | null> {\n  try {\n    const url =\n      `${baseUrl()}/store/engraving/fee` +\n      `?template_id=${encodeURIComponent(templateId)}&currency=${encodeURIComponent(currency)}`\n    const res = await fetch(url, { headers: storeHeaders() })\n    if (!res.ok) return null\n    const data = (await res.json()) as { fee?: number | null }\n    return typeof data.fee === 'number' ? data.fee : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Add an engraved line to a cart. The server reprices the line to base + the\n * per-currency engraving fee and snapshots the selection on the line metadata.\n */\nexport async function addEngravingLine(\n  cartId: string,\n  input: AddEngravingInput,\n): Promise<AddEngravingResult> {\n  try {\n    const res = await fetch(`${baseUrl()}/store/carts/${cartId}/line-items-engraving`, {\n      method: 'POST',\n      headers: storeHeaders({ 'Content-Type': 'application/json' }),\n      body: JSON.stringify(input),\n    })\n    if (res.ok) return { ok: true }\n    const data = (await res.json().catch(() => ({}))) as { message?: string; error?: string; errors?: string[] }\n    const error =\n      (data.errors && data.errors.join('; ')) ||\n      data.error ||\n      data.message ||\n      `Could not add engraving (${res.status})`\n    return { ok: false, error }\n  } catch (e) {\n    return { ok: false, error: e instanceof Error ? e.message : 'Network error' }\n  }\n}\n","'use client'\n\nimport { useQuery } from '@tanstack/react-query'\nimport { fetchEngravingFee } from '../lib/fetch'\n\n/**\n * Live engraving fee for a template in a given currency, resolved server-side\n * from the store's locked FX rate (so it covers every supported currency and\n * matches exactly what the add-to-cart route charges). Returns `undefined`\n * while loading and `null` when the currency is unsupported.\n *\n * @example\n * const { data: fee, isLoading } = useEngravingFee(template.id, cart.currency_code)\n */\nexport function useEngravingFee(templateId: string, currency: string) {\n  return useQuery<number | null>({\n    queryKey: ['engraving-fee', templateId, currency],\n    queryFn: () => fetchEngravingFee(templateId, currency),\n    enabled: !!templateId && !!currency,\n    staleTime: 1000 * 60,\n  })\n}\n","import type { EngravingElement, EngravingFieldValues, EngravingVariant } from '../types'\n\nfunction hasValue(v: string | undefined): boolean {\n  const s = String(v == null ? '' : v).trim()\n  return s.length > 0 && s !== 'false'\n}\n\n/**\n * Conditional show/hide for an engraving field — mirrors the admin builder and\n * the Medusa server-side validation so the storefront, preview and server agree.\n */\nexport function isElementVisible(\n  el: EngravingElement,\n  values: EngravingFieldValues,\n): boolean {\n  const rules = el.conditions && el.conditions.rules\n  if (!rules || rules.length === 0) return true\n  const logic = (el.conditions && el.conditions.logic) || 'all'\n  const checks = rules.map((r) => {\n    const actual = values[r.elementId] || ''\n    const operator = r.operator || 'equals'\n    const expected = r.value != null ? r.value : r.equals != null ? r.equals : ''\n    if (operator === 'exists') return hasValue(actual)\n    if (operator === 'not_exists') return !hasValue(actual)\n    if (operator === 'not_equals') return actual !== expected\n    return actual === expected\n  })\n  return logic === 'any' ? checks.some(Boolean) : checks.every(Boolean)\n}\n\n/** Format a minor-unit amount as currency (e.g. 1000, 'sgd' → \"SGD 10.00\"). */\nexport function formatMoney(amountCents: number, currency: string): string {\n  try {\n    return new Intl.NumberFormat(undefined, {\n      style: 'currency',\n      currency: (currency || 'usd').toUpperCase(),\n    }).format((amountCents || 0) / 100)\n  } catch {\n    return ((amountCents || 0) / 100).toFixed(2)\n  }\n}\n\nexport function variantPrice(v?: EngravingVariant): number | undefined {\n  return v && v.calculated_price ? v.calculated_price.calculated_amount : undefined\n}\n\nexport function variantCurrency(v?: EngravingVariant): string {\n  return (v && v.calculated_price && v.calculated_price.currency_code) || 'usd'\n}\n"],"mappings":"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","names":["useQuery","useQuery"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@amboras-dev/engraving",
+  "version": "0.2.0",
+  "description": "Engraving personalization hooks + helpers for Amboras storefronts",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "@tanstack/react-query": ">=5"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "@types/react": "^18.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}