@tappify/extension-sdk 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tappify Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-2DBSVKAU.cjs

@@ -0,0 +1,65 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/client/errors.ts
+var TAP_ERROR_CODES = [
+  "TAP_OUTSIDE_HOST",
+  "TAP_SCOPE_MISSING",
+  "TAP_UNKNOWN_COLLECTION",
+  "TAP_UNKNOWN_PROCEDURE",
+  "TAP_NO_PORTAL",
+  "TAP_NO_QUERY_CLIENT",
+  "TAP_MANIFEST_INVALID",
+  "TAP_ENTRY_MISSING",
+  "TAP_STYLES_UNRESOLVED",
+  "TAP_SCHEMA_UNRESOLVED",
+  "TAP_TOKEN_MISSING",
+  "TAP_TOKEN_INVALID",
+  "TAP_TOKEN_AUDIENCE",
+  "TAP_EVENT_ID_MISSING",
+  "TAP_BODY_INVALID",
+  "TAP_BODY_TOO_LARGE",
+  "TAP_ROUTE_UNKNOWN",
+  "TAP_HANDLER_MISSING",
+  "TAP_INTERNAL_ERROR",
+  "TAP_WEBHOOK_REJECTED",
+  "TAP_TEST_TARGET_INVALID"
+];
+var CODE_SET = new Set(TAP_ERROR_CODES);
+var TapError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = "TapError";
+    this.code = code;
+  }
+  /**
+   * Narrows an unknown value to a `TapError`, by name and by a code it
+   * recognises, so it holds across module instances.
+   */
+  static is(value) {
+    return value instanceof Error && value.name === "TapError" && "code" in value && typeof value.code === "string" && CODE_SET.has(value.code);
+  }
+};
+var TapServerError = class extends Error {
+  constructor(code, message, status) {
+    super(message);
+    this.name = "TapServerError";
+    this.code = code;
+    this.status = status;
+  }
+  /** The wire body the handler answers with, without the status. */
+  toJSON() {
+    return { error: { code: this.code, message: this.message } };
+  }
+  /**
+   * Narrows an unknown value to a `TapServerError` by name and by carrying a
+   * string `code`, so it holds across module instances.
+   */
+  static is(value) {
+    return value instanceof Error && value.name === "TapServerError" && "code" in value && typeof value.code === "string";
+  }
+};
+
+
+
+
+
+exports.TAP_ERROR_CODES = TAP_ERROR_CODES; exports.TapError = TapError; exports.TapServerError = TapServerError;
+//# sourceMappingURL=chunk-2DBSVKAU.cjs.map

package/dist/chunk-2DBSVKAU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/chunk-2DBSVKAU.cjs","../src/client/errors.ts"],"names":[],"mappings":"AAAA;AC4BO,IAAM,gBAAA,EAA2C;AAAA,EACtD,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA,wBAAA;AAAA,EACA,uBAAA;AAAA,EACA,eAAA;AAAA,EACA,qBAAA;AAAA,EACA,sBAAA;AAAA,EACA,mBAAA;AAAA,EACA,uBAAA;AAAA,EACA,uBAAA;AAAA,EACA,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA,oBAAA;AAAA,EACA,sBAAA;AAAA,EACA,kBAAA;AAAA,EACA,oBAAA;AAAA,EACA,mBAAA;AAAA,EACA,qBAAA;AAAA,EACA,oBAAA;AAAA,EACA,sBAAA;AAAA,EACA;AACF,CAAA;AAEA,IAAM,SAAA,EAAW,IAAI,GAAA,CAAY,eAAe,CAAA;AA8BzC,IAAM,SAAA,EAAN,MAAA,QAAuB,MAAM;AAAA,EAGlC,WAAA,CAAY,IAAA,EAAoB,OAAA,EAAiB;AAC/C,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,KAAA,EAAO,UAAA;AACZ,IAAA,IAAA,CAAK,KAAA,EAAO,IAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,EAAA,CAAG,KAAA,EAAmC;AAC3C,IAAA,OACE,MAAA,WAAiB,MAAA,GACjB,KAAA,CAAM,KAAA,IAAS,WAAA,GACf,OAAA,GAAU,MAAA,GACV,OAAO,KAAA,CAAM,KAAA,IAAS,SAAA,GACtB,QAAA,CAAS,GAAA,CAAI,KAAA,CAAM,IAAI,CAAA;AAAA,EAE3B;AACF,CAAA;AA2BO,IAAM,eAAA,EAAN,MAAA,QAA6B,MAAM;AAAA,EAIxC,WAAA,CAAY,IAAA,EAAc,OAAA,EAAiB,MAAA,EAAiB;AAC1D,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,KAAA,EAAO,gBAAA;AACZ,IAAA,IAAA,CAAK,KAAA,EAAO,IAAA;AACZ,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA;AAAA,EAChB;AAAA;AAAA,EAGA,MAAA,CAAA,EAAuD;AACrD,IAAA,OAAO,EAAE,KAAA,EAAO,EAAE,IAAA,EAAM,IAAA,CAAK,IAAA,EAAM,OAAA,EAAS,IAAA,CAAK,QAAQ,EAAE,CAAA;AAAA,EAC7D;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,EAAA,CAAG,KAAA,EAAyC;AACjD,IAAA,OACE,MAAA,WAAiB,MAAA,GACjB,KAAA,CAAM,KAAA,IAAS,iBAAA,GACf,OAAA,GAAU,MAAA,GACV,OAAO,KAAA,CAAM,KAAA,IAAS,QAAA;AAAA,EAE1B;AACF,CAAA;ADrGA;AACA;AACE;AACA;AACA;AACF,gHAAC","file":"/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/chunk-2DBSVKAU.cjs","sourcesContent":[null,"/** Every code a `TapError` the SDK raises carries. */\nexport type TapErrorCode =\n  | 'TAP_OUTSIDE_HOST'\n  | 'TAP_SCOPE_MISSING'\n  | 'TAP_UNKNOWN_COLLECTION'\n  | 'TAP_UNKNOWN_PROCEDURE'\n  | 'TAP_NO_PORTAL'\n  | 'TAP_NO_QUERY_CLIENT'\n  | 'TAP_MANIFEST_INVALID'\n  | 'TAP_ENTRY_MISSING'\n  | 'TAP_STYLES_UNRESOLVED'\n  | 'TAP_SCHEMA_UNRESOLVED'\n  | 'TAP_TOKEN_MISSING'\n  | 'TAP_TOKEN_INVALID'\n  | 'TAP_TOKEN_AUDIENCE'\n  | 'TAP_EVENT_ID_MISSING'\n  | 'TAP_BODY_INVALID'\n  | 'TAP_BODY_TOO_LARGE'\n  | 'TAP_ROUTE_UNKNOWN'\n  | 'TAP_HANDLER_MISSING'\n  | 'TAP_INTERNAL_ERROR'\n  | 'TAP_WEBHOOK_REJECTED'\n  | 'TAP_TEST_TARGET_INVALID';\n\n/**\n * The same codes as `TapErrorCode`, as an array to iterate or check membership\n * against at runtime.\n */\nexport const TAP_ERROR_CODES: readonly TapErrorCode[] = [\n  'TAP_OUTSIDE_HOST',\n  'TAP_SCOPE_MISSING',\n  'TAP_UNKNOWN_COLLECTION',\n  'TAP_UNKNOWN_PROCEDURE',\n  'TAP_NO_PORTAL',\n  'TAP_NO_QUERY_CLIENT',\n  'TAP_MANIFEST_INVALID',\n  'TAP_ENTRY_MISSING',\n  'TAP_STYLES_UNRESOLVED',\n  'TAP_SCHEMA_UNRESOLVED',\n  'TAP_TOKEN_MISSING',\n  'TAP_TOKEN_INVALID',\n  'TAP_TOKEN_AUDIENCE',\n  'TAP_EVENT_ID_MISSING',\n  'TAP_BODY_INVALID',\n  'TAP_BODY_TOO_LARGE',\n  'TAP_ROUTE_UNKNOWN',\n  'TAP_HANDLER_MISSING',\n  'TAP_INTERNAL_ERROR',\n  'TAP_WEBHOOK_REJECTED',\n  'TAP_TEST_TARGET_INVALID',\n];\n\nconst CODE_SET = new Set<string>(TAP_ERROR_CODES);\n\n/**\n * The error the SDK and the host raise when a call cannot be served at all.\n *\n * @remarks\n * The SDK throws it for a mount outside the host (`TAP_OUTSIDE_HOST`), a\n * collection or procedure the manifest does not declare\n * (`TAP_UNKNOWN_COLLECTION`, `TAP_UNKNOWN_PROCEDURE`), a missing portal or query\n * client, a token the server rejected, and a misused testing helper. The host\n * turns a refused read or write into `TAP_SCOPE_MISSING`. Branch on `code`, which\n * is stable; the message is prose and changes. An error your own server raised is\n * a `TapServerError` instead.\n *\n * @example\n * ```tsx\n * import { TapError, TapErrorState, useTapQuery } from '@tappify/extension-sdk';\n *\n * function Revenue() {\n *   const revenue = useTapQuery({\n *     kind: 'revenue',\n *     range: { from: '2026-09-01', to: '2026-09-08' },\n *   });\n *   if (TapError.is(revenue.error) && revenue.error.code === 'TAP_SCOPE_MISSING') {\n *     return <TapErrorState title=\"Revenue is not shared with this extension\" />;\n *   }\n *   return <span>{revenue.data?.mrr ?? 0}</span>;\n * }\n * ```\n */\nexport class TapError extends Error {\n  readonly code: TapErrorCode;\n\n  constructor(code: TapErrorCode, message: string) {\n    super(message);\n    this.name = 'TapError';\n    this.code = code;\n  }\n\n  /**\n   * Narrows an unknown value to a `TapError`, by name and by a code it\n   * recognises, so it holds across module instances.\n   */\n  static is(value: unknown): value is TapError {\n    return (\n      value instanceof Error &&\n      value.name === 'TapError' &&\n      'code' in value &&\n      typeof value.code === 'string' &&\n      CODE_SET.has(value.code)\n    );\n  }\n}\n\n/**\n * The error a vendor server throws to answer a Tappify call with a code and a\n * message the owner sees.\n *\n * @remarks\n * `createTappifyHandler` catches it and answers `{ error: { code, message } }`\n * with `status`, or 400 when no status was given; the host relays both to the\n * calling mount, where they arrive as the `error` of `useTapServer`. Pick a code\n * of your own and keep it stable — the SDK's own codes are `SERVER_ERROR_CODES` —\n * and write the message for the owner, who reads it on screen.\n *\n * @example\n * ```ts\n * import { TapServerError } from '@tappify/extension-sdk/server';\n *\n * function assertRange(days: number) {\n *   if (days > 0) return;\n *   throw new TapServerError(\n *     'RANGE_TOO_SHORT',\n *     'getSummary needs a range of at least one day. Widen the date picker, then retry.',\n *     400,\n *   );\n * }\n * ```\n */\nexport class TapServerError extends Error {\n  readonly code: string;\n  readonly status: number | undefined;\n\n  constructor(code: string, message: string, status?: number) {\n    super(message);\n    this.name = 'TapServerError';\n    this.code = code;\n    this.status = status;\n  }\n\n  /** The wire body the handler answers with, without the status. */\n  toJSON(): { error: { code: string; message: string } } {\n    return { error: { code: this.code, message: this.message } };\n  }\n\n  /**\n   * Narrows an unknown value to a `TapServerError` by name and by carrying a\n   * string `code`, so it holds across module instances.\n   */\n  static is(value: unknown): value is TapServerError {\n    return (\n      value instanceof Error &&\n      value.name === 'TapServerError' &&\n      'code' in value &&\n      typeof value.code === 'string'\n    );\n  }\n}\n"]}

package/dist/chunk-3YWVYA42.cjs

@@ -0,0 +1,142 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk2DBSVKAUcjs = require('./chunk-2DBSVKAU.cjs');
+
+// src/testing/environment.ts
+var HOST_THEME = {
+  "--bg-base": "#ffffff",
+  "--bg-subtle": "rgba(18, 18, 18, 0.04)",
+  "--bg-raised": "#ffffff",
+  "--fg-default": "#121212",
+  "--fg-muted": "rgba(18, 18, 18, 0.6)",
+  "--fg-inverse": "#ffffff",
+  "--tap-accent": "#4f46e5",
+  "--tap-accent-fg": "#ffffff",
+  "--tap-danger": "#b42318",
+  "--tap-scrim": "rgba(18, 18, 18, 0.7)",
+  "--tap-radius": "6px",
+  "--tap-space": "8px",
+  "--font-sans": "system-ui, -apple-system, sans-serif",
+  "--font-mono": "ui-monospace, SFMono-Regular, monospace",
+  "--divider": "rgba(18, 18, 18, 0.12)"
+};
+function installHostTheme(root) {
+  for (const [name, value] of Object.entries(HOST_THEME)) {
+    root.style.setProperty(name, value);
+  }
+}
+function clearTapPortals(root = document) {
+  for (const node of root.querySelectorAll("[data-tap-portal]")) node.remove();
+}
+
+// src/testing/matchers.ts
+function isMock(value) {
+  return typeof value === "object" && value !== null && "calls" in value && "documents" in value && typeof value.documents === "function";
+}
+function requireMock(value, matcher) {
+  if (isMock(value)) return value;
+  throw new (0, _chunk2DBSVKAUcjs.TapError)(
+    "TAP_TEST_TARGET_INVALID",
+    `${matcher}() takes the mock renderWithTap() returned. Call it as expect(mock).${matcher}(\u2026), not on the component or the tap object.`
+  );
+}
+function tagOf(value) {
+  return Object.prototype.toString.call(value);
+}
+function sameList(left, right) {
+  return left.length === right.length && left.every((item, index) => same(item, right[index]));
+}
+function bytesOf(view) {
+  return [...new Uint8Array(view.buffer, view.byteOffset, view.byteLength)];
+}
+function same(left, right) {
+  if (Object.is(left, right)) return true;
+  const tag = tagOf(left);
+  if (tag !== tagOf(right)) return false;
+  if (typeof left !== "object" || typeof right !== "object" || left === null || right === null) {
+    return false;
+  }
+  if (left instanceof Date && right instanceof Date) {
+    return left.valueOf() === right.valueOf();
+  }
+  if (left instanceof RegExp && right instanceof RegExp) {
+    return left.source === right.source && left.flags === right.flags;
+  }
+  if (left instanceof Map && right instanceof Map) {
+    return sameList([...left.entries()], [...right.entries()]);
+  }
+  if (left instanceof Set && right instanceof Set) {
+    return sameList([...left.values()], [...right.values()]);
+  }
+  if (ArrayBuffer.isView(left) && ArrayBuffer.isView(right)) {
+    return sameList(bytesOf(left), bytesOf(right));
+  }
+  if (Array.isArray(left) && Array.isArray(right)) {
+    return sameList(left, right);
+  }
+  if (tag !== "[object Object]") return false;
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every(
+    (key) => key in right && same(Reflect.get(left, key), Reflect.get(right, key))
+  );
+}
+var tapMatchers = {
+  /** Passes when `tap.nav.push` was called with exactly that path. */
+  toHaveNavigatedTo(received, path) {
+    const mock = requireMock(received, "toHaveNavigatedTo");
+    const pass = mock.calls.navigations.includes(path);
+    return {
+      pass,
+      message: () => pass ? `Expected no navigation to ${path}, but tap.nav.push was called with it.` : `Expected a navigation to ${path}. tap.nav.push was called with: ${mock.calls.navigations.length === 0 ? "nothing" : mock.calls.navigations.join(", ")}.`
+    };
+  },
+  /** Passes when a toast matched the string exactly, or the pattern anywhere. */
+  toHaveToasted(received, expected) {
+    const mock = requireMock(received, "toHaveToasted");
+    const messages = mock.calls.toasts.map((toast) => toast.message);
+    const pass = messages.some(
+      (message) => typeof expected === "string" ? message === expected : expected.test(message)
+    );
+    return {
+      pass,
+      message: () => pass ? `Expected no toast matching ${String(expected)}, but one was shown.` : `Expected a toast matching ${String(expected)}. Toasts shown: ${messages.length === 0 ? "none" : messages.join(" | ")}.`
+    };
+  },
+  /**
+   * Passes when `tap.actions.run` was called with that action, and with input
+   * deep-equal to `input` when one is given.
+   */
+  toHaveRunAction(received, actionId, input) {
+    const mock = requireMock(received, "toHaveRunAction");
+    const runs = mock.calls.actions.filter((run) => run.actionId === actionId);
+    const pass = input === void 0 ? runs.length > 0 : runs.some((run) => same(run.input, input));
+    return {
+      pass,
+      message: () => pass ? `Expected tap.actions.run("${actionId}") not to be called.` : `Expected tap.actions.run("${actionId}"${input === void 0 ? "" : `, ${JSON.stringify(input)}`}). Runs recorded: ${mock.calls.actions.length === 0 ? "none" : JSON.stringify(mock.calls.actions)}.`
+    };
+  },
+  /**
+   * Passes when the mock's storage holds a document deep-equal to that one in
+   * that collection.
+   */
+  toHaveStored(received, collection, document2) {
+    const mock = requireMock(received, "toHaveStored");
+    const stored = mock.documents(collection);
+    const pass = stored.some((candidate) => same(candidate, document2));
+    return {
+      pass,
+      message: () => pass ? `Expected "${collection}" not to hold ${JSON.stringify(document2)}.` : `Expected "${collection}" to hold ${JSON.stringify(document2)}. It holds: ${stored.length === 0 ? "nothing" : JSON.stringify(stored)}.`
+    };
+  }
+};
+function registerTapMatchers(target) {
+  target.extend(tapMatchers);
+}
+
+
+
+
+
+
+exports.installHostTheme = installHostTheme; exports.clearTapPortals = clearTapPortals; exports.tapMatchers = tapMatchers; exports.registerTapMatchers = registerTapMatchers;
+//# sourceMappingURL=chunk-3YWVYA42.cjs.map

package/dist/chunk-3YWVYA42.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/chunk-3YWVYA42.cjs","../src/testing/environment.ts","../src/testing/matchers.ts"],"names":[],"mappings":"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","file":"/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/chunk-3YWVYA42.cjs","sourcesContent":[null,"const HOST_THEME: Record<string, string> = {\n  '--bg-base': '#ffffff',\n  '--bg-subtle': 'rgba(18, 18, 18, 0.04)',\n  '--bg-raised': '#ffffff',\n  '--fg-default': '#121212',\n  '--fg-muted': 'rgba(18, 18, 18, 0.6)',\n  '--fg-inverse': '#ffffff',\n  '--tap-accent': '#4f46e5',\n  '--tap-accent-fg': '#ffffff',\n  '--tap-danger': '#b42318',\n  '--tap-scrim': 'rgba(18, 18, 18, 0.7)',\n  '--tap-radius': '6px',\n  '--tap-space': '8px',\n  '--font-sans': 'system-ui, -apple-system, sans-serif',\n  '--font-mono': 'ui-monospace, SFMono-Regular, monospace',\n  '--divider': 'rgba(18, 18, 18, 0.12)',\n};\n\n/**\n * Sets the host's fifteen CSS variables on an element, so a component renders in\n * a test the way it renders in the host.\n *\n * @remarks\n * Sets the light values as inline custom properties, which inherit into everything\n * below the element. The vitest and jest presets call it on\n * `document.documentElement` for you, so call it yourself only in a test that\n * renders outside `renderWithTap` or wants the variables on one subtree. It sets\n * no dark values; drive the mode through `renderWithTap`'s `theme` option, which\n * is what `useTapTheme` reads.\n *\n * @example\n * ```ts\n * import { installHostTheme } from '@tappify/extension-sdk/testing';\n *\n * function mountRoot(): HTMLElement {\n *   const root = document.createElement('div');\n *   installHostTheme(root);\n *   document.body.append(root);\n *   return root;\n * }\n * ```\n */\nexport function installHostTheme(root: HTMLElement): void {\n  for (const [name, value] of Object.entries(HOST_THEME)) {\n    root.style.setProperty(name, value);\n  }\n}\n\nexport function clearTapPortals(root: ParentNode = document): void {\n  for (const node of root.querySelectorAll('[data-tap-portal]')) node.remove();\n}\n","import { TapError } from '../client/errors';\nimport type { TapMock } from './mock';\n\n/** What each matcher returns, in the shape vitest and jest both read. */\nexport interface MatcherResult {\n  pass: boolean;\n  /** Built only when the runner reports, and worded for both `expect` and `not`. */\n  message(): string;\n}\n\n/** The part of a runner's `expect` that `registerTapMatchers` needs. */\nexport interface MatcherTarget {\n  /** Both runners take a map of matcher functions keyed by matcher name. */\n  extend(matchers: Record<string, unknown>): void;\n}\n\nfunction isMock(value: unknown): value is TapMock {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'calls' in value &&\n    'documents' in value &&\n    typeof value.documents === 'function'\n  );\n}\n\nfunction requireMock(value: unknown, matcher: string): TapMock {\n  if (isMock(value)) return value;\n  throw new TapError(\n    'TAP_TEST_TARGET_INVALID',\n    `${matcher}() takes the mock renderWithTap() returned. Call it as expect(mock).${matcher}(…), not on the component or the tap object.`,\n  );\n}\n\nfunction tagOf(value: unknown): string {\n  return Object.prototype.toString.call(value);\n}\n\nfunction sameList(left: unknown[], right: unknown[]): boolean {\n  return (\n    left.length === right.length &&\n    left.every((item, index) => same(item, right[index]))\n  );\n}\n\nfunction bytesOf(view: ArrayBufferView): number[] {\n  return [...new Uint8Array(view.buffer, view.byteOffset, view.byteLength)];\n}\n\nfunction same(left: unknown, right: unknown): boolean {\n  if (Object.is(left, right)) return true;\n\n  const tag = tagOf(left);\n  if (tag !== tagOf(right)) return false;\n\n  if (\n    typeof left !== 'object' ||\n    typeof right !== 'object' ||\n    left === null ||\n    right === null\n  ) {\n    return false;\n  }\n\n  if (left instanceof Date && right instanceof Date) {\n    return left.valueOf() === right.valueOf();\n  }\n  if (left instanceof RegExp && right instanceof RegExp) {\n    return left.source === right.source && left.flags === right.flags;\n  }\n  if (left instanceof Map && right instanceof Map) {\n    return sameList([...left.entries()], [...right.entries()]);\n  }\n  if (left instanceof Set && right instanceof Set) {\n    return sameList([...left.values()], [...right.values()]);\n  }\n  if (ArrayBuffer.isView(left) && ArrayBuffer.isView(right)) {\n    return sameList(bytesOf(left), bytesOf(right));\n  }\n  if (Array.isArray(left) && Array.isArray(right)) {\n    return sameList(left, right);\n  }\n  if (tag !== '[object Object]') return false;\n\n  const keys = Object.keys(left);\n  return (\n    keys.length === Object.keys(right).length &&\n    keys.every(\n      key =>\n        key in right && same(Reflect.get(left, key), Reflect.get(right, key)),\n    )\n  );\n}\n\n/**\n * The four matchers that assert on what a component asked the host to do.\n *\n * @remarks\n * Each takes the mock `renderWithTap` returns, so the assertion is\n * `expect(mock).toHaveToasted(…)` rather than `expect(component)`; anything else\n * throws a `TapError` carrying `TAP_TEST_TARGET_INVALID`. A failure names every\n * call that was recorded, so a wrong path or message reads without a debugger. The\n * vitest and jest presets register these, and both declare the four on the runner's\n * own `Matchers` interface, so `expect(mock).toHaveToasted` typechecks once the\n * preset is in the setup files.\n *\n * @example\n * ```ts\n * import '@tappify/extension-sdk/testing/vitest';\n * import { createTapMock } from '@tappify/extension-sdk/testing';\n * import { expect, it } from 'vitest';\n *\n * it('toasts when a release ships', () => {\n *   const mock = createTapMock();\n *   mock.tap.ui.toast('A release shipped', 'neutral');\n *   expect(mock).toHaveToasted('A release shipped');\n * });\n * ```\n */\nexport const tapMatchers = {\n  /** Passes when `tap.nav.push` was called with exactly that path. */\n  toHaveNavigatedTo(received: unknown, path: string): MatcherResult {\n    const mock = requireMock(received, 'toHaveNavigatedTo');\n    const pass = mock.calls.navigations.includes(path);\n    return {\n      pass,\n      message: () =>\n        pass\n          ? `Expected no navigation to ${path}, but tap.nav.push was called with it.`\n          : `Expected a navigation to ${path}. tap.nav.push was called with: ${\n              mock.calls.navigations.length === 0\n                ? 'nothing'\n                : mock.calls.navigations.join(', ')\n            }.`,\n    };\n  },\n\n  /** Passes when a toast matched the string exactly, or the pattern anywhere. */\n  toHaveToasted(received: unknown, expected: string | RegExp): MatcherResult {\n    const mock = requireMock(received, 'toHaveToasted');\n    const messages = mock.calls.toasts.map(toast => toast.message);\n    const pass = messages.some(message =>\n      typeof expected === 'string'\n        ? message === expected\n        : expected.test(message),\n    );\n    return {\n      pass,\n      message: () =>\n        pass\n          ? `Expected no toast matching ${String(expected)}, but one was shown.`\n          : `Expected a toast matching ${String(expected)}. Toasts shown: ${\n              messages.length === 0 ? 'none' : messages.join(' | ')\n            }.`,\n    };\n  },\n\n  /**\n   * Passes when `tap.actions.run` was called with that action, and with input\n   * deep-equal to `input` when one is given.\n   */\n  toHaveRunAction(\n    received: unknown,\n    actionId: string,\n    input?: unknown,\n  ): MatcherResult {\n    const mock = requireMock(received, 'toHaveRunAction');\n    const runs = mock.calls.actions.filter(run => run.actionId === actionId);\n    const pass =\n      input === undefined\n        ? runs.length > 0\n        : runs.some(run => same(run.input, input));\n    return {\n      pass,\n      message: () =>\n        pass\n          ? `Expected tap.actions.run(\"${actionId}\") not to be called.`\n          : `Expected tap.actions.run(\"${actionId}\"${\n              input === undefined ? '' : `, ${JSON.stringify(input)}`\n            }). Runs recorded: ${\n              mock.calls.actions.length === 0\n                ? 'none'\n                : JSON.stringify(mock.calls.actions)\n            }.`,\n    };\n  },\n\n  /**\n   * Passes when the mock's storage holds a document deep-equal to that one in\n   * that collection.\n   */\n  toHaveStored(\n    received: unknown,\n    collection: string,\n    document: unknown,\n  ): MatcherResult {\n    const mock = requireMock(received, 'toHaveStored');\n    const stored = mock.documents(collection);\n    const pass = stored.some(candidate => same(candidate, document));\n    return {\n      pass,\n      message: () =>\n        pass\n          ? `Expected \"${collection}\" not to hold ${JSON.stringify(document)}.`\n          : `Expected \"${collection}\" to hold ${JSON.stringify(document)}. It holds: ${\n              stored.length === 0 ? 'nothing' : JSON.stringify(stored)\n            }.`,\n    };\n  },\n};\n\n/**\n * Registers the four matchers on a runner's `expect`.\n *\n * @remarks\n * The vitest and jest presets call this, so a suite that loads\n * `@tappify/extension-sdk/testing/vitest` or `.../testing/jest` as a setup file\n * needs nothing else. Call it yourself only in a suite that does not use a preset,\n * and once — registering twice replaces the same four names. It adds no types of\n * its own, so a suite without a preset declares the four on the runner's `Matchers`\n * interface itself.\n *\n * @example\n * ```ts\n * import { registerTapMatchers } from '@tappify/extension-sdk/testing';\n * import { expect } from 'vitest';\n *\n * registerTapMatchers(expect);\n * ```\n */\nexport function registerTapMatchers(target: MatcherTarget): void {\n  target.extend(tapMatchers);\n}\n"]}

package/dist/chunk-4C5Z3CIK.mjs

@@ -0,0 +1,26 @@
+import {
+  TapContext
+} from "./chunk-QHM7XNRK.mjs";
+
+// src/host/provider.tsx
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { jsx } from "react/jsx-runtime";
+function TapHostProvider({
+  tap,
+  children,
+  queryClient
+}) {
+  const provided = /* @__PURE__ */ jsx(TapContext.Provider, { value: tap, children });
+  return queryClient === void 0 ? provided : /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children: provided });
+}
+function createHostQueryClient() {
+  return new QueryClient({
+    defaultOptions: { queries: { retry: false } }
+  });
+}
+
+export {
+  TapHostProvider,
+  createHostQueryClient
+};
+//# sourceMappingURL=chunk-4C5Z3CIK.mjs.map

package/dist/chunk-4C5Z3CIK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host/provider.tsx"],"sourcesContent":["import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\nimport type { ReactElement, ReactNode } from 'react';\nimport { TapContext } from '../client/context';\nimport type { Tap } from '../client/types';\n\nexport interface TapHostProviderProps {\n  tap: Tap;\n  children: ReactNode;\n  /**\n   * A host that already renders a QueryClientProvider leaves this out; a\n   * standalone host such as the portal preview passes one from\n   * `createHostQueryClient()` so the data hooks find a client.\n   */\n  queryClient?: QueryClient;\n}\n\nexport function TapHostProvider({\n  tap,\n  children,\n  queryClient,\n}: TapHostProviderProps): ReactElement {\n  const provided = (\n    <TapContext.Provider value={tap}>{children}</TapContext.Provider>\n  );\n\n  return queryClient === undefined ? (\n    provided\n  ) : (\n    <QueryClientProvider client={queryClient}>{provided}</QueryClientProvider>\n  );\n}\n\n/** The query client a standalone host hands to `TapHostProvider`; reads never retry. */\nexport function createHostQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: { queries: { retry: false } },\n  });\n}\n"],"mappings":";;;;;AAAA,SAAS,aAAa,2BAA2B;AAsB7C;AANG,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AACrC,QAAM,WACJ,oBAAC,WAAW,UAAX,EAAoB,OAAO,KAAM,UAAS;AAG7C,SAAO,gBAAgB,SACrB,WAEA,oBAAC,uBAAoB,QAAQ,aAAc,oBAAS;AAExD;AAGO,SAAS,wBAAqC;AACnD,SAAO,IAAI,YAAY;AAAA,IACrB,gBAAgB,EAAE,SAAS,EAAE,OAAO,MAAM,EAAE;AAAA,EAC9C,CAAC;AACH;","names":[]}

package/dist/chunk-5AAPD5WV.cjs

@@ -0,0 +1,250 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkOPPYEA7Fcjs = require('./chunk-OPPYEA7F.cjs');
+
+
+var _chunk2DBSVKAUcjs = require('./chunk-2DBSVKAU.cjs');
+
+// src/client/hooks.ts
+var _react = require('react');
+function useTapSlice(key, select) {
+  const tap = _chunkOPPYEA7Fcjs.useTap.call(void 0, );
+  const subscribe = _react.useCallback.call(void 0, 
+    (listener) => tap.__subscribe(key, listener),
+    [tap, key]
+  );
+  const snapshot = _react.useCallback.call(void 0, () => select(tap), [tap, select]);
+  return _react.useSyncExternalStore.call(void 0, subscribe, snapshot, snapshot);
+}
+var selectAuth = (tap) => tap.auth;
+var selectProject = (tap) => tap.project;
+var selectFilters = (tap) => tap.filters;
+var selectTheme = (tap) => tap.theme;
+var selectSize = (tap) => tap.ui.size;
+var selectParams = (tap) => tap.params;
+var selectContext = (tap) => tap.context;
+function useTapAuth() {
+  return useTapSlice("auth", selectAuth);
+}
+function useTapProject() {
+  return useTapSlice("project", selectProject);
+}
+function useTapFilters() {
+  return useTapSlice("filters", selectFilters);
+}
+function useTapTheme() {
+  return useTapSlice("theme", selectTheme);
+}
+function useTapSize() {
+  return useTapSlice("size", selectSize);
+}
+function useTapParams() {
+  return useTapSlice("params", selectParams);
+}
+function useTapContext() {
+  return useTapSlice("context", selectContext);
+}
+function useTapState(key) {
+  const tap = _chunkOPPYEA7Fcjs.useTap.call(void 0, );
+  const subscribe = _react.useCallback.call(void 0, 
+    (listener) => tap.__subscribe(`state:${key}`, listener),
+    [tap, key]
+  );
+  const snapshot = _react.useCallback.call(void 0, () => tap.state.get(key), [tap, key]);
+  const set = _react.useCallback.call(void 0, 
+    (value2) => {
+      tap.state.set(key, value2);
+    },
+    [tap, key]
+  );
+  const value = _react.useSyncExternalStore.call(void 0, subscribe, snapshot, snapshot);
+  return [value, set];
+}
+
+// src/client/query.ts
+
+
+
+var _reactquery = require('@tanstack/react-query');
+
+var STALE_TIME_MS = 3e4;
+function dataQueryKey(installId, query, filters) {
+  return ["ext", installId, "data", query, filters];
+}
+function procedureQueryKey(installId, name, input, filters) {
+  return ["ext", installId, "proc", name, input, filters];
+}
+function storageQueryKey(installId, collection) {
+  return ["ext", installId, "storage", collection];
+}
+function installPrefix(installId) {
+  return ["ext", installId];
+}
+function procedurePrefix(installId, name) {
+  return ["ext", installId, "proc", name];
+}
+function useInvalidateOn(tap, client, queryKey, events) {
+  const eventsRef = _react.useRef.call(void 0, events);
+  const keyRef = _react.useRef.call(void 0, queryKey);
+  _react.useEffect.call(void 0, () => {
+    eventsRef.current = events;
+    keyRef.current = queryKey;
+  });
+  const eventSignature = (_nullishCoalesce(events, () => ( []))).join(",");
+  _react.useEffect.call(void 0, () => {
+    const names = _nullishCoalesce(eventsRef.current, () => ( []));
+    if (names.length === 0) return;
+    const unsubscribes = names.map(
+      (name) => tap.data.subscribe(name, () => {
+        void client.invalidateQueries({ queryKey: keyRef.current });
+      })
+    );
+    return () => {
+      for (const unsubscribe of unsubscribes) unsubscribe();
+    };
+  }, [tap, client, eventSignature]);
+}
+function useHostQueryClient() {
+  try {
+    return _reactquery.useQueryClient.call(void 0, );
+  } catch (e) {
+    throw new (0, _chunk2DBSVKAUcjs.TapError)(
+      "TAP_NO_QUERY_CLIENT",
+      "The Tappify host provides the query client. This hook runs only inside a Tappify mount \u2014 render the component from an entry declared in tappify.extension.json, or wrap it in renderWithTap() from @tappify/extension-sdk/testing."
+    );
+  }
+}
+function useTapQuery(query, options = {}) {
+  const tap = _chunkOPPYEA7Fcjs.useTap.call(void 0, );
+  const client = useHostQueryClient();
+  const filters = useTapFilters();
+  const queryKey = dataQueryKey(tap.extension.installId, query, filters);
+  const result = _reactquery.useQuery.call(void 0, {
+    queryKey,
+    queryFn: () => tap.data.query(query),
+    enabled: _nullishCoalesce(options.enabled, () => ( true)),
+    staleTime: STALE_TIME_MS,
+    retry: false
+  });
+  useInvalidateOn(tap, client, queryKey, options.invalidateOn);
+  const resultRefetch = result.refetch;
+  const refetch = _react.useCallback.call(void 0, () => {
+    void resultRefetch();
+  }, [resultRefetch]);
+  return {
+    data: result.data,
+    error: result.error,
+    isLoading: result.isLoading,
+    refetch
+  };
+}
+function useTapServer(name, input, options = {}) {
+  const tap = _chunkOPPYEA7Fcjs.useTap.call(void 0, );
+  const client = useHostQueryClient();
+  const filters = useTapFilters();
+  const queryKey = procedureQueryKey(
+    tap.extension.installId,
+    name,
+    input,
+    filters
+  );
+  const procedure = tap.server[name];
+  if (typeof procedure !== "function") {
+    throw new (0, _chunk2DBSVKAUcjs.TapError)(
+      "TAP_UNKNOWN_PROCEDURE",
+      `Procedure "${name}" is not declared. Add it under server.procedures in tappify.extension.json, then run \`tappify extension types\`.`
+    );
+  }
+  const result = _reactquery.useQuery.call(void 0, {
+    queryKey,
+    queryFn: () => procedure(input),
+    enabled: _nullishCoalesce(options.enabled, () => ( true)),
+    staleTime: STALE_TIME_MS,
+    retry: false
+  });
+  useInvalidateOn(tap, client, queryKey, options.invalidateOn);
+  const resultRefetch = result.refetch;
+  const refetch = _react.useCallback.call(void 0, () => {
+    void resultRefetch();
+  }, [resultRefetch]);
+  return {
+    data: result.data,
+    error: result.error,
+    isLoading: result.isLoading,
+    refetch
+  };
+}
+function isSingletonHandle(value) {
+  return typeof value === "object" && value !== null && "get" in value && "set" in value && "patch" in value && typeof value.get === "function" && typeof value.set === "function" && typeof value.patch === "function";
+}
+function asSingleton(handle, collection) {
+  if (isSingletonHandle(handle)) return handle;
+  throw new (0, _chunk2DBSVKAUcjs.TapError)(
+    "TAP_UNKNOWN_COLLECTION",
+    `useTapStorage("${collection}") reads a singleton collection. Declare it with "singleton": true in tappify.extension.json, or read an id-keyed collection with tap.storage.${collection}.list().`
+  );
+}
+function useTapStorage(collection) {
+  const tap = _chunkOPPYEA7Fcjs.useTap.call(void 0, );
+  const client = useHostQueryClient();
+  const queryKey = storageQueryKey(tap.extension.installId, collection);
+  const handle = asSingleton(tap.storage[collection], collection);
+  const result = _reactquery.useQuery.call(void 0, {
+    queryKey,
+    queryFn: () => handle.get(),
+    staleTime: STALE_TIME_MS,
+    retry: false
+  });
+  const installId = tap.extension.installId;
+  const invalidate = _react.useCallback.call(void 0, () => {
+    void client.invalidateQueries({
+      queryKey: storageQueryKey(installId, collection)
+    });
+  }, [client, installId, collection]);
+  _react.useEffect.call(void 0, 
+    () => tap.__subscribe(`storage:${collection}`, invalidate),
+    [tap, collection, invalidate]
+  );
+  const save = _react.useCallback.call(void 0, 
+    async (document) => {
+      await handle.set(document);
+    },
+    [handle]
+  );
+  const patch = _react.useCallback.call(void 0, 
+    async (partial) => handle.patch(partial),
+    [handle]
+  );
+  const resultRefetch = result.refetch;
+  const refetch = _react.useCallback.call(void 0, () => {
+    void resultRefetch();
+  }, [resultRefetch]);
+  return {
+    data: result.data,
+    error: result.error,
+    isLoading: result.isLoading,
+    refetch,
+    save,
+    patch
+  };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.useTapAuth = useTapAuth; exports.useTapProject = useTapProject; exports.useTapFilters = useTapFilters; exports.useTapTheme = useTapTheme; exports.useTapSize = useTapSize; exports.useTapParams = useTapParams; exports.useTapContext = useTapContext; exports.useTapState = useTapState; exports.dataQueryKey = dataQueryKey; exports.procedureQueryKey = procedureQueryKey; exports.storageQueryKey = storageQueryKey; exports.installPrefix = installPrefix; exports.procedurePrefix = procedurePrefix; exports.useTapQuery = useTapQuery; exports.useTapServer = useTapServer; exports.useTapStorage = useTapStorage;
+//# sourceMappingURL=chunk-5AAPD5WV.cjs.map

package/dist/chunk-5AAPD5WV.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/chunk-5AAPD5WV.cjs","../src/client/hooks.ts","../src/client/query.ts"],"names":["useCallback"],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACPA,8BAAkD;AAIlD,SAAS,WAAA,CAAe,GAAA,EAAmB,MAAA,EAA4B;AACrE,EAAA,MAAM,IAAA,EAAM,sCAAA,CAAO;AAEnB,EAAA,MAAM,UAAA,EAAY,gCAAA;AAAA,IAChB,CAAC,QAAA,EAAA,GAAyB,GAAA,CAAI,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAA;AAAA,IACvD,CAAC,GAAA,EAAK,GAAG;AAAA,EACX,CAAA;AACA,EAAA,MAAM,SAAA,EAAW,gCAAA,CAAY,EAAA,GAAM,MAAA,CAAO,GAAG,CAAA,EAAG,CAAC,GAAA,EAAK,MAAM,CAAC,CAAA;AAE7D,EAAA,OAAO,yCAAA,SAAqB,EAAW,QAAA,EAAU,QAAQ,CAAA;AAC3D;AAEA,IAAM,WAAA,EAAa,CAAC,GAAA,EAAA,GAA0B,GAAA,CAAI,IAAA;AAClD,IAAM,cAAA,EAAgB,CAAC,GAAA,EAAA,GAA6B,GAAA,CAAI,OAAA;AACxD,IAAM,cAAA,EAAgB,CAAC,GAAA,EAAA,GAAyB,GAAA,CAAI,OAAA;AACpD,IAAM,YAAA,EAAc,CAAC,GAAA,EAAA,GAA2B,GAAA,CAAI,KAAA;AACpD,IAAM,WAAA,EAAa,CAAC,GAAA,EAAA,GAAsB,GAAA,CAAI,EAAA,CAAG,IAAA;AACjD,IAAM,aAAA,EAAe,CAAC,GAAA,EAAA,GAAqC,GAAA,CAAI,MAAA;AAC/D,IAAM,cAAA,EAAgB,CAAC,GAAA,EAAA,GAAsC,GAAA,CAAI,OAAA;AAwB1D,SAAS,UAAA,CAAA,EAA0B;AACxC,EAAA,OAAO,WAAA,CAAY,MAAA,EAAQ,UAAU,CAAA;AACvC;AAqBO,SAAS,aAAA,CAAA,EAAgC;AAC9C,EAAA,OAAO,WAAA,CAAY,SAAA,EAAW,aAAa,CAAA;AAC7C;AA0BO,SAAS,aAAA,CAAA,EAA4B;AAC1C,EAAA,OAAO,WAAA,CAAY,SAAA,EAAW,aAAa,CAAA;AAC7C;AAsBO,SAAS,WAAA,CAAA,EAA4B;AAC1C,EAAA,OAAO,WAAA,CAAY,OAAA,EAAS,WAAW,CAAA;AACzC;AA8BO,SAAS,UAAA,CAAA,EAAsB;AACpC,EAAA,OAAO,WAAA,CAAY,MAAA,EAAQ,UAAU,CAAA;AACvC;AAuBO,SAAS,YAAA,CAAA,EAAuC;AACrD,EAAA,OAAO,WAAA,CAAY,QAAA,EAAU,YAAY,CAAA;AAC3C;AAsBO,SAAS,aAAA,CAAA,EAAyC;AACvD,EAAA,OAAO,WAAA,CAAY,SAAA,EAAW,aAAa,CAAA;AAC7C;AA4BO,SAAS,WAAA,CACd,GAAA,EACqC;AACrC,EAAA,MAAM,IAAA,EAAM,sCAAA,CAAO;AAEnB,EAAA,MAAM,UAAA,EAAY,gCAAA;AAAA,IAChB,CAAC,QAAA,EAAA,GAAyB,GAAA,CAAI,WAAA,CAAY,CAAA,MAAA,EAAS,GAAG,CAAA,CAAA;AAC7C,IAAA;AACX,EAAA;AAC6C,EAAA;AACjC,EAAA;AACI,IAAA;AACY,MAAA;AAC1B,IAAA;AACS,IAAA;AACX,EAAA;AAEmC,EAAA;AACjB,EAAA;AACpB;AD7L+C;AACA;AE/D/C;AACE;AACA;AAEK;AACe;AAkBA;AAuDpB;AAEyC,EAAA;AAC3C;AAwBE;AAGwC,EAAA;AAC1C;AAkBE;AAEqC,EAAA;AACvC;AAe4D;AAClC,EAAA;AAC1B;AAgB4E;AACpC,EAAA;AACxC;AAKE;AAG+B,EAAA;AACD,EAAA;AAEd,EAAA;AACM,IAAA;AACH,IAAA;AAClB,EAAA;AAE0C,EAAA;AAE3B,EAAA;AACsB,IAAA;AACZ,IAAA;AAEG,IAAA;AACM,MAAA;AACG,QAAA;AACjC,MAAA;AACH,IAAA;AAEa,IAAA;AAC6B,MAAA;AAC1C,IAAA;AAC8B,EAAA;AAClC;AAE2C;AACrC,EAAA;AACoB,IAAA;AAChB,EAAA;AACI,IAAA;AACR,MAAA;AACA,MAAA;AACF,IAAA;AACF,EAAA;AACF;AAuDgC;AACX,EAAA;AACe,EAAA;AACJ,EAAA;AACc,EAAA;AAEpB,EAAA;AACtB,IAAA;AACmC,IAAA;AACP,IAAA;AACjB,IAAA;AACJ,IAAA;AACR,EAAA;AAEsC,EAAA;AAEV,EAAA;AACK,EAAA;AACb,IAAA;AACH,EAAA;AAEX,EAAA;AACQ,IAAA;AACC,IAAA;AACI,IAAA;AAClB,IAAA;AACF,EAAA;AACF;AAoC8B;AAET,EAAA;AACe,EAAA;AACJ,EAAA;AACb,EAAA;AACD,IAAA;AACd,IAAA;AACA,IAAA;AACA,IAAA;AACF,EAAA;AACiC,EAAA;AAEI,EAAA;AACzB,IAAA;AACR,MAAA;AACkB,MAAA;AACpB,IAAA;AACF,EAAA;AAEwB,EAAA;AACtB,IAAA;AAC8B,IAAA;AACF,IAAA;AACjB,IAAA;AACJ,IAAA;AACR,EAAA;AAEsC,EAAA;AAEV,EAAA;AACK,EAAA;AACb,IAAA;AACH,EAAA;AAEX,EAAA;AACQ,IAAA;AACC,IAAA;AACI,IAAA;AAClB,IAAA;AACF,EAAA;AACF;AAEwE;AAGpE,EAAA;AAQJ;AAE8E;AACnC,EAAA;AAE/B,EAAA;AACR,IAAA;AAC4B,IAAA;AAC9B,EAAA;AACF;AAkC6C;AAGxB,EAAA;AACe,EAAA;AACG,EAAA;AACY,EAAA;AAEzB,EAAA;AACtB,IAAA;AAC0B,IAAA;AACf,IAAA;AACJ,IAAA;AACR,EAAA;AAE+B,EAAA;AACK,EAAA;AACL,IAAA;AACS,MAAA;AACtC,IAAA;AAC+B,EAAA;AAElC,EAAA;AAC6C,IAAA;AACf,IAAA;AAC9B,EAAA;AAEaA,EAAAA;AACmB,IAAA;AACH,MAAA;AAC3B,IAAA;AACO,IAAA;AACT,EAAA;AAEcA,EAAAA;AAC8C,IAAA;AACnD,IAAA;AACT,EAAA;AAE6B,EAAA;AACK,EAAA;AACb,IAAA;AACH,EAAA;AAEX,EAAA;AACQ,IAAA;AACC,IAAA;AACI,IAAA;AAClB,IAAA;AACA,IAAA;AACA,IAAA;AACF,EAAA;AACF;AFrP+C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/chunk-5AAPD5WV.cjs","sourcesContent":[null,"import { useCallback, useSyncExternalStore } from 'react';\nimport { useTap } from './context';\nimport type { Tap, TapChangeKey, TapFilters, TapSize } from './types';\n\nfunction useTapSlice<T>(key: TapChangeKey, select: (tap: Tap) => T): T {\n  const tap = useTap();\n\n  const subscribe = useCallback(\n    (listener: () => void) => tap.__subscribe(key, listener),\n    [tap, key],\n  );\n  const snapshot = useCallback(() => select(tap), [tap, select]);\n\n  return useSyncExternalStore(subscribe, snapshot, snapshot);\n}\n\nconst selectAuth = (tap: Tap): Tap['auth'] => tap.auth;\nconst selectProject = (tap: Tap): Tap['project'] => tap.project;\nconst selectFilters = (tap: Tap): TapFilters => tap.filters;\nconst selectTheme = (tap: Tap): Tap['theme'] => tap.theme;\nconst selectSize = (tap: Tap): TapSize => tap.ui.size;\nconst selectParams = (tap: Tap): Record<string, string> => tap.params;\nconst selectContext = (tap: Tap): Record<string, unknown> => tap.context;\n\n/**\n * Returns the install token, the signed-in teammate, the workspace id, the\n * granted scopes and `can(scope)`.\n *\n * @remarks\n * Re-renders the component when the host rotates the install token, and when the\n * signed-in teammate's role arrives after the mount. `scopes` and `can` report the\n * grant the mount was built with. Throws `TAP_OUTSIDE_HOST` outside a mount.\n *\n * @example\n * ```tsx\n * import { TapEmptyState, useTapAuth } from '@tappify/extension-sdk';\n *\n * function RevenuePanel() {\n *   const auth = useTapAuth();\n *   if (!auth.can('revenue:read')) {\n *     return <TapEmptyState title=\"Revenue is not shared with this extension\" />;\n *   }\n *   return <span>Signed in as {auth.user.id}</span>;\n * }\n * ```\n */\nexport function useTapAuth(): Tap['auth'] {\n  return useTapSlice('auth', selectAuth);\n}\n\n/**\n * Returns the project the mount renders in, with its apps, releases and tracked\n * keywords.\n *\n * @remarks\n * Re-renders when the host loads or reloads the project. Throws\n * `TAP_OUTSIDE_HOST` outside a mount. An extension installed on the workspace\n * rather than a project still renders inside one project at a time.\n *\n * @example\n * ```tsx\n * import { useTapProject } from '@tappify/extension-sdk';\n *\n * function Platforms() {\n *   const project = useTapProject();\n *   return <span>{project.name} ships to {project.platforms.join(' and ')}</span>;\n * }\n * ```\n */\nexport function useTapProject(): Tap['project'] {\n  return useTapSlice('project', selectProject);\n}\n\n/**\n * Returns the date range, platform and country the owner's filter bar is set to.\n *\n * @remarks\n * Re-renders on every filter change, which is how a surface follows the owner's\n * picker. Pass `range` into a `series`, `reviews`, `crashes` or `revenue` query\n * yourself; the host adds only the country to a data read, while a procedure call\n * carries all three. Throws `TAP_OUTSIDE_HOST` outside a mount.\n *\n * @example\n * ```tsx\n * import { useTapFilters, useTapQuery } from '@tappify/extension-sdk';\n *\n * function Downloads() {\n *   const filters = useTapFilters();\n *   const downloads = useTapQuery({\n *     kind: 'series',\n *     metric: 'downloads',\n *     range: filters.range,\n *   });\n *   return <span>{downloads.data?.points.length ?? 0} days</span>;\n * }\n * ```\n */\nexport function useTapFilters(): TapFilters {\n  return useTapSlice('filters', selectFilters);\n}\n\n/**\n * Returns the mode the host is drawing in, as `{ mode: 'light' | 'dark' }`.\n *\n * @remarks\n * Re-renders when the owner switches theme. The host's CSS variables already\n * follow the theme, so reach for this only where a component has to branch in\n * code rather than restyle, such as a chart's series colours. Throws\n * `TAP_OUTSIDE_HOST` outside a mount.\n *\n * @example\n * ```tsx\n * import { useTapTheme } from '@tappify/extension-sdk';\n *\n * function SeriesLine() {\n *   const theme = useTapTheme();\n *   const stroke = theme.mode === 'dark' ? '#a5b4fc' : '#4f46e5';\n *   return <svg><line x1=\"0\" y1=\"0\" x2=\"40\" y2=\"10\" stroke={stroke} /></svg>;\n * }\n * ```\n */\nexport function useTapTheme(): Tap['theme'] {\n  return useTapSlice('theme', selectTheme);\n}\n\n/**\n * Returns how much room the mount has: `slot`, `panel` or `page`.\n *\n * @remarks\n * Expanding a widget mounts a second copy of the component in the panel rather\n * than resizing the one in the slot, so the change this hook reports is the\n * panel's own Widen and Narrow toggle moving between `panel` and `page`. Size\n * against the mount with a container query where CSS can do the work; this hook is\n * for the cases that need different markup. Throws `TAP_OUTSIDE_HOST` outside a\n * mount.\n *\n * @example\n * ```tsx\n * import { TapTable, useTapSize } from '@tappify/extension-sdk';\n *\n * function Keywords({ rows }: { rows: { term: string }[] }) {\n *   const size = useTapSize();\n *   const shown = size === 'slot' ? rows.slice(0, 3) : rows;\n *   return (\n *     <TapTable\n *       columns={[{ key: 'term', label: 'Term' }]}\n *       rows={shown}\n *       rowKey={row => row.term}\n *     />\n *   );\n * }\n * ```\n */\nexport function useTapSize(): TapSize {\n  return useTapSlice('size', selectSize);\n}\n\n/**\n * Returns the route of the extension's own page: the page id, the whole sub-path,\n * and one key per segment.\n *\n * @remarks\n * The host builds `pageId`, `path` and then `0`, `1` and so on, one per segment of\n * the sub-path. Only a page entry is routed, so this is empty for a widget, a tab,\n * a row action and a settings panel. Re-renders when the owner navigates inside the\n * page. Throws `TAP_OUTSIDE_HOST` outside a mount.\n *\n * @example\n * ```tsx\n * import { useTapParams } from '@tappify/extension-sdk';\n *\n * function FunnelDetail() {\n *   const params = useTapParams();\n *   const funnelId = params['1'];\n *   return <span>{funnelId ?? params.path}</span>;\n * }\n * ```\n */\nexport function useTapParams(): Record<string, string> {\n  return useTapSlice('params', selectParams);\n}\n\n/**\n * Returns what the surface handed the mount: the payload Expand carried in, or\n * the row behind a row action.\n *\n * @remarks\n * Re-renders when the host hands the mount a new context. A row action reads the\n * row from its own `row` prop as well; this hook is the same value for a\n * component further down the tree. Throws `TAP_OUTSIDE_HOST` outside a mount.\n *\n * @example\n * ```tsx\n * import { useTapContext } from '@tappify/extension-sdk';\n *\n * function ContextNote() {\n *   const context = useTapContext();\n *   const reviewId = context.reviewId;\n *   return <span>{typeof reviewId === 'string' ? reviewId : 'No review'}</span>;\n * }\n * ```\n */\nexport function useTapContext(): Record<string, unknown> {\n  return useTapSlice('context', selectContext);\n}\n\n/**\n * Returns one value from the in-memory store every mount of the install shares,\n * with a setter for it.\n *\n * @remarks\n * The value is `undefined` until something sets it, and setting it re-renders\n * every mount reading the same key, including a sibling widget and the expand\n * panel. The store lives in the browser session: it is not persisted, not shared\n * between teammates or tabs, and never reaches Tappify or your server — use\n * `useTapStorage` for a value that has to come back tomorrow. Throws\n * `TAP_OUTSIDE_HOST` outside a mount.\n *\n * @example\n * ```tsx\n * import { TapButton, useTapState } from '@tappify/extension-sdk';\n *\n * function StepPicker() {\n *   const [step, setStep] = useTapState<string>('selectedStep');\n *   return (\n *     <TapButton onClick={() => setStep('install')}>\n *       {step ?? 'Pick a step'}\n *     </TapButton>\n *   );\n * }\n * ```\n */\nexport function useTapState<T>(\n  key: string,\n): [T | undefined, (value: T) => void] {\n  const tap = useTap();\n\n  const subscribe = useCallback(\n    (listener: () => void) => tap.__subscribe(`state:${key}`, listener),\n    [tap, key],\n  );\n  const snapshot = useCallback(() => tap.state.get<T>(key), [tap, key]);\n  const set = useCallback(\n    (value: T) => {\n      tap.state.set(key, value);\n    },\n    [tap, key],\n  );\n\n  const value = useSyncExternalStore(subscribe, snapshot, snapshot);\n  return [value, set];\n}\n","import {\n  useQuery,\n  useQueryClient,\n  type QueryClient,\n} from '@tanstack/react-query';\nimport { useCallback, useEffect, useRef } from 'react';\nimport { useTap } from './context';\nimport { TapError } from './errors';\nimport { useTapFilters } from './hooks';\nimport type {\n  Tap,\n  TapFilters,\n  TapHostEvents,\n  TapProcedureInput,\n  TapProcedureName,\n  TapProcedureOutput,\n  TapQuery,\n  TapResult,\n  TapSingleton,\n  TapSingletonDocument,\n  TapSingletonName,\n} from './types';\n\nconst STALE_TIME_MS = 30_000;\n\n/** The third argument of `useTapQuery` and `useTapServer`. */\nexport interface TapQueryOptions {\n  /** Holds the call back while this is `false`. Defaults to `true`. */\n  enabled?: boolean;\n  /** Tappify events that mark this result stale and refetch it when they arrive. */\n  invalidateOn?: (keyof TapHostEvents)[];\n}\n\n/** What `useTapQuery` and `useTapServer` return. */\nexport interface TapQueryResult<T> {\n  /**\n   * `undefined` until the first answer for this key arrives. A later call that\n   * fails leaves the last answer in place and only sets `error`, so branch on\n   * `error` to detect a failure, never on `data`.\n   */\n  data: T | undefined;\n  error: Error | null;\n  /** `true` only while the first answer for this key is in flight. */\n  isLoading: boolean;\n  /** Asks again now, whether or not the cached answer has gone stale. */\n  refetch(): void;\n}\n\n/** What `useTapStorage` returns: a read of the document, plus the two writes. */\nexport interface TapStorageResult<T> extends TapQueryResult<T | null> {\n  /** Replaces the whole document. */\n  save(document: T): Promise<void>;\n  /** Merges the fields in and resolves to the merged document. */\n  patch(partial: Partial<T>): Promise<T>;\n}\n\n/**\n * Builds the cache key `useTapQuery` reads a Tappify data query under.\n *\n * @remarks\n * The key carries the install, the query and the filters behind it, so two mounts\n * asking for the same numbers share one request. Call it only to reach the query\n * cache directly; the hooks build their own keys.\n *\n * @example\n * ```ts\n * import { dataQueryKey } from '@tappify/extension-sdk';\n *\n * const key = dataQueryKey('ins_test', { kind: 'keywords' }, {\n *   range: { from: '2026-09-01', to: '2026-09-08' },\n *   platform: 'all',\n *   country: 'all',\n * });\n * ```\n */\nexport function dataQueryKey(\n  installId: string,\n  query: TapQuery,\n  filters: TapFilters,\n): unknown[] {\n  return ['ext', installId, 'data', query, filters];\n}\n\n/**\n * Builds the cache key `useTapServer` reads one procedure call under.\n *\n * @remarks\n * The input and the filters are part of the key, so the same procedure called\n * with different input caches separately. Call it only to reach the query cache\n * directly.\n *\n * @example\n * ```ts\n * import { procedureQueryKey } from '@tappify/extension-sdk';\n *\n * const key = procedureQueryKey('ins_test', 'getSummary', { days: 7 }, {\n *   range: { from: '2026-09-01', to: '2026-09-08' },\n *   platform: 'all',\n *   country: 'all',\n * });\n * ```\n */\nexport function procedureQueryKey(\n  installId: string,\n  name: string,\n  input: unknown,\n  filters: TapFilters,\n): unknown[] {\n  return ['ext', installId, 'proc', name, input, filters];\n}\n\n/**\n * Builds the cache key `useTapStorage` reads one collection's document under.\n *\n * @remarks\n * The filters are not part of the key, because a stored document does not depend\n * on them. Call it only to reach the query cache directly.\n *\n * @example\n * ```ts\n * import { storageQueryKey } from '@tappify/extension-sdk';\n *\n * const key = storageQueryKey('ins_test', 'preferences');\n * ```\n */\nexport function storageQueryKey(\n  installId: string,\n  collection: string,\n): unknown[] {\n  return ['ext', installId, 'storage', collection];\n}\n\n/**\n * Builds the key prefix every cached answer of one install sits under.\n *\n * @remarks\n * This is the prefix `tap.invalidate()` with no name invalidates.\n *\n * @example\n * ```ts\n * import { installPrefix } from '@tappify/extension-sdk';\n *\n * const prefix = installPrefix('ins_test');\n * ```\n */\nexport function installPrefix(installId: string): unknown[] {\n  return ['ext', installId];\n}\n\n/**\n * Builds the key prefix every cached call of one procedure sits under, whatever\n * its input.\n *\n * @remarks\n * This is the prefix `tap.invalidate(name)` invalidates.\n *\n * @example\n * ```ts\n * import { procedurePrefix } from '@tappify/extension-sdk';\n *\n * const prefix = procedurePrefix('ins_test', 'getSummary');\n * ```\n */\nexport function procedurePrefix(installId: string, name: string): unknown[] {\n  return ['ext', installId, 'proc', name];\n}\n\nfunction useInvalidateOn(\n  tap: Tap,\n  client: QueryClient,\n  queryKey: unknown[],\n  events: (keyof TapHostEvents)[] | undefined,\n): void {\n  const eventsRef = useRef(events);\n  const keyRef = useRef(queryKey);\n\n  useEffect(() => {\n    eventsRef.current = events;\n    keyRef.current = queryKey;\n  });\n\n  const eventSignature = (events ?? []).join(',');\n\n  useEffect(() => {\n    const names = eventsRef.current ?? [];\n    if (names.length === 0) return;\n\n    const unsubscribes = names.map(name =>\n      tap.data.subscribe(name, () => {\n        void client.invalidateQueries({ queryKey: keyRef.current });\n      }),\n    );\n\n    return () => {\n      for (const unsubscribe of unsubscribes) unsubscribe();\n    };\n  }, [tap, client, eventSignature]);\n}\n\nfunction useHostQueryClient(): QueryClient {\n  try {\n    return useQueryClient();\n  } catch {\n    throw new TapError(\n      'TAP_NO_QUERY_CLIENT',\n      'The Tappify host provides the query client. This hook runs only inside a Tappify mount — render the component from an entry declared in tappify.extension.json, or wrap it in renderWithTap() from @tappify/extension-sdk/testing.',\n    );\n  }\n}\n\n/**\n * Reads one query's worth of the owner's Tappify data, cached per install, query\n * and filter bar.\n *\n * @remarks\n * Each kind needs its own scope — `project` needs `projects:read`, `series` needs\n * `analytics:read`, `keywords` and `listing` need `store.metadata:read`, and\n * `reviews`, `crashes` and `revenue` need their own. A kind the install has not\n * granted comes back as a `TapError` with code `TAP_SCOPE_MISSING` in `error`. An\n * answer stays fresh for 30 seconds and a failed read is not retried, so\n * `refetch` is yours to call. The host adds only the country filter to the read:\n * pass `range` into a `series`, `reviews`, `crashes` or `revenue` query yourself,\n * and `platform` into a `series` query, which is the only kind that takes one.\n * Throws `TAP_NO_QUERY_CLIENT` when no Tappify mount provides the query client.\n *\n * @example\n * ```tsx\n * import { TapStat, useTapFilters, useTapQuery } from '@tappify/extension-sdk';\n *\n * function Downloads() {\n *   const filters = useTapFilters();\n *   const downloads = useTapQuery(\n *     { kind: 'series', metric: 'downloads', range: filters.range },\n *     { invalidateOn: ['release.shipped'] },\n *   );\n *   const points = downloads.data?.points ?? [];\n *   const total = points.reduce((sum, point) => sum + point.value, 0);\n *   return <TapStat label=\"Downloads\" value={total} />;\n * }\n * ```\n *\n * @example\n * ```tsx\n * import { TapTable, useTapQuery } from '@tappify/extension-sdk';\n *\n * function Keywords() {\n *   const keywords = useTapQuery({ kind: 'keywords' });\n *   return (\n *     <TapTable\n *       columns={[\n *         { key: 'term', label: 'Term' },\n *         { key: 'position', label: 'Rank', align: 'end' },\n *       ]}\n *       rows={keywords.data?.keywords ?? []}\n *       rowKey={keyword => keyword.id}\n *     />\n *   );\n * }\n * ```\n */\nexport function useTapQuery<Q extends TapQuery>(\n  query: Q,\n  options: TapQueryOptions = {},\n): TapQueryResult<TapResult<Q>> {\n  const tap = useTap();\n  const client = useHostQueryClient();\n  const filters = useTapFilters();\n  const queryKey = dataQueryKey(tap.extension.installId, query, filters);\n\n  const result = useQuery({\n    queryKey,\n    queryFn: () => tap.data.query(query),\n    enabled: options.enabled ?? true,\n    staleTime: STALE_TIME_MS,\n    retry: false,\n  });\n\n  useInvalidateOn(tap, client, queryKey, options.invalidateOn);\n\n  const resultRefetch = result.refetch;\n  const refetch = useCallback(() => {\n    void resultRefetch();\n  }, [resultRefetch]);\n\n  return {\n    data: result.data,\n    error: result.error,\n    isLoading: result.isLoading,\n    refetch,\n  };\n}\n\n/**\n * Calls one procedure on your own server, cached per install, name, input and\n * filter bar.\n *\n * @remarks\n * The name and the input are narrowed by the `TapProcedureMap` augmentation\n * `tappify extension types` writes, so a procedure the manifest does not declare\n * does not compile; at runtime a name the host has no route for throws\n * `TAP_UNKNOWN_PROCEDURE`. The call carries the whole filter bar for you. An\n * answer stays fresh for 30 seconds and a failure is not retried; an error your\n * server threw arrives as a `TapServerError` with your own `code`. Throws\n * `TAP_NO_QUERY_CLIENT` when no Tappify mount provides the query client.\n *\n * @example\n * ```tsx\n * import { TapButton, TapErrorState, useTapFilters, useTapServer } from '@tappify/extension-sdk';\n *\n * function Summary() {\n *   const filters = useTapFilters();\n *   const summary = useTapServer(\n *     'getSummary',\n *     { days: 7, platform: filters.platform },\n *     { invalidateOn: ['settings.changed'] },\n *   );\n *   if (summary.error !== null) {\n *     return <TapErrorState title=\"The summary did not load\" description={summary.error.message} />;\n *   }\n *   return <TapButton loading={summary.isLoading} onClick={summary.refetch}>Refresh</TapButton>;\n * }\n * ```\n */\nexport function useTapServer<N extends TapProcedureName>(\n  name: N,\n  input: TapProcedureInput<N>,\n  options: TapQueryOptions = {},\n): TapQueryResult<TapProcedureOutput<N>> {\n  const tap = useTap();\n  const client = useHostQueryClient();\n  const filters = useTapFilters();\n  const queryKey = procedureQueryKey(\n    tap.extension.installId,\n    name,\n    input,\n    filters,\n  );\n  const procedure = tap.server[name];\n\n  if (typeof procedure !== 'function') {\n    throw new TapError(\n      'TAP_UNKNOWN_PROCEDURE',\n      `Procedure \"${name}\" is not declared. Add it under server.procedures in tappify.extension.json, then run \\`tappify extension types\\`.`,\n    );\n  }\n\n  const result = useQuery({\n    queryKey,\n    queryFn: () => procedure(input),\n    enabled: options.enabled ?? true,\n    staleTime: STALE_TIME_MS,\n    retry: false,\n  });\n\n  useInvalidateOn(tap, client, queryKey, options.invalidateOn);\n\n  const resultRefetch = result.refetch;\n  const refetch = useCallback(() => {\n    void resultRefetch();\n  }, [resultRefetch]);\n\n  return {\n    data: result.data,\n    error: result.error,\n    isLoading: result.isLoading,\n    refetch,\n  };\n}\n\nfunction isSingletonHandle<T>(value: unknown): value is TapSingleton<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'get' in value &&\n    'set' in value &&\n    'patch' in value &&\n    typeof value.get === 'function' &&\n    typeof value.set === 'function' &&\n    typeof value.patch === 'function'\n  );\n}\n\nfunction asSingleton<T>(handle: unknown, collection: string): TapSingleton<T> {\n  if (isSingletonHandle<T>(handle)) return handle;\n\n  throw new TapError(\n    'TAP_UNKNOWN_COLLECTION',\n    `useTapStorage(\"${collection}\") reads a singleton collection. Declare it with \"singleton\": true in tappify.extension.json, or read an id-keyed collection with tap.storage.${collection}.list().`,\n  );\n}\n\n/**\n * Reads and writes the one document a singleton storage collection holds.\n *\n * @remarks\n * The argument is a collection name from the `TapStorageMap` augmentation\n * `tappify extension types` writes, and the collection has to be declared with\n * `\"singleton\": true`; an id-keyed collection throws `TAP_UNKNOWN_COLLECTION`,\n * with the `tap.storage.<name>.list()` path in the message. `data` is `undefined`\n * while the first read is in flight and `null` until the document is first\n * written. Every storage call needs the `storage:write` scope, reads included, and\n * rejects with `TAP_SCOPE_MISSING` without it. A write from another mount or\n * another browser tab of the same install refetches this one.\n *\n * @example\n * ```tsx\n * import { TapButton, useTapStorage } from '@tappify/extension-sdk';\n *\n * function CompactToggle() {\n *   const preferences = useTapStorage('preferences');\n *   return (\n *     <TapButton\n *       loading={preferences.isLoading}\n *       onClick={() => void preferences.patch({ compact: true })}\n *     >\n *       Compact\n *     </TapButton>\n *   );\n * }\n * ```\n */\nexport function useTapStorage<C extends TapSingletonName>(\n  collection: C,\n): TapStorageResult<TapSingletonDocument<C>> {\n  type Document = TapSingletonDocument<C>;\n\n  const tap = useTap();\n  const client = useHostQueryClient();\n  const queryKey = storageQueryKey(tap.extension.installId, collection);\n  const handle = asSingleton<Document>(tap.storage[collection], collection);\n\n  const result = useQuery({\n    queryKey,\n    queryFn: () => handle.get(),\n    staleTime: STALE_TIME_MS,\n    retry: false,\n  });\n\n  const installId = tap.extension.installId;\n  const invalidate = useCallback(() => {\n    void client.invalidateQueries({\n      queryKey: storageQueryKey(installId, collection),\n    });\n  }, [client, installId, collection]);\n\n  useEffect(\n    () => tap.__subscribe(`storage:${collection}`, invalidate),\n    [tap, collection, invalidate],\n  );\n\n  const save = useCallback(\n    async (document: Document) => {\n      await handle.set(document);\n    },\n    [handle],\n  );\n\n  const patch = useCallback(\n    async (partial: Partial<Document>) => handle.patch(partial),\n    [handle],\n  );\n\n  const resultRefetch = result.refetch;\n  const refetch = useCallback(() => {\n    void resultRefetch();\n  }, [resultRefetch]);\n\n  return {\n    data: result.data,\n    error: result.error,\n    isLoading: result.isLoading,\n    refetch,\n    save,\n    patch,\n  };\n}\n"]}

package/dist/chunk-7KIKOH5H.cjs

@@ -0,0 +1,26 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkOPPYEA7Fcjs = require('./chunk-OPPYEA7F.cjs');
+
+// src/host/provider.tsx
+var _reactquery = require('@tanstack/react-query');
+var _jsxruntime = require('react/jsx-runtime');
+function TapHostProvider({
+  tap,
+  children,
+  queryClient
+}) {
+  const provided = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOPPYEA7Fcjs.TapContext.Provider, { value: tap, children });
+  return queryClient === void 0 ? provided : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _reactquery.QueryClientProvider, { client: queryClient, children: provided });
+}
+function createHostQueryClient() {
+  return new (0, _reactquery.QueryClient)({
+    defaultOptions: { queries: { retry: false } }
+  });
+}
+
+
+
+
+exports.TapHostProvider = TapHostProvider; exports.createHostQueryClient = createHostQueryClient;
+//# sourceMappingURL=chunk-7KIKOH5H.cjs.map