00 · Getting started

# from the folder that contains the tarball you downloaded from /downloads/munim-sdk.tgz
npm install ./munim-sdk.tgz     # or: pnpm add ./munim-sdk.tgz

import { uuidv7 } from "@munim/sdk";
const orderId = uuidv7();

// lib/munim.ts
import { createMunimClient } from "@munim/sdk";

export const API = process.env.NEXT_PUBLIC_MUNIM_API ?? "/mock";
export const KEY = process.env.NEXT_PUBLIC_MUNIM_STOREFRONT_KEY ?? "";

/** Anonymous storefront client. For one guest order's tracking, create a second one with `guestToken`. */
export const client = createMunimClient({ baseUrl: API, storefrontKey: KEY });
export const trackingClient = (guestToken: string) => createMunimClient({ baseUrl: API, storefrontKey: KEY, guestToken });

import { client } from "./lib/munim";

const { data: outlets, error: e1 } = await client.GET("/v1/storefront/outlets");
if (e1 || !outlets) throw new Error("could not load outlets");          // show the S-err state, not e1.error.message verbatim

const outlet = outlets.outlets[0]!;
const { data: menu, error: e2 } = await client.GET("/v1/storefront/outlets/{outlet_id}/menu", {
  params: { path: { outlet_id: outlet.outlet_id } },
});
if (e2 || !menu) throw new Error("could not load the menu");

for (const item of menu.items) {
  // display_name is the owner's plain text (null: use your own label for name_key); diet is veg / non_veg / egg / vegan or null.
  // price_minor is integer minor units (paise / cents); null when the item is sold by variant.
  console.log(item.display_name ?? item.name_key, item.diet ?? "", item.available ? "" : "(sold out)", item.price_minor, item.currency);
}
console.log("prices include tax:", menu.prices_include_tax, "pay at the counter by:", menu.pay_at_counter_methods);
console.log("accepting:", menu.accepting.state, "next open:", menu.accepting.next_open);

const API = process.env.NEXT_PUBLIC_MUNIM_API ?? "/mock";
const headers = { "X-Munim-Storefront-Key": process.env.NEXT_PUBLIC_MUNIM_STOREFRONT_KEY ?? "" };

const outletsRes = await fetch(`${API}/v1/storefront/outlets`, { headers });
if (!outletsRes.ok) throw new Error(`outlets: HTTP ${outletsRes.status}`);   // 404 = bad key, see 10-auth-and-errors.md
const { outlets } = (await outletsRes.json()) as { outlets: { outlet_id: string; name: string; tz: string }[] };

const menuRes = await fetch(`${API}/v1/storefront/outlets/${outlets[0]!.outlet_id}/menu`, { headers });
const menu = (await menuRes.json()) as { items: { name_key: string; display_name: string | null; price_minor: number | null; currency: string }[] };
console.log(menu.items.map((i) => `${i.display_name ?? i.name_key} ${i.price_minor} ${i.currency}`));