@kotao/storefront 0.2.0

package/dist/types-Df3bGbKU.d.ts

@@ -0,0 +1,167 @@
+declare const CART_FORM_ACTIONS: Readonly<{
+    readonly LinesAdd: "LinesAdd";
+    readonly LinesUpdate: "LinesUpdate";
+    readonly LinesRemove: "LinesRemove";
+    readonly DiscountCodesUpdate: "DiscountCodesUpdate";
+    readonly GiftCardCodesAdd: "GiftCardCodesAdd";
+    readonly GiftCardCodesRemove: "GiftCardCodesRemove";
+    readonly BuyerIdentityUpdate: "BuyerIdentityUpdate";
+    readonly NoteUpdate: "NoteUpdate";
+    readonly AttributesUpdate: "AttributesUpdate";
+    readonly MetafieldsSet: "MetafieldsSet";
+    readonly MetafieldsDelete: "MetafieldsDelete";
+    readonly DeliveryAddressesReplace: "DeliveryAddressesReplace";
+    readonly SelectedDeliveryOptionsUpdate: "SelectedDeliveryOptionsUpdate";
+}>;
+type CartFormAction = (typeof CART_FORM_ACTIONS)[keyof typeof CART_FORM_ACTIONS];
+
+interface CartAttribute {
+    readonly key: string;
+    readonly value: string | null;
+}
+interface CartLineInput {
+    readonly merchandiseId: string;
+    readonly quantity?: number | null;
+    readonly attributes?: readonly CartAttribute[] | null;
+}
+interface CartLineUpdateInput {
+    readonly id: string;
+    readonly merchandiseId?: string | null;
+    readonly quantity?: number | null;
+    readonly attributes?: readonly CartAttribute[] | null;
+}
+interface CartBuyerIdentityInput {
+    readonly email?: string | null;
+    readonly phone?: string | null;
+    readonly countryCode?: string | null;
+    readonly customerAccessToken?: string | null;
+}
+interface CartMetafield {
+    readonly namespace: string;
+    readonly key: string;
+    readonly type: string;
+    readonly value: string;
+}
+interface CartMetafieldIdentifier {
+    readonly namespace: string;
+    readonly key: string;
+}
+interface CartDeliveryAddress {
+    readonly id: string;
+    readonly firstName?: string | null;
+    readonly lastName?: string | null;
+    readonly address1: string;
+    readonly address2?: string | null;
+    readonly city: string;
+    readonly provinceCode?: string | null;
+    readonly countryCode: string;
+    readonly postalCode: string;
+    readonly phone?: string | null;
+}
+interface CartSelectedDeliveryOption {
+    readonly deliveryAddressId: string;
+    readonly handle: string;
+}
+interface Money {
+    readonly amount: number | string;
+    readonly currencyCode: string;
+}
+interface CartLineCost {
+    readonly amountPerQuantity: Money;
+    readonly subtotalAmount: Money;
+    readonly totalAmount: Money;
+}
+interface CartTaxLine {
+    readonly ratePercent: number;
+    readonly net: Money;
+    readonly tax: Money;
+    readonly gross: Money;
+}
+interface CartDiscountAllocation {
+    readonly code: string;
+    readonly amount: Money;
+}
+interface CartCost {
+    readonly subtotalAmount: Money;
+    readonly totalAmount: Money;
+    readonly totalTaxAmount: Money;
+    readonly discountTotal: Money;
+    readonly taxLines: readonly CartTaxLine[];
+    readonly discountAllocations: readonly CartDiscountAllocation[];
+}
+interface CartLine {
+    readonly id: string;
+    readonly quantity: number;
+    readonly merchandise: {
+        readonly id: string;
+        readonly title?: string | null;
+        readonly price?: Money | null;
+    };
+    readonly cost?: CartLineCost;
+    readonly attributes: readonly CartAttribute[];
+}
+interface CartBuyerIdentity {
+    readonly email: string | null;
+    readonly phone: string | null;
+    readonly countryCode: string | null;
+}
+interface Cart {
+    readonly id: string;
+    readonly checkoutUrl: string;
+    readonly totalQuantity: number;
+    readonly lines: readonly CartLine[];
+    readonly cost: CartCost;
+    readonly buyerIdentity: CartBuyerIdentity;
+    readonly note: string | null;
+    readonly attributes: readonly CartAttribute[];
+    readonly discountCodes: readonly string[];
+    readonly giftCardCodes: readonly string[];
+    readonly metafields: readonly CartMetafield[];
+    readonly deliveryAddresses: readonly CartDeliveryAddress[];
+    readonly selectedDeliveryOptions: readonly CartSelectedDeliveryOption[];
+}
+interface CartUserError {
+    readonly field?: readonly string[] | null;
+    readonly message: string;
+    readonly code?: string | null;
+}
+interface CartMutationResult {
+    readonly cart: Cart | null;
+    readonly userErrors: readonly CartUserError[];
+    readonly headers: Headers;
+}
+interface HydrogenCartCreateInput {
+    readonly lines?: readonly CartLineInput[];
+    readonly discountCodes?: readonly string[];
+    readonly note?: string | null;
+    readonly attributes?: readonly CartAttribute[];
+    readonly buyerIdentity?: CartBuyerIdentityInput;
+}
+interface HydrogenCartMutationResult extends CartMutationResult {
+    readonly errors?: readonly unknown[];
+}
+interface HydrogenCart {
+    get(): Promise<Cart | null>;
+    create(input?: HydrogenCartCreateInput): Promise<HydrogenCartMutationResult>;
+    addLines(lines: readonly CartLineInput[]): Promise<HydrogenCartMutationResult>;
+    updateLines(lines: readonly CartLineUpdateInput[]): Promise<HydrogenCartMutationResult>;
+    removeLines(lineIds: readonly string[]): Promise<HydrogenCartMutationResult>;
+    updateDiscountCodes(discountCodes: readonly string[]): Promise<HydrogenCartMutationResult>;
+    updateBuyerIdentity(buyerIdentity: CartBuyerIdentityInput): Promise<HydrogenCartMutationResult>;
+    setCartId(cartId: string): Headers;
+}
+interface HydrogenSessionData {
+    readonly cartId?: string | null;
+}
+interface HydrogenSession {
+    readonly isPending?: boolean;
+    readonly has: (name: string) => boolean;
+    readonly get: (name: string) => unknown;
+    readonly flash: (name: string, value?: unknown) => unknown;
+    readonly unset: (name: string) => void;
+    readonly set: (name: string, value: unknown) => void;
+    destroy(): string | Promise<string>;
+    commit(): string | Promise<string>;
+}
+
+export { type CartFormAction as C, type HydrogenSession as H, type Cart as a, type CartLineInput as b, type CartAttribute as c, type CartBuyerIdentityInput as d, type CartMutationResult as e, type CartLineUpdateInput as f, type CartMetafield as g, type CartMetafieldIdentifier as h, type CartDeliveryAddress as i, type CartSelectedDeliveryOption as j, CART_FORM_ACTIONS as k, type CartBuyerIdentity as l, type CartLine as m, type CartUserError as n, type HydrogenCart as o, type HydrogenCartCreateInput as p, type HydrogenCartMutationResult as q, type HydrogenSessionData as r };

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@kotao/storefront",
+  "version": "0.2.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Kotao Storefronts theme SDK — framework-agnostic server runtime (storefront client, SWR isolated cache, signed geo) + React Router 7 binding. Mirrors Hydrogen's API (ADR-0003). Leaf package (ADR-0006).",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kotao-org/monorepo.git",
+    "directory": "packages/storefront"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cart-documents": {
+      "types": "./dist/cart-documents.d.ts",
+      "import": "./dist/cart-documents.js"
+    },
+    "./customer-account-api-types": {
+      "types": "./dist/customer-account-api-types.d.ts",
+      "import": "./dist/customer-account-api-types.js"
+    },
+    "./editor": {
+      "types": "./dist/editor.d.ts",
+      "import": "./dist/editor.js"
+    },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "import": "./dist/image.js"
+    },
+    "./product": {
+      "types": "./dist/product.d.ts",
+      "import": "./dist/product.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./react-router": {
+      "types": "./dist/react-router.d.ts",
+      "import": "./dist/react-router.js"
+    },
+    "./seo": {
+      "types": "./dist/seo.d.ts",
+      "import": "./dist/seo.js"
+    },
+    "./settings": {
+      "types": "./dist/settings.d.ts",
+      "import": "./dist/settings.js"
+    },
+    "./storefront-api-types": {
+      "types": "./dist/storefront-api-types.d.ts",
+      "import": "./dist/storefront-api-types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@kotao/storefront-contracts": "^0.2.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-router": "^7.16.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-router": {
+      "optional": true
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  }
+}