@whatalo/plugin-sdk 1.2.0 → 1.2.2

package/dist/client/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/errors.ts","../../src/client/whatalo-client.ts"],"sourcesContent":["/**\n * Base error for all SDK errors.\n * Contains the HTTP status code and a machine-readable error code.\n */\nexport class WhataloAPIError extends Error {\n  readonly statusCode: number;\n  readonly code: string;\n  readonly requestId?: string;\n\n  constructor(\n    message: string,\n    statusCode: number,\n    code: string,\n    requestId?: string\n  ) {\n    super(message);\n    this.name = \"WhataloAPIError\";\n    this.statusCode = statusCode;\n    this.code = code;\n    this.requestId = requestId;\n  }\n}\n\n/** 401 — Invalid or missing API key */\nexport class AuthenticationError extends WhataloAPIError {\n  constructor(\n    message = \"Invalid or missing API key\",\n    requestId?: string\n  ) {\n    super(message, 401, \"authentication_error\", requestId);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/** 403 — API key lacks required permission scope */\nexport class AuthorizationError extends WhataloAPIError {\n  readonly requiredScope: string;\n\n  constructor(\n    message: string,\n    requiredScope: string,\n    requestId?: string\n  ) {\n    super(message, 403, \"authorization_error\", requestId);\n    this.name = \"AuthorizationError\";\n    this.requiredScope = requiredScope;\n  }\n}\n\n/**\n * 403 — Installation does not have the required permission scope.\n *\n * Thrown when the merchant has not granted a scope that the current\n * API call requires. This is distinct from AuthorizationError:\n *   - AuthorizationError = generic 403 (could be any auth reason)\n *   - InsufficientScopeError = specific scope missing from granted_scopes\n *\n * The `requiredScope` field tells the developer exactly which scope to add\n * to their plugin manifest so they can request merchant re-consent.\n *\n * Example:\n *   try {\n *     await client.customers.list()\n *   } catch (err) {\n *     if (err instanceof InsufficientScopeError) {\n *       console.error(`Add \"${err.requiredScope}\" to your manifest.`)\n *     }\n *   }\n */\nexport class InsufficientScopeError extends WhataloAPIError {\n  /** The exact scope string missing from the installation's granted_scopes */\n  readonly requiredScope: string;\n  /** The scopes currently granted to this installation */\n  readonly grantedScopes: string[];\n\n  constructor(\n    message: string,\n    requiredScope: string,\n    grantedScopes: string[],\n    requestId?: string\n  ) {\n    super(message, 403, \"insufficient_scope\", requestId);\n    this.name = \"InsufficientScopeError\";\n    this.requiredScope = requiredScope;\n    this.grantedScopes = grantedScopes;\n  }\n}\n\n/** 404 — Resource not found */\nexport class NotFoundError extends WhataloAPIError {\n  readonly resourceType: string;\n  readonly resourceId: string;\n\n  constructor(\n    resourceType: string,\n    resourceId: string,\n    requestId?: string\n  ) {\n    super(\n      `${resourceType} '${resourceId}' not found`,\n      404,\n      \"not_found\",\n      requestId\n    );\n    this.name = \"NotFoundError\";\n    this.resourceType = resourceType;\n    this.resourceId = resourceId;\n  }\n}\n\n/** 422 — Request body validation failed */\nexport class ValidationError extends WhataloAPIError {\n  readonly fieldErrors: Array<{ field: string; message: string }>;\n\n  constructor(\n    fieldErrors: Array<{ field: string; message: string }>,\n    requestId?: string\n  ) {\n    const message = `Validation failed: ${fieldErrors\n      .map((e) => `${e.field} — ${e.message}`)\n      .join(\", \")}`;\n    super(message, 422, \"validation_error\", requestId);\n    this.name = \"ValidationError\";\n    this.fieldErrors = fieldErrors;\n  }\n}\n\n/** 429 — Rate limit exceeded */\nexport class RateLimitError extends WhataloAPIError {\n  /** Seconds until the rate limit resets */\n  readonly retryAfter: number;\n\n  constructor(retryAfter: number, requestId?: string) {\n    super(\n      `Rate limit exceeded. Retry after ${retryAfter} seconds.`,\n      429,\n      \"rate_limit_exceeded\",\n      requestId\n    );\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\n/** 500 — Server-side error */\nexport class InternalError extends WhataloAPIError {\n  constructor(\n    message = \"An internal error occurred\",\n    requestId?: string\n  ) {\n    super(message, 500, \"internal_error\", requestId);\n    this.name = \"InternalError\";\n  }\n}\n","import type {\n  WhataloClientOptions,\n  RateLimitInfo,\n  PaginatedResponse,\n  SingleResponse,\n  Product,\n  Order,\n  Customer,\n  Category,\n  Discount,\n  Store,\n  InventoryItem,\n  Webhook,\n  ListProductsParams,\n  CreateProductParams,\n  UpdateProductParams,\n  ListOrdersParams,\n  UpdateOrderStatusParams,\n  UpdateOrderPaymentStatusParams,\n  ListCustomersParams,\n  ListCategoriesParams,\n  CreateCategoryParams,\n  UpdateCategoryParams,\n  ListDiscountsParams,\n  CreateDiscountParams,\n  UpdateDiscountParams,\n  UpsertWebhookParams,\n  UpdateWebhookParams,\n  AdjustInventoryParams,\n} from \"./types.js\";\nimport {\n  WhataloAPIError,\n  AuthenticationError,\n  AuthorizationError,\n  InsufficientScopeError,\n  RateLimitError,\n  InternalError,\n  NotFoundError,\n  ValidationError,\n} from \"./errors.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.whatalo.com/v1\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/**\n * Official TypeScript client for the Whatalo REST API.\n * Zero runtime dependencies — uses native fetch.\n */\nexport class WhataloClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n  private readonly maxRetries: number;\n  private readonly fetchFn: typeof globalThis.fetch;\n  private readonly onRequest?: (url: string, init: RequestInit) => void;\n  private readonly onResponse?: (response: Response, durationMs: number) => void;\n\n  /** Rate limit info from the most recent API response */\n  rateLimit: RateLimitInfo = { limit: 0, remaining: 0, reset: 0 };\n\n  /** Product resource methods */\n  readonly products: ProductResource;\n  /** Order resource methods */\n  readonly orders: OrderResource;\n  /** Customer resource methods */\n  readonly customers: CustomerResource;\n  /** Category resource methods */\n  readonly categories: CategoryResource;\n  /** Discount resource methods */\n  readonly discounts: DiscountResource;\n  /** Store resource methods */\n  readonly store: StoreResource;\n  /** Inventory resource methods */\n  readonly inventory: InventoryResource;\n  /** Webhook resource methods */\n  readonly webhooks: WebhookResource;\n\n  constructor(options: WhataloClientOptions) {\n    // Guard against accidental browser-side instantiation.\n    // WhataloClient embeds the API key in every request — exposing it in\n    // client-side JavaScript would allow any visitor to make authenticated\n    // API calls on behalf of the merchant. Use sessionToken() on the frontend\n    // and validate on the backend instead.\n    if (typeof window !== \"undefined\" && typeof process === \"undefined\") {\n      console.warn(\n        \"[WhataloClient] WARNING: WhataloClient should only be used in server-side code. \" +\n        \"Exposing your API key in browser JavaScript is a security risk. \" +\n        \"Use whatalo.sessionToken() in your frontend and validate it on your backend.\"\n      );\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.maxRetries = Math.min(options.retries ?? 0, 3);\n    this.fetchFn = options.fetch ?? globalThis.fetch;\n    this.onRequest = options.onRequest;\n    this.onResponse = options.onResponse;\n\n    this.products = new ProductResource(this);\n    this.orders = new OrderResource(this);\n    this.customers = new CustomerResource(this);\n    this.categories = new CategoryResource(this);\n    this.discounts = new DiscountResource(this);\n    this.store = new StoreResource(this);\n    this.inventory = new InventoryResource(this);\n    this.webhooks = new WebhookResource(this);\n  }\n\n  /**\n   * Internal request method shared by all resource namespaces.\n   * Handles headers, timeout, error parsing, and rate limit extraction.\n   */\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      params?: Record<string, string | number | boolean | undefined>;\n    }\n  ): Promise<T> {\n    let url = `${this.baseUrl}${path}`;\n\n    // Add query params\n    if (options?.params) {\n      const searchParams = new URLSearchParams();\n      for (const [key, value] of Object.entries(options.params)) {\n        if (value !== undefined) {\n          searchParams.set(key, String(value));\n        }\n      }\n      const qs = searchParams.toString();\n      if (qs) url += `?${qs}`;\n    }\n\n    const headers: Record<string, string> = {\n      \"X-API-Key\": this.apiKey,\n      \"Content-Type\": \"application/json\",\n    };\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n      const requestInit: RequestInit = {\n        method,\n        headers,\n        body: options?.body ? JSON.stringify(options.body) : undefined,\n        signal: controller.signal,\n      };\n      const startedAt = Date.now();\n      this.onRequest?.(url, requestInit);\n\n      try {\n        const response = await this.fetchFn(url, requestInit);\n\n        clearTimeout(timeoutId);\n        this.onResponse?.(response, Date.now() - startedAt);\n\n        // Extract rate limit headers\n        this.rateLimit = {\n          limit: Number(response.headers.get(\"X-RateLimit-Limit\") ?? 0),\n          remaining: Number(\n            response.headers.get(\"X-RateLimit-Remaining\") ?? 0\n          ),\n          reset: Number(response.headers.get(\"X-RateLimit-Reset\") ?? 0),\n        };\n\n        const requestId =\n          response.headers.get(\"X-Request-Id\") ?? undefined;\n\n        if (response.ok) {\n          return (await response.json()) as T;\n        }\n\n        // Handle error responses\n        const errorBody = await response.json().catch(() => ({\n          error: { code: \"unknown\", message: response.statusText },\n        }));\n        const errData = (errorBody as { error?: { code?: string; message?: string; details?: Array<{ field: string; message: string }> } }).error;\n\n        switch (response.status) {\n          case 401:\n            throw new AuthenticationError(errData?.message, requestId);\n          case 403:\n            // Distinguish between a specific scope denial and a generic 403.\n            // insufficient_scope means the merchant never granted this permission.\n            if (errData?.code === \"insufficient_scope\") {\n              const details = errorBody as {\n                error?: { required?: string; granted?: string[] };\n              };\n              throw new InsufficientScopeError(\n                errData.message ?? \"Insufficient scope\",\n                details.error?.required ?? \"\",\n                details.error?.granted ?? [],\n                requestId\n              );\n            }\n            throw new AuthorizationError(\n              errData?.message ?? \"Forbidden\",\n              errData?.code ?? \"unknown_scope\",\n              requestId\n            );\n          case 404:\n            throw new NotFoundError(\"Resource\", path, requestId);\n          case 422:\n            throw new ValidationError(\n              errData?.details ?? [\n                { field: \"unknown\", message: errData?.message ?? \"Validation failed\" },\n              ],\n              requestId\n            );\n          case 429: {\n            const retryAfter = Number(\n              response.headers.get(\"Retry-After\") ?? 60\n            );\n            throw new RateLimitError(retryAfter, requestId);\n          }\n          default:\n            if (response.status >= 500 && attempt < this.maxRetries) {\n              // Retry on 5xx\n              lastError = new InternalError(errData?.message, requestId);\n              await this.sleep(Math.pow(2, attempt) * 1000);\n              continue;\n            }\n            throw new WhataloAPIError(\n              errData?.message ?? \"API error\",\n              response.status,\n              errData?.code ?? \"unknown\",\n              requestId\n            );\n        }\n      } catch (err) {\n        clearTimeout(timeoutId);\n        if (err instanceof WhataloAPIError) throw err;\n        if ((err as Error).name === \"AbortError\") {\n          throw new WhataloAPIError(\n            \"Request timed out\",\n            408,\n            \"timeout\"\n          );\n        }\n        throw err;\n      }\n    }\n\n    throw lastError ?? new InternalError(\"Request failed after retries\");\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/** Products API namespace */\nclass ProductResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListProductsParams\n  ): Promise<PaginatedResponse<Product>> {\n    return this.client.request(\"GET\", \"/products\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Product>> {\n    return this.client.request(\"GET\", `/products/${id}`);\n  }\n\n  async create(\n    data: CreateProductParams\n  ): Promise<SingleResponse<Product>> {\n    return this.client.request(\"POST\", \"/products\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateProductParams\n  ): Promise<SingleResponse<Product>> {\n    return this.client.request(\"PATCH\", `/products/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/products/${id}`);\n  }\n\n  async count(\n    status?: \"active\" | \"inactive\" | \"all\"\n  ): Promise<SingleResponse<{ count: number }>> {\n    return this.client.request(\"GET\", \"/products/count\", {\n      params: status ? { status } : undefined,\n    });\n  }\n}\n\n/** Orders API namespace */\nclass OrderResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListOrdersParams\n  ): Promise<PaginatedResponse<Order>> {\n    return this.client.request(\"GET\", \"/orders\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Order>> {\n    return this.client.request(\"GET\", `/orders/${id}`);\n  }\n\n  async updateStatus(\n    id: string,\n    data: UpdateOrderStatusParams\n  ): Promise<SingleResponse<Order>> {\n    return this.client.request(\"PATCH\", `/orders/${id}`, { body: data });\n  }\n\n  async updatePaymentStatus(\n    id: string,\n    data: UpdateOrderPaymentStatusParams\n  ): Promise<SingleResponse<Order>> {\n    return this.client.request(\"PATCH\", `/orders/${id}`, { body: data });\n  }\n\n  async count(\n    status?: string\n  ): Promise<SingleResponse<{ count: number }>> {\n    return this.client.request(\"GET\", \"/orders/count\", {\n      params: status ? { status } : undefined,\n    });\n  }\n}\n\n/** Customers API namespace */\nclass CustomerResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(params?: ListCustomersParams): Promise<PaginatedResponse<Customer>> {\n    return this.client.request(\"GET\", \"/customers\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Customer>> {\n    return this.client.request(\"GET\", `/customers/${id}`);\n  }\n}\n\n/** Categories API namespace */\nclass CategoryResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListCategoriesParams\n  ): Promise<PaginatedResponse<Category>> {\n    return this.client.request(\"GET\", \"/categories\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Category>> {\n    return this.client.request(\"GET\", `/categories/${id}`);\n  }\n\n  async create(\n    data: CreateCategoryParams\n  ): Promise<SingleResponse<Category>> {\n    return this.client.request(\"POST\", \"/categories\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateCategoryParams\n  ): Promise<SingleResponse<Category>> {\n    return this.client.request(\"PATCH\", `/categories/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/categories/${id}`);\n  }\n\n  async count(): Promise<SingleResponse<{ count: number }>> {\n    return this.client.request(\"GET\", \"/categories/count\");\n  }\n}\n\n/** Discounts API namespace */\nclass DiscountResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListDiscountsParams\n  ): Promise<PaginatedResponse<Discount>> {\n    return this.client.request(\"GET\", \"/discounts\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Discount>> {\n    return this.client.request(\"GET\", `/discounts/${id}`);\n  }\n\n  async create(\n    data: CreateDiscountParams\n  ): Promise<SingleResponse<Discount>> {\n    return this.client.request(\"POST\", \"/discounts\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateDiscountParams\n  ): Promise<SingleResponse<Discount>> {\n    return this.client.request(\"PATCH\", `/discounts/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/discounts/${id}`);\n  }\n}\n\n/** Store API namespace */\nclass StoreResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async get(): Promise<SingleResponse<Store>> {\n    return this.client.request(\"GET\", \"/store\");\n  }\n}\n\n/** Inventory API namespace */\nclass InventoryResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async get(productId: string): Promise<SingleResponse<InventoryItem>> {\n    return this.client.request(\"GET\", `/products/${productId}/inventory`);\n  }\n\n  async adjust(\n    productId: string,\n    data: AdjustInventoryParams\n  ): Promise<SingleResponse<InventoryItem>> {\n    return this.client.request(\"PATCH\", `/products/${productId}/inventory`, {\n      body: data,\n    });\n  }\n}\n\n/** Webhooks API namespace */\nclass WebhookResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(): Promise<PaginatedResponse<Webhook>> {\n    return this.client.request(\"GET\", \"/webhooks\");\n  }\n\n  async create(data: UpsertWebhookParams): Promise<SingleResponse<Webhook>> {\n    return this.client.request(\"POST\", \"/webhooks\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateWebhookParams\n  ): Promise<SingleResponse<Webhook>> {\n    return this.client.request(\"PATCH\", `/webhooks/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/webhooks/${id}`);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/client/errors.ts","../../src/client/whatalo-client.ts"],"sourcesContent":["/**\n * Base error for all SDK errors.\n * Contains the HTTP status code and a machine-readable error code.\n */\nexport class WhataloAPIError extends Error {\n  readonly statusCode: number;\n  readonly code: string;\n  readonly requestId?: string;\n\n  constructor(\n    message: string,\n    statusCode: number,\n    code: string,\n    requestId?: string\n  ) {\n    super(message);\n    this.name = \"WhataloAPIError\";\n    this.statusCode = statusCode;\n    this.code = code;\n    this.requestId = requestId;\n  }\n}\n\n/** 401 — Invalid or missing API key */\nexport class AuthenticationError extends WhataloAPIError {\n  constructor(\n    message = \"Invalid or missing API key\",\n    requestId?: string\n  ) {\n    super(message, 401, \"authentication_error\", requestId);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/** 403 — API key lacks required permission scope */\nexport class AuthorizationError extends WhataloAPIError {\n  readonly requiredScope: string;\n\n  constructor(\n    message: string,\n    requiredScope: string,\n    requestId?: string\n  ) {\n    super(message, 403, \"authorization_error\", requestId);\n    this.name = \"AuthorizationError\";\n    this.requiredScope = requiredScope;\n  }\n}\n\n/**\n * 403 — Installation does not have the required permission scope.\n *\n * Thrown when the merchant has not granted a scope that the current\n * API call requires. This is distinct from AuthorizationError:\n *   - AuthorizationError = generic 403 (could be any auth reason)\n *   - InsufficientScopeError = specific scope missing from granted_scopes\n *\n * The `requiredScope` field tells the developer exactly which scope to add\n * to their plugin manifest so they can request merchant re-consent.\n *\n * Example:\n *   try {\n *     await client.customers.list()\n *   } catch (err) {\n *     if (err instanceof InsufficientScopeError) {\n *       console.error(`Add \"${err.requiredScope}\" to your manifest.`)\n *     }\n *   }\n */\nexport class InsufficientScopeError extends WhataloAPIError {\n  /** The exact scope string missing from the installation's granted_scopes */\n  readonly requiredScope: string;\n  /** The scopes currently granted to this installation */\n  readonly grantedScopes: string[];\n\n  constructor(\n    message: string,\n    requiredScope: string,\n    grantedScopes: string[],\n    requestId?: string\n  ) {\n    super(message, 403, \"insufficient_scope\", requestId);\n    this.name = \"InsufficientScopeError\";\n    this.requiredScope = requiredScope;\n    this.grantedScopes = grantedScopes;\n  }\n}\n\n/** 404 — Resource not found */\nexport class NotFoundError extends WhataloAPIError {\n  readonly resourceType: string;\n  readonly resourceId: string;\n\n  constructor(\n    resourceType: string,\n    resourceId: string,\n    requestId?: string\n  ) {\n    super(\n      `${resourceType} '${resourceId}' not found`,\n      404,\n      \"not_found\",\n      requestId\n    );\n    this.name = \"NotFoundError\";\n    this.resourceType = resourceType;\n    this.resourceId = resourceId;\n  }\n}\n\n/** 422 — Request body validation failed */\nexport class ValidationError extends WhataloAPIError {\n  readonly fieldErrors: Array<{ field: string; message: string }>;\n\n  constructor(\n    fieldErrors: Array<{ field: string; message: string }>,\n    requestId?: string\n  ) {\n    const message = `Validation failed: ${fieldErrors\n      .map((e) => `${e.field} — ${e.message}`)\n      .join(\", \")}`;\n    super(message, 422, \"validation_error\", requestId);\n    this.name = \"ValidationError\";\n    this.fieldErrors = fieldErrors;\n  }\n}\n\n/** 429 — Rate limit exceeded */\nexport class RateLimitError extends WhataloAPIError {\n  /** Seconds until the rate limit resets */\n  readonly retryAfter: number;\n\n  constructor(retryAfter: number, requestId?: string) {\n    super(\n      `Rate limit exceeded. Retry after ${retryAfter} seconds.`,\n      429,\n      \"rate_limit_exceeded\",\n      requestId\n    );\n    this.name = \"RateLimitError\";\n    this.retryAfter = retryAfter;\n  }\n}\n\n/** 500 — Server-side error */\nexport class InternalError extends WhataloAPIError {\n  constructor(\n    message = \"An internal error occurred\",\n    requestId?: string\n  ) {\n    super(message, 500, \"internal_error\", requestId);\n    this.name = \"InternalError\";\n  }\n}\n","import type {\n  WhataloClientOptions,\n  RateLimitInfo,\n  PaginatedResponse,\n  SingleResponse,\n  Product,\n  Order,\n  Customer,\n  Category,\n  Discount,\n  Store,\n  GeoCountry,\n  GeoProvince,\n  InventoryItem,\n  Webhook,\n  ListProductsParams,\n  CreateProductParams,\n  UpdateProductParams,\n  ListOrdersParams,\n  UpdateOrderStatusParams,\n  UpdateOrderPaymentStatusParams,\n  ListCustomersParams,\n  ListCategoriesParams,\n  CreateCategoryParams,\n  UpdateCategoryParams,\n  ListDiscountsParams,\n  CreateDiscountParams,\n  UpdateDiscountParams,\n  UpsertWebhookParams,\n  UpdateWebhookParams,\n  AdjustInventoryParams,\n  ListCountriesParams,\n} from \"./types.js\";\nimport {\n  WhataloAPIError,\n  AuthenticationError,\n  AuthorizationError,\n  InsufficientScopeError,\n  RateLimitError,\n  InternalError,\n  NotFoundError,\n  ValidationError,\n} from \"./errors.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.whatalo.com/v1\";\nconst DEFAULT_TIMEOUT = 30_000;\n\n/**\n * Official TypeScript client for the Whatalo REST API.\n * Zero runtime dependencies — uses native fetch.\n */\nexport class WhataloClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n  private readonly maxRetries: number;\n  private readonly fetchFn: typeof globalThis.fetch;\n  private readonly onRequest?: (url: string, init: RequestInit) => void;\n  private readonly onResponse?: (response: Response, durationMs: number) => void;\n\n  /** Rate limit info from the most recent API response */\n  rateLimit: RateLimitInfo = { limit: 0, remaining: 0, reset: 0 };\n\n  /** Product resource methods */\n  readonly products: ProductResource;\n  /** Order resource methods */\n  readonly orders: OrderResource;\n  /** Customer resource methods */\n  readonly customers: CustomerResource;\n  /** Category resource methods */\n  readonly categories: CategoryResource;\n  /** Discount resource methods */\n  readonly discounts: DiscountResource;\n  /** Store resource methods */\n  readonly store: StoreResource;\n  /** Inventory resource methods */\n  readonly inventory: InventoryResource;\n  /** Webhook resource methods */\n  readonly webhooks: WebhookResource;\n  /** Geo reference data methods */\n  readonly geo: GeoResource;\n\n  constructor(options: WhataloClientOptions) {\n    // Guard against accidental browser-side instantiation.\n    // WhataloClient embeds the API key in every request — exposing it in\n    // client-side JavaScript would allow any visitor to make authenticated\n    // API calls on behalf of the merchant. Use sessionToken() on the frontend\n    // and validate on the backend instead.\n    if (typeof window !== \"undefined\" && typeof process === \"undefined\") {\n      console.warn(\n        \"[WhataloClient] WARNING: WhataloClient should only be used in server-side code. \" +\n        \"Exposing your API key in browser JavaScript is a security risk. \" +\n        \"Use whatalo.sessionToken() in your frontend and validate it on your backend.\"\n      );\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.maxRetries = Math.min(options.retries ?? 0, 3);\n    this.fetchFn = options.fetch ?? globalThis.fetch;\n    this.onRequest = options.onRequest;\n    this.onResponse = options.onResponse;\n\n    this.products = new ProductResource(this);\n    this.orders = new OrderResource(this);\n    this.customers = new CustomerResource(this);\n    this.categories = new CategoryResource(this);\n    this.discounts = new DiscountResource(this);\n    this.store = new StoreResource(this);\n    this.inventory = new InventoryResource(this);\n    this.webhooks = new WebhookResource(this);\n    this.geo = new GeoResource(this);\n  }\n\n  /**\n   * Internal request method shared by all resource namespaces.\n   * Handles headers, timeout, error parsing, and rate limit extraction.\n   */\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      params?: Record<string, string | number | boolean | undefined>;\n    }\n  ): Promise<T> {\n    let url = `${this.baseUrl}${path}`;\n\n    // Add query params\n    if (options?.params) {\n      const searchParams = new URLSearchParams();\n      for (const [key, value] of Object.entries(options.params)) {\n        if (value !== undefined) {\n          searchParams.set(key, String(value));\n        }\n      }\n      const qs = searchParams.toString();\n      if (qs) url += `?${qs}`;\n    }\n\n    const headers: Record<string, string> = {\n      \"X-API-Key\": this.apiKey,\n      \"Content-Type\": \"application/json\",\n    };\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n      const requestInit: RequestInit = {\n        method,\n        headers,\n        body: options?.body ? JSON.stringify(options.body) : undefined,\n        signal: controller.signal,\n      };\n      const startedAt = Date.now();\n      this.onRequest?.(url, requestInit);\n\n      try {\n        const response = await this.fetchFn(url, requestInit);\n\n        clearTimeout(timeoutId);\n        this.onResponse?.(response, Date.now() - startedAt);\n\n        // Extract rate limit headers\n        this.rateLimit = {\n          limit: Number(response.headers.get(\"X-RateLimit-Limit\") ?? 0),\n          remaining: Number(\n            response.headers.get(\"X-RateLimit-Remaining\") ?? 0\n          ),\n          reset: Number(response.headers.get(\"X-RateLimit-Reset\") ?? 0),\n        };\n\n        const requestId =\n          response.headers.get(\"X-Request-Id\") ?? undefined;\n\n        if (response.ok) {\n          return (await response.json()) as T;\n        }\n\n        // Handle error responses\n        const errorBody = await response.json().catch(() => ({\n          error: { code: \"unknown\", message: response.statusText },\n        }));\n        const errData = (errorBody as { error?: { code?: string; message?: string; details?: Array<{ field: string; message: string }> } }).error;\n\n        switch (response.status) {\n          case 401:\n            throw new AuthenticationError(errData?.message, requestId);\n          case 403:\n            // Distinguish between a specific scope denial and a generic 403.\n            // insufficient_scope means the merchant never granted this permission.\n            if (errData?.code === \"insufficient_scope\") {\n              const details = errorBody as {\n                error?: { required?: string; granted?: string[] };\n              };\n              throw new InsufficientScopeError(\n                errData.message ?? \"Insufficient scope\",\n                details.error?.required ?? \"\",\n                details.error?.granted ?? [],\n                requestId\n              );\n            }\n            throw new AuthorizationError(\n              errData?.message ?? \"Forbidden\",\n              errData?.code ?? \"unknown_scope\",\n              requestId\n            );\n          case 404:\n            throw new NotFoundError(\"Resource\", path, requestId);\n          case 422:\n            throw new ValidationError(\n              errData?.details ?? [\n                { field: \"unknown\", message: errData?.message ?? \"Validation failed\" },\n              ],\n              requestId\n            );\n          case 429: {\n            const retryAfter = Number(\n              response.headers.get(\"Retry-After\") ?? 60\n            );\n            throw new RateLimitError(retryAfter, requestId);\n          }\n          default:\n            if (response.status >= 500 && attempt < this.maxRetries) {\n              // Retry on 5xx\n              lastError = new InternalError(errData?.message, requestId);\n              await this.sleep(Math.pow(2, attempt) * 1000);\n              continue;\n            }\n            throw new WhataloAPIError(\n              errData?.message ?? \"API error\",\n              response.status,\n              errData?.code ?? \"unknown\",\n              requestId\n            );\n        }\n      } catch (err) {\n        clearTimeout(timeoutId);\n        if (err instanceof WhataloAPIError) throw err;\n        if ((err as Error).name === \"AbortError\") {\n          throw new WhataloAPIError(\n            \"Request timed out\",\n            408,\n            \"timeout\"\n          );\n        }\n        throw err;\n      }\n    }\n\n    throw lastError ?? new InternalError(\"Request failed after retries\");\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/** Products API namespace */\nclass ProductResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListProductsParams\n  ): Promise<PaginatedResponse<Product>> {\n    return this.client.request(\"GET\", \"/products\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Product>> {\n    return this.client.request(\"GET\", `/products/${id}`);\n  }\n\n  async create(\n    data: CreateProductParams\n  ): Promise<SingleResponse<Product>> {\n    return this.client.request(\"POST\", \"/products\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateProductParams\n  ): Promise<SingleResponse<Product>> {\n    return this.client.request(\"PATCH\", `/products/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/products/${id}`);\n  }\n\n  async count(\n    status?: \"active\" | \"inactive\" | \"all\"\n  ): Promise<SingleResponse<{ count: number }>> {\n    return this.client.request(\"GET\", \"/products/count\", {\n      params: status ? { status } : undefined,\n    });\n  }\n}\n\n/** Orders API namespace */\nclass OrderResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListOrdersParams\n  ): Promise<PaginatedResponse<Order>> {\n    return this.client.request(\"GET\", \"/orders\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Order>> {\n    return this.client.request(\"GET\", `/orders/${id}`);\n  }\n\n  async updateStatus(\n    id: string,\n    data: UpdateOrderStatusParams\n  ): Promise<SingleResponse<Order>> {\n    return this.client.request(\"PATCH\", `/orders/${id}`, { body: data });\n  }\n\n  async updatePaymentStatus(\n    id: string,\n    data: UpdateOrderPaymentStatusParams\n  ): Promise<SingleResponse<Order>> {\n    return this.client.request(\"PATCH\", `/orders/${id}`, { body: data });\n  }\n\n  async count(\n    status?: string\n  ): Promise<SingleResponse<{ count: number }>> {\n    return this.client.request(\"GET\", \"/orders/count\", {\n      params: status ? { status } : undefined,\n    });\n  }\n}\n\n/** Customers API namespace */\nclass CustomerResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(params?: ListCustomersParams): Promise<PaginatedResponse<Customer>> {\n    return this.client.request(\"GET\", \"/customers\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Customer>> {\n    return this.client.request(\"GET\", `/customers/${id}`);\n  }\n}\n\n/** Categories API namespace */\nclass CategoryResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListCategoriesParams\n  ): Promise<PaginatedResponse<Category>> {\n    return this.client.request(\"GET\", \"/categories\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Category>> {\n    return this.client.request(\"GET\", `/categories/${id}`);\n  }\n\n  async create(\n    data: CreateCategoryParams\n  ): Promise<SingleResponse<Category>> {\n    return this.client.request(\"POST\", \"/categories\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateCategoryParams\n  ): Promise<SingleResponse<Category>> {\n    return this.client.request(\"PATCH\", `/categories/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/categories/${id}`);\n  }\n\n  async count(): Promise<SingleResponse<{ count: number }>> {\n    return this.client.request(\"GET\", \"/categories/count\");\n  }\n}\n\n/** Discounts API namespace */\nclass DiscountResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(\n    params?: ListDiscountsParams\n  ): Promise<PaginatedResponse<Discount>> {\n    return this.client.request(\"GET\", \"/discounts\", {\n      params: params as Record<string, string | number | boolean | undefined>,\n    });\n  }\n\n  async get(id: string): Promise<SingleResponse<Discount>> {\n    return this.client.request(\"GET\", `/discounts/${id}`);\n  }\n\n  async create(\n    data: CreateDiscountParams\n  ): Promise<SingleResponse<Discount>> {\n    return this.client.request(\"POST\", \"/discounts\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateDiscountParams\n  ): Promise<SingleResponse<Discount>> {\n    return this.client.request(\"PATCH\", `/discounts/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/discounts/${id}`);\n  }\n}\n\n/** Store API namespace */\nclass StoreResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async get(): Promise<SingleResponse<Store>> {\n    return this.client.request(\"GET\", \"/store\");\n  }\n}\n\n/** Inventory API namespace */\nclass InventoryResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async get(productId: string): Promise<SingleResponse<InventoryItem>> {\n    return this.client.request(\"GET\", `/inventory/products/${productId}`);\n  }\n\n  async adjust(\n    productId: string,\n    data: AdjustInventoryParams\n  ): Promise<SingleResponse<InventoryItem>> {\n    return this.client.request(\"PATCH\", `/inventory/products/${productId}`, {\n      body: data,\n    });\n  }\n}\n\n/** Webhooks API namespace */\nclass WebhookResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  async list(): Promise<PaginatedResponse<Webhook>> {\n    return this.client.request(\"GET\", \"/webhooks\");\n  }\n\n  async create(data: UpsertWebhookParams): Promise<SingleResponse<Webhook>> {\n    return this.client.request(\"POST\", \"/webhooks\", { body: data });\n  }\n\n  async update(\n    id: string,\n    data: UpdateWebhookParams\n  ): Promise<SingleResponse<Webhook>> {\n    return this.client.request(\"PATCH\", `/webhooks/${id}`, { body: data });\n  }\n\n  async delete(id: string): Promise<SingleResponse<{ deleted: boolean }>> {\n    return this.client.request(\"DELETE\", `/webhooks/${id}`);\n  }\n}\n\n/** Geo reference data API namespace (countries and provinces). */\nclass GeoResource {\n  constructor(private readonly client: WhataloClient) {}\n\n  /**\n   * List countries.\n   * By default returns only supported countries (is_supported=true).\n   * Pass `{ all: true }` to retrieve all 250 countries.\n   */\n  async listCountries(\n    params?: ListCountriesParams\n  ): Promise<{ data: GeoCountry[] }> {\n    return this.client.request(\"GET\", \"/geo/countries\", {\n      params: params?.all !== undefined ? { all: params.all } : undefined,\n    });\n  }\n\n  /**\n   * Get a single country by ISO 3166-1 alpha-2 code.\n   */\n  async getCountry(iso2: string): Promise<{ data: GeoCountry }> {\n    return this.client.request(\"GET\", `/geo/countries/${iso2.toUpperCase()}`);\n  }\n\n  /**\n   * List provinces (states, departments, regions) for a country.\n   * Returns an empty array for countries with no province data.\n   */\n  async listProvinces(countryIso2: string): Promise<{ data: GeoProvince[] }> {\n    return this.client.request(\"GET\", `/geo/countries/${countryIso2.toUpperCase()}/provinces`);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -30,10 +30,13 @@ __export(src_exports, {
   RateLimitError: () => RateLimitError,
   SDK_VERSION: () => SDK_VERSION,
   ValidationError: () => ValidationError,
+  WEBHOOK_EVENTS: () => WEBHOOK_EVENTS,
   WhataloAPIError: () => WhataloAPIError,
   WhataloClient: () => WhataloClient,
   clearSessionTokenCache: () => clearSessionTokenCache,
   defineApp: () => defineApp,
+  isRuntimeWebhookPayload: () => isRuntimeWebhookPayload,
+  isWebhookEvent: () => isWebhookEvent,
   sessionToken: () => sessionToken,
   useAppBridge: () => useAppBridge,
   useWhataloAction: () => useWhataloAction,
@@ -156,6 +159,8 @@ var WhataloClient = class {
   inventory;
   /** Webhook resource methods */
   webhooks;
+  /** Geo reference data methods */
+  geo;
   constructor(options) {
     if (typeof window !== "undefined" && typeof process === "undefined") {
       console.warn(
@@ -177,6 +182,7 @@ var WhataloClient = class {
     this.store = new StoreResource(this);
     this.inventory = new InventoryResource(this);
     this.webhooks = new WebhookResource(this);
+    this.geo = new GeoResource(this);
   }
   /**
    * Internal request method shared by all resource namespaces.
@@ -418,10 +424,10 @@ var InventoryResource = class {
     this.client = client;
   }
   async get(productId) {
-    return this.client.request("GET", `/products/${productId}/inventory`);
+    return this.client.request("GET", `/inventory/products/${productId}`);
   }
   async adjust(productId, data) {
-    return this.client.request("PATCH", `/products/${productId}/inventory`, {
+    return this.client.request("PATCH", `/inventory/products/${productId}`, {
       body: data
     });
   }
@@ -443,17 +449,57 @@ var WebhookResource = class {
     return this.client.request("DELETE", `/webhooks/${id}`);
   }
 };
+var GeoResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List countries.
+   * By default returns only supported countries (is_supported=true).
+   * Pass `{ all: true }` to retrieve all 250 countries.
+   */
+  async listCountries(params) {
+    return this.client.request("GET", "/geo/countries", {
+      params: params?.all !== void 0 ? { all: params.all } : void 0
+    });
+  }
+  /**
+   * Get a single country by ISO 3166-1 alpha-2 code.
+   */
+  async getCountry(iso2) {
+    return this.client.request("GET", `/geo/countries/${iso2.toUpperCase()}`);
+  }
+  /**
+   * List provinces (states, departments, regions) for a country.
+   * Returns an empty array for countries with no province data.
+   */
+  async listProvinces(countryIso2) {
+    return this.client.request("GET", `/geo/countries/${countryIso2.toUpperCase()}/provinces`);
+  }
+};
 
 // src/webhooks/verify.ts
 var import_node_crypto = require("crypto");
+var DEFAULT_TOLERANCE_SECONDS = 300;
 function verifyWebhook({
   payload,
   signature,
-  secret
+  timestamp,
+  secret,
+  toleranceSeconds = DEFAULT_TOLERANCE_SECONDS,
+  currentTime = Math.floor(Date.now() / 1e3)
 }) {
-  if (!payload || !signature || !secret) return false;
-  const expected = (0, import_node_crypto.createHmac)("sha256", secret).update(payload, "utf8").digest("hex");
+  if (!payload || !signature || !secret || timestamp === "") return false;
+  const timestampString = String(timestamp);
+  const timestampValue = typeof timestamp === "number" ? timestamp : Number(timestamp);
+  if (!Number.isInteger(timestampValue)) return false;
+  if (!Number.isFinite(toleranceSeconds) || toleranceSeconds < 0) return false;
+  if (!Number.isFinite(currentTime)) return false;
+  const ageSeconds = Math.abs(currentTime - timestampValue);
+  if (ageSeconds > toleranceSeconds) return false;
+  const expected = (0, import_node_crypto.createHmac)("sha256", secret).update(`${timestampString}.${payload}`, "utf8").digest("hex");
   if (expected.length !== signature.length) return false;
+  if (!/^[a-f0-9]+$/i.test(signature)) return false;
   try {
     return (0, import_node_crypto.timingSafeEqual)(
       Buffer.from(expected, "hex"),
@@ -464,7 +510,70 @@ function verifyWebhook({
   }
 }
 
+// src/webhooks/types.ts
+var import_events = require("@whatalo/protocol/events");
+var WEBHOOK_EVENTS = import_events.PUBLIC_WEBHOOK_EVENTS;
+function isWebhookEvent(value) {
+  return (0, import_events.isPublicWebhookEvent)(value);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasStringId(value) {
+  return isRecord(value) && typeof value.id === "string";
+}
+function isOptionalString(value, key) {
+  return value[key] === void 0 || typeof value[key] === "string";
+}
+function isRuntimeWebhookStore(value) {
+  return isRecord(value) && typeof value.id === "string" && typeof value.timezone === "string" && (value.name === void 0 || typeof value.name === "string");
+}
+function hasValidBasePayloadFields(value) {
+  if (!isOptionalString(value, "event_id")) return false;
+  if (!isOptionalString(value, "occurred_at")) return false;
+  return isRuntimeWebhookStore(value.store);
+}
+function isRuntimeOrderWebhookPayload(value) {
+  return hasValidBasePayloadFields(value) && hasStringId(value.order) && (value.customer === void 0 || hasStringId(value.customer));
+}
+function isRuntimeProductWebhookPayload(value) {
+  return hasValidBasePayloadFields(value) && hasStringId(value.product);
+}
+function isRuntimeCustomerWebhookPayload(value) {
+  return hasValidBasePayloadFields(value) && hasStringId(value.customer);
+}
+function isRuntimeCheckoutCompletedWebhookPayload(value) {
+  return hasValidBasePayloadFields(value) && hasStringId(value.order) && hasStringId(value.customer) && isRuntimeWebhookStore(value.store);
+}
+function isRuntimeCheckoutAbandonedWebhookPayload(value) {
+  return hasValidBasePayloadFields(value) && hasStringId(value.checkout) && isRuntimeWebhookStore(value.store);
+}
+function isRuntimeWebhookPayload(value, event) {
+  if (!isRecord(value)) return false;
+  switch (event) {
+    case WEBHOOK_EVENTS.ORDER_CREATED:
+    case WEBHOOK_EVENTS.ORDER_UPDATED:
+    case WEBHOOK_EVENTS.ORDER_CANCELLED:
+    case WEBHOOK_EVENTS.ORDER_COMPLETED:
+      return isRuntimeOrderWebhookPayload(value);
+    case WEBHOOK_EVENTS.PRODUCT_CREATED:
+    case WEBHOOK_EVENTS.PRODUCT_UPDATED:
+    case WEBHOOK_EVENTS.PRODUCT_DELETED:
+      return isRuntimeProductWebhookPayload(value);
+    case WEBHOOK_EVENTS.CUSTOMER_CREATED:
+    case WEBHOOK_EVENTS.CUSTOMER_UPDATED:
+      return isRuntimeCustomerWebhookPayload(value);
+    case WEBHOOK_EVENTS.CHECKOUT_COMPLETED:
+      return isRuntimeCheckoutCompletedWebhookPayload(value);
+    case WEBHOOK_EVENTS.CHECKOUT_ABANDONED:
+      return isRuntimeCheckoutAbandonedWebhookPayload(value);
+    default:
+      return false;
+  }
+}
+
 // src/manifest/validate.ts
+var import_scopes = require("@whatalo/protocol/scopes");
 var ManifestValidationError = class extends Error {
   errors;
   constructor(errors) {
@@ -477,23 +586,7 @@ var ManifestValidationError = class extends Error {
 var ID_REGEX = /^[a-z0-9][a-z0-9-]*[a-z0-9]$/;
 var SEMVER_REGEX = /^\d+\.\d+\.\d+$/;
 var EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-var VALID_PERMISSIONS = /* @__PURE__ */ new Set([
-  "read:products",
-  "write:products",
-  "read:orders",
-  "write:orders",
-  "read:customers",
-  "write:customers",
-  "read:inventory",
-  "write:inventory",
-  "read:store",
-  "write:store",
-  "read:webhooks",
-  "write:webhooks",
-  "read:discounts",
-  "write:discounts",
-  "read:analytics"
-]);
+var VALID_PERMISSIONS = new Set(import_scopes.SCOPE_LIST.map((s) => s.token));
 var VALID_CATEGORIES = /* @__PURE__ */ new Set([
   "analytics",
   "marketing",
@@ -588,8 +681,11 @@ var DATA_RESOURCE_SCOPE = {
   products: "read:products",
   orders: "read:orders",
   customers: "read:customers",
-  categories: "read:products"
+  categories: "read:products",
   // categories share the products scope
+  store: "read:store",
+  geo: "read:store"
+  // geo is global reference data, scoped to read:store
 };
 var BILLING_OPERATION = {
   GET_PLANS: "getPlans",
@@ -773,6 +869,18 @@ function useWhataloAction() {
   return { sendAction, showToast, navigate, openModal, closeModal, resize, billing };
 }
 
+// src/bridge/visual-readiness.ts
+var readyEmission = null;
+function createReadyPayload() {
+  return { visualReadiness: true };
+}
+function emitReadyOnce(getParentOrigin, postReady) {
+  readyEmission ??= getParentOrigin().then((origin) => {
+    postReady(origin, createReadyPayload());
+  });
+  return readyEmission;
+}
+
 // src/bridge/use-whatalo-context.ts
 var DEFAULT_CONTEXT = {
   storeId: "",
@@ -795,20 +903,32 @@ function useWhataloContext() {
     if (!payload || typeof payload.storeId !== "string") return;
     setContext(payload);
     setIsReady(true);
-    if (payload.theme) {
+    if (payload.theme === "light" || payload.theme === "dark") {
       document.documentElement.setAttribute("data-theme", payload.theme);
+      document.documentElement.style.colorScheme = payload.theme;
+      waitForParentOrigin().then((origin) => {
+        window.parent.postMessage(
+          {
+            type: "whatalo:action",
+            actionId: crypto.randomUUID(),
+            action: "visual-ready",
+            payload: {}
+          },
+          origin
+        );
+      });
     }
   }, []);
   (0, import_react2.useEffect)(() => {
     attachInitListener();
     window.addEventListener("message", handleMessage);
-    waitForParentOrigin().then((origin) => {
+    emitReadyOnce(waitForParentOrigin, (origin, payload) => {
       window.parent.postMessage(
         {
           type: "whatalo:action",
           actionId: crypto.randomUUID(),
           action: "ready",
-          payload: {}
+          payload
         },
         origin
       );
@@ -1001,16 +1121,44 @@ function useWhataloData() {
     },
     [fetchResource]
   );
+  const storeGet = (0, import_react3.useCallback)(async () => {
+    const ack = await fetchResource("store", "get");
+    return extractAckData(ack);
+  }, [fetchResource]);
+  const geoCountries = (0, import_react3.useCallback)(
+    async (params) => {
+      const ack = await fetchResource(
+        "geo",
+        "list",
+        { ...params, _sub: "countries" }
+      );
+      return extractAckData(ack);
+    },
+    [fetchResource]
+  );
+  const geoProvinces = (0, import_react3.useCallback)(
+    async (countryIso2) => {
+      const ack = await fetchResource(
+        "geo",
+        "list",
+        { _sub: "provinces", country: countryIso2 }
+      );
+      return extractAckData(ack);
+    },
+    [fetchResource]
+  );
   return {
     products: { list: productsList, get: productsGet },
     orders: { list: ordersList, get: ordersGet },
     customers: { list: customersList, get: customersGet },
-    categories: { list: categoriesList, get: categoriesGet }
+    categories: { list: categoriesList, get: categoriesGet },
+    store: { get: storeGet },
+    geo: { countries: geoCountries, provinces: geoProvinces }
   };
 }
 
 // src/index.ts
-var SDK_VERSION = "1.2.0";
+var SDK_VERSION = "1.2.2";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
@@ -1023,10 +1171,13 @@ var SDK_VERSION = "1.2.0";
   RateLimitError,
   SDK_VERSION,
   ValidationError,
+  WEBHOOK_EVENTS,
   WhataloAPIError,
   WhataloClient,
   clearSessionTokenCache,
   defineApp,
+  isRuntimeWebhookPayload,
+  isWebhookEvent,
   sessionToken,
   useAppBridge,
   useWhataloAction,