@storesynk/core

Typed Shopify Storefront primitives for headless commerce — the framework-agnostic data layer behind Storesynk:

• a public-token Storefront client with typed gql() queries,
• a cart store + rich-cart observable driven by Shopify's standard storefront events/actions,
• a client-side actions runtime (window.Shopify.actions) so apps and agents integrate the same way they would with a theme.

Built on the Hydrogen developer preview, which it firewalls behind a stable surface.

🧪 Early development — APIs may change.

Install

npm install @storesynk/core

Pre-1.0 prereleases (0.1.0-beta.N) are published to npm's latest tag, so a plain install gets the current release. Do not install @beta: that dist-tag is frozen at an old build.

Usage

import { createStorefront } from '@storesynk/core';

const sf = createStorefront({
  storeDomain: 'your-store.myshopify.com',
  publicAccessToken: '...', // public Storefront API token
});

// React to cart changes
sf.cart.subscribe((state) => {
  console.log(state.data.totalQuantity);
});

// Mutate via the standard action (also fires shopify:cart:* events)
await window.Shopify.actions.updateCart({
  lines: [{ merchandiseId: 'gid://shopify/ProductVariant/1', quantity: 1 }],
});

What you get

• createStorefront() — bootstrap: client + standard-actions runtime + cart store + richCart observable
• createStorefrontClient() — typed public-token client: client.graphql(doc, { variables })
• gql() — Hydrogen's typed query syntax (a branded string; zero runtime weight)
• cartQueries / productQueries — typed query documents (product, collection, search, cart)
• cart mutations, installStandardActions(), formatMoney, createObservable

License

MIT