@tappify/extension-sdk 2.0.0

package/dist/codegen.cjs

@@ -0,0 +1,300 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/codegen.ts
+var codegen_exports = {};
+__export(codegen_exports, {
+  GENERATED_HEADER: () => GENERATED_HEADER,
+  generateTypes: () => generateTypes
+});
+module.exports = __toCommonJS(codegen_exports);
+
+// src/codegen/generate.ts
+var import_json_schema_to_typescript = require("json-schema-to-typescript");
+var import_node_path = require("path");
+
+// 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);
+  }
+};
+
+// src/codegen/generate.ts
+var GENERATED_HEADER = `/* eslint-disable */
+/**
+ * Generated by \`tappify extension types\`. Do not edit by hand.
+ * Re-run the command after changing tappify.extension.json or any schema it points at.
+ */`;
+var STYLE = {
+  bracketSpacing: true,
+  printWidth: 80,
+  semi: true,
+  singleQuote: true,
+  tabWidth: 2,
+  trailingComma: "all",
+  useTabs: false
+};
+function pascal(value) {
+  return value.split(/[^A-Za-z0-9]+/).filter((part) => part !== "").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function createEmitter(resolveSchema) {
+  const used = /* @__PURE__ */ new Set();
+  const blocks = [];
+  return {
+    async declare(preferredName, schema) {
+      let name = pascal(preferredName);
+      let suffix = 2;
+      while (used.has(name)) {
+        name = `${pascal(preferredName)}${String(suffix)}`;
+        suffix += 1;
+      }
+      used.add(name);
+      const resolved = resolveSchema(schema);
+      const input = {
+        ...resolved.schema,
+        title: name
+      };
+      const text = await (0, import_json_schema_to_typescript.compile)(input, name, {
+        bannerComment: "",
+        additionalProperties: false,
+        declareExternallyReferenced: true,
+        enableConstEnums: false,
+        format: true,
+        style: STYLE,
+        unknownAny: true,
+        ...resolved.cwd === void 0 ? {} : { cwd: resolved.cwd }
+      });
+      blocks.push(text.trim());
+      return name;
+    },
+    declarations() {
+      return blocks;
+    }
+  };
+}
+function credentialSchema(fields) {
+  const properties = {};
+  const required = [];
+  for (const field of fields) {
+    const property = field.type === "select" && field.options ? { type: "string", enum: field.options } : { type: "string" };
+    if (field.help !== void 0) property.description = field.help;
+    properties[field.name] = property;
+    if (field.required) required.push(field.name);
+  }
+  return { type: "object", properties, required, additionalProperties: false };
+}
+async function generateTypes(options) {
+  const { manifest, registrySnapshot } = options;
+  const contributes = manifest.contributes;
+  const resolveSchema = (schema) => {
+    const ref = schema.$ref;
+    if (typeof ref !== "string" || ref.startsWith("#")) {
+      return { schema, cwd: options.cwd };
+    }
+    if (options.readSchemaFile === void 0) {
+      throw new TapError(
+        "TAP_SCHEMA_UNRESOLVED",
+        `The manifest points at the schema file "${ref}", but this call passed no readSchemaFile. Run \`tappify extension types\`, which reads schema files from the extension directory, or supply readSchemaFile.`
+      );
+    }
+    return {
+      schema: options.readSchemaFile(ref),
+      cwd: options.cwd === void 0 ? void 0 : (0, import_node_path.dirname)((0, import_node_path.join)(options.cwd, ref))
+    };
+  };
+  const emitter = createEmitter(resolveSchema);
+  const augmentations = [];
+  const storageEntries = Object.entries(contributes.storage ?? {});
+  if (storageEntries.length > 0) {
+    const lines = [];
+    for (const [name, collection] of storageEntries) {
+      const typeName = await emitter.declare(name, collection.schema);
+      const kind = collection.singleton === true ? "singleton" : "collection";
+      lines.push(
+        `    '${name}': { kind: '${kind}'; scope: '${collection.scope}'; document: ${typeName} };`
+      );
+    }
+    augmentations.push(`  interface TapStorageMap {
+${lines.join("\n")}
+  }`);
+  }
+  const procedureEntries = Object.entries(manifest.server?.procedures ?? {});
+  if (procedureEntries.length > 0) {
+    const lines = [];
+    for (const [name, declaration] of procedureEntries) {
+      const inputName = await emitter.declare(
+        `${name}Input`,
+        declaration.input
+      );
+      const outputName = await emitter.declare(
+        `${name}Output`,
+        declaration.output
+      );
+      lines.push(
+        `    '${name}': { input: ${inputName}; output: ${outputName} };`
+      );
+    }
+    augmentations.push(
+      `  interface TapProcedureMap {
+${lines.join("\n")}
+  }`
+    );
+  }
+  const actions = contributes.ai?.actions ?? [];
+  if (actions.length > 0) {
+    const lines = [];
+    for (const action of actions) {
+      const name = await emitter.declare(`${action.id}Input`, action.input);
+      lines.push(`    '${action.id}': { input: ${name} };`);
+    }
+    augmentations.push(`  interface TapActionMap {
+${lines.join("\n")}
+  }`);
+  }
+  const tools = contributes.ai?.tools ?? [];
+  if (tools.length > 0) {
+    const lines = [];
+    for (const tool of tools) {
+      const name = await emitter.declare(`${tool.id}Input`, tool.input);
+      lines.push(`    '${tool.id}': { input: ${name} };`);
+    }
+    augmentations.push(`  interface TapToolMap {
+${lines.join("\n")}
+  }`);
+  }
+  const prompts = (contributes.ai?.prompts ?? []).filter(
+    (prompt) => prompt.input !== void 0
+  );
+  if (prompts.length > 0) {
+    const lines = [];
+    for (const prompt of prompts) {
+      const name = await emitter.declare(
+        `${prompt.id}PromptInput`,
+        prompt.input ?? { type: "object" }
+      );
+      lines.push(`    '${prompt.id}': { input: ${name} };`);
+    }
+    augmentations.push(`  interface TapPromptMap {
+${lines.join("\n")}
+  }`);
+  }
+  const webhooks = contributes.webhooks ?? [];
+  if (webhooks.length > 0) {
+    const lines = [];
+    for (const webhook of webhooks) {
+      const name = await emitter.declare(
+        `${webhook.event}Payload`,
+        webhook.payload
+      );
+      lines.push(`    '${webhook.event}': ${name};`);
+    }
+    augmentations.push(`  interface TapWebhookMap {
+${lines.join("\n")}
+  }`);
+  }
+  if (registrySnapshot !== void 0 && registrySnapshot.events.length > 0) {
+    const lines = [];
+    for (const event of registrySnapshot.events) {
+      const name = await emitter.declare(
+        `${event.name}Event`,
+        event.payload ?? { type: "object" }
+      );
+      lines.push(`    '${event.name}': ${name};`);
+    }
+    augmentations.push(
+      `  interface TapHostEventMap {
+${lines.join("\n")}
+  }`
+    );
+  }
+  const telemetry = manifest.telemetry ?? [];
+  if (telemetry.length > 0) {
+    const lines = telemetry.map((name) => `    '${name}': true;`);
+    augmentations.push(
+      `  interface TapTelemetryEvents {
+${lines.join("\n")}
+  }`
+    );
+  }
+  if (contributes.settings) {
+    const name = await emitter.declare("Settings", contributes.settings.schema);
+    augmentations.push(`  interface TapSettings extends ${name} {}`);
+  }
+  const credentialFields = contributes.connector?.auth?.fields ?? [];
+  if (credentialFields.length > 0) {
+    const name = await emitter.declare(
+      "Credentials",
+      credentialSchema(credentialFields)
+    );
+    augmentations.push(`  interface TapCredentials extends ${name} {}`);
+  }
+  const declarations = emitter.declarations();
+  const module2 = augmentations.length === 0 ? "declare module '@tappify/extension-sdk' {}" : `declare module '@tappify/extension-sdk' {
+${augmentations.join("\n\n")}
+}`;
+  return [
+    GENERATED_HEADER,
+    "",
+    ...declarations.length > 0 ? [declarations.join("\n\n"), ""] : [],
+    module2,
+    "",
+    "export {};",
+    ""
+  ].join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GENERATED_HEADER,
+  generateTypes
+});
+//# sourceMappingURL=codegen.cjs.map

package/dist/codegen.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen.ts","../src/codegen/generate.ts","../src/client/errors.ts"],"sourcesContent":["export { GENERATED_HEADER, generateTypes } from './codegen/generate';\nexport type {\n  GenerateTypesOptions,\n  RegistrySnapshot,\n} from './codegen/generate';\n","import { compile } from 'json-schema-to-typescript';\nimport { dirname, join } from 'node:path';\nimport { TapError } from '../client/errors';\nimport type {\n  CredentialField,\n  ExtensionManifest,\n  JsonSchema,\n} from '../manifest/types';\n\nexport const GENERATED_HEADER = `/* eslint-disable */\n/**\n * Generated by \\`tappify extension types\\`. Do not edit by hand.\n * Re-run the command after changing tappify.extension.json or any schema it points at.\n */`;\n\nexport interface RegistrySnapshot {\n  events: { name: string; payload?: JsonSchema }[];\n}\n\nexport interface GenerateTypesOptions {\n  manifest: ExtensionManifest;\n  registrySnapshot?: RegistrySnapshot;\n  readSchemaFile?(path: string): JsonSchema;\n  /**\n   * The extension root. A `$ref` inside a schema file resolves against that\n   * file's own directory under it, the way the host and the Tap Store read\n   * it; without a root the process directory stands in.\n   */\n  cwd?: string;\n}\n\nconst STYLE = {\n  bracketSpacing: true,\n  printWidth: 80,\n  semi: true,\n  singleQuote: true,\n  tabWidth: 2,\n  trailingComma: 'all',\n  useTabs: false,\n} as const;\n\nfunction pascal(value: string): string {\n  return value\n    .split(/[^A-Za-z0-9]+/)\n    .filter(part => part !== '')\n    .map(part => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n\ninterface Emitter {\n  declare(preferredName: string, schema: JsonSchema): Promise<string>;\n  declarations(): string[];\n}\n\ninterface ResolvedSchema {\n  schema: JsonSchema;\n  /** Where the schema's own nested `$ref`s resolve from. */\n  cwd?: string;\n}\n\nfunction createEmitter(\n  resolveSchema: (schema: JsonSchema) => ResolvedSchema,\n): Emitter {\n  const used = new Set<string>();\n  const blocks: string[] = [];\n\n  return {\n    async declare(preferredName, schema) {\n      let name = pascal(preferredName);\n      let suffix = 2;\n      while (used.has(name)) {\n        name = `${pascal(preferredName)}${String(suffix)}`;\n        suffix += 1;\n      }\n      used.add(name);\n\n      const resolved = resolveSchema(schema);\n      const input: Parameters<typeof compile>[0] = {\n        ...resolved.schema,\n        title: name,\n      };\n\n      const text = await compile(input, name, {\n        bannerComment: '',\n        additionalProperties: false,\n        declareExternallyReferenced: true,\n        enableConstEnums: false,\n        format: true,\n        style: STYLE,\n        unknownAny: true,\n        ...(resolved.cwd === undefined ? {} : { cwd: resolved.cwd }),\n      });\n\n      blocks.push(text.trim());\n      return name;\n    },\n    declarations() {\n      return blocks;\n    },\n  };\n}\n\nfunction credentialSchema(fields: CredentialField[]): JsonSchema {\n  const properties: Record<string, JsonSchema> = {};\n  const required: string[] = [];\n\n  for (const field of fields) {\n    const property: JsonSchema =\n      field.type === 'select' && field.options\n        ? { type: 'string', enum: field.options }\n        : { type: 'string' };\n    if (field.help !== undefined) property.description = field.help;\n    properties[field.name] = property;\n    if (field.required) required.push(field.name);\n  }\n\n  return { type: 'object', properties, required, additionalProperties: false };\n}\n\nexport async function generateTypes(\n  options: GenerateTypesOptions,\n): Promise<string> {\n  const { manifest, registrySnapshot } = options;\n  const contributes = manifest.contributes;\n\n  const resolveSchema = (schema: JsonSchema): ResolvedSchema => {\n    const ref = schema.$ref;\n    if (typeof ref !== 'string' || ref.startsWith('#')) {\n      return { schema, cwd: options.cwd };\n    }\n    if (options.readSchemaFile === undefined) {\n      throw new TapError(\n        'TAP_SCHEMA_UNRESOLVED',\n        `The manifest points at the schema file \"${ref}\", but this call passed no readSchemaFile. Run \\`tappify extension types\\`, which reads schema files from the extension directory, or supply readSchemaFile.`,\n      );\n    }\n    return {\n      schema: options.readSchemaFile(ref),\n      cwd:\n        options.cwd === undefined ? undefined : dirname(join(options.cwd, ref)),\n    };\n  };\n\n  const emitter = createEmitter(resolveSchema);\n  const augmentations: string[] = [];\n\n  const storageEntries = Object.entries(contributes.storage ?? {});\n  if (storageEntries.length > 0) {\n    const lines: string[] = [];\n    for (const [name, collection] of storageEntries) {\n      const typeName = await emitter.declare(name, collection.schema);\n      const kind = collection.singleton === true ? 'singleton' : 'collection';\n      lines.push(\n        `    '${name}': { kind: '${kind}'; scope: '${collection.scope}'; document: ${typeName} };`,\n      );\n    }\n    augmentations.push(`  interface TapStorageMap {\\n${lines.join('\\n')}\\n  }`);\n  }\n\n  const procedureEntries = Object.entries(manifest.server?.procedures ?? {});\n  if (procedureEntries.length > 0) {\n    const lines: string[] = [];\n    for (const [name, declaration] of procedureEntries) {\n      const inputName = await emitter.declare(\n        `${name}Input`,\n        declaration.input,\n      );\n      const outputName = await emitter.declare(\n        `${name}Output`,\n        declaration.output,\n      );\n      lines.push(\n        `    '${name}': { input: ${inputName}; output: ${outputName} };`,\n      );\n    }\n    augmentations.push(\n      `  interface TapProcedureMap {\\n${lines.join('\\n')}\\n  }`,\n    );\n  }\n\n  const actions = contributes.ai?.actions ?? [];\n  if (actions.length > 0) {\n    const lines: string[] = [];\n    for (const action of actions) {\n      const name = await emitter.declare(`${action.id}Input`, action.input);\n      lines.push(`    '${action.id}': { input: ${name} };`);\n    }\n    augmentations.push(`  interface TapActionMap {\\n${lines.join('\\n')}\\n  }`);\n  }\n\n  const tools = contributes.ai?.tools ?? [];\n  if (tools.length > 0) {\n    const lines: string[] = [];\n    for (const tool of tools) {\n      const name = await emitter.declare(`${tool.id}Input`, tool.input);\n      lines.push(`    '${tool.id}': { input: ${name} };`);\n    }\n    augmentations.push(`  interface TapToolMap {\\n${lines.join('\\n')}\\n  }`);\n  }\n\n  const prompts = (contributes.ai?.prompts ?? []).filter(\n    prompt => prompt.input !== undefined,\n  );\n  if (prompts.length > 0) {\n    const lines: string[] = [];\n    for (const prompt of prompts) {\n      const name = await emitter.declare(\n        `${prompt.id}PromptInput`,\n        prompt.input ?? { type: 'object' },\n      );\n      lines.push(`    '${prompt.id}': { input: ${name} };`);\n    }\n    augmentations.push(`  interface TapPromptMap {\\n${lines.join('\\n')}\\n  }`);\n  }\n\n  const webhooks = contributes.webhooks ?? [];\n  if (webhooks.length > 0) {\n    const lines: string[] = [];\n    for (const webhook of webhooks) {\n      const name = await emitter.declare(\n        `${webhook.event}Payload`,\n        webhook.payload,\n      );\n      lines.push(`    '${webhook.event}': ${name};`);\n    }\n    augmentations.push(`  interface TapWebhookMap {\\n${lines.join('\\n')}\\n  }`);\n  }\n\n  if (registrySnapshot !== undefined && registrySnapshot.events.length > 0) {\n    const lines: string[] = [];\n    for (const event of registrySnapshot.events) {\n      const name = await emitter.declare(\n        `${event.name}Event`,\n        event.payload ?? { type: 'object' },\n      );\n      lines.push(`    '${event.name}': ${name};`);\n    }\n    augmentations.push(\n      `  interface TapHostEventMap {\\n${lines.join('\\n')}\\n  }`,\n    );\n  }\n\n  const telemetry = manifest.telemetry ?? [];\n  if (telemetry.length > 0) {\n    const lines = telemetry.map(name => `    '${name}': true;`);\n    augmentations.push(\n      `  interface TapTelemetryEvents {\\n${lines.join('\\n')}\\n  }`,\n    );\n  }\n\n  if (contributes.settings) {\n    const name = await emitter.declare('Settings', contributes.settings.schema);\n    augmentations.push(`  interface TapSettings extends ${name} {}`);\n  }\n\n  const credentialFields = contributes.connector?.auth?.fields ?? [];\n  if (credentialFields.length > 0) {\n    const name = await emitter.declare(\n      'Credentials',\n      credentialSchema(credentialFields),\n    );\n    augmentations.push(`  interface TapCredentials extends ${name} {}`);\n  }\n\n  const declarations = emitter.declarations();\n  const module =\n    augmentations.length === 0\n      ? \"declare module '@tappify/extension-sdk' {}\"\n      : `declare module '@tappify/extension-sdk' {\\n${augmentations.join('\\n\\n')}\\n}`;\n\n  return [\n    GENERATED_HEADER,\n    '',\n    ...(declarations.length > 0 ? [declarations.join('\\n\\n'), ''] : []),\n    module,\n    '',\n    'export {};',\n    '',\n  ].join('\\n');\n}\n","/** 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"],"mappings":"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","names":["module"]}