@businessdash/sdk 0.9.60

package/dist/element.js

@@ -0,0 +1,276 @@
+/**
+ * `@businessdash/sdk/element` — the `<biab-form>` custom element binding.
+ *
+ * A drop-in web component that renders a BIAB form anywhere a tag can go:
+ *
+ *   <biab-form slug="contact" submit-label="Send"></biab-form>
+ *
+ * It is a thin custom-element shell around the framework-free `mountBiabForm`
+ * (`@businessdash/sdk/vanilla`): the element owns the lifecycle (connect / attribute
+ * changes / disconnect) and `mountBiabForm` owns all rendering + the headless
+ * controller. It renders into LIGHT DOM (no shadow root) so the consumer's
+ * `biab-*` CSS cascades straight in — identical to every other binding.
+ *
+ * ── Passing the SDK client ───────────────────────────────────────────────────
+ * A `BiabClient` can't travel through an HTML attribute, so there are three ways
+ * to give the element one (checked in this order):
+ *   1. The `.client` JS property:           el.client = createBiabClient(...)
+ *   2. A DI default set once at startup:     setBiabFormClient(createBiabClient(...))
+ *      (the "Provider equivalent" — every <biab-form> on the page uses it)
+ *   3. A pre-fetched schema (SSR), via the `.schema` property — no client needed
+ *      to render; a client is still required to actually submit.
+ *
+ * ── Attributes (reflected, kebab-case) ───────────────────────────────────────
+ *   slug                 — form slug to load via the client
+ *   submit-label         — label for the final submit button (default "Submit")
+ *   dry-run              — present ⇒ validate server-side but store nothing
+ *   class                — extra class(es) added to the inner `.biab-form`
+ *   auto-complete        — global HTML autofill switch: "false" ⇒ off, "true" or
+ *                          absent ⇒ infer tokens per field
+ *   field-auto-complete  — JSON object of per-field overrides keyed by field id
+ *                          ({ "<id>": token | true | false })
+ *
+ * ── Properties (JS, richer types) ────────────────────────────────────────────
+ *   .client  : BiabClient            — the SDK client
+ *   .schema  : FormSchema            — pre-fetched schema (SSR / adopt)
+ *   .submitOptions : FormSubmitOptions
+ *   .autoComplete : boolean | undefined        — mirrors `auto-complete`
+ *   .fieldAutoComplete : Record<string, string | boolean> | undefined
+ *
+ * ── Events (bubbling, composed) ──────────────────────────────────────────────
+ *   biab-form-success  — detail: the ok FormSubmitResult
+ *   biab-form-error    — detail: the failed FormSubmitResult
+ *   biab-form-submit   — detail: { data } working values at submit time
+ *
+ * Compiled to dist (plain TS, no JSX). Importing this module registers the
+ * element once (idempotent).
+ */
+import { mountBiabForm, } from "./vanilla.js";
+// Re-export the core + the vanilla mount so this subpath is a complete entry.
+export * from "./forms-core/index.js";
+export { mountBiabForm } from "./vanilla.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Provider equivalent — a process-wide default client for every <biab-form>.
+// ─────────────────────────────────────────────────────────────────────────────
+let defaultClient = null;
+/**
+ * Set (or clear) the default SDK client used by every `<biab-form>` that doesn't
+ * have its own `.client` property. The web-component analogue of a React
+ * `<BiabFormProvider client={…}>`. Call once at startup:
+ *
+ *   import { setBiabFormClient } from "@businessdash/sdk/element";
+ *   setBiabFormClient(createBiabClient({ apiKey, siteId, baseUrl }));
+ */
+export function setBiabFormClient(client) {
+    defaultClient = client;
+}
+/** Read the current default client (mostly for tests / introspection). */
+export function getBiabFormClient() {
+    return defaultClient;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// The custom element.
+// ─────────────────────────────────────────────────────────────────────────────
+export class BiabFormElement extends HTMLElement {
+    static get observedAttributes() {
+        return [
+            "slug",
+            "submit-label",
+            "dry-run",
+            "class",
+            "auto-complete",
+            "field-auto-complete",
+        ];
+    }
+    /** The mounted instance (null until connected with enough config). */
+    instance = null;
+    /** Property-only backing fields (can't ride on attributes). */
+    _client;
+    _schema;
+    _submitOptions;
+    /** Per-field autofill overrides set via the JS property; the
+     *  `field-auto-complete` JSON attribute is parsed at mount as a fallback. */
+    _fieldAutoComplete;
+    // ── Property accessors ─────────────────────────────────────────────────────
+    get client() {
+        return this._client;
+    }
+    set client(value) {
+        this._client = value;
+        this.remount();
+    }
+    get schema() {
+        return this._schema;
+    }
+    set schema(value) {
+        this._schema = value;
+        this.remount();
+    }
+    get submitOptions() {
+        return this._submitOptions;
+    }
+    set submitOptions(value) {
+        this._submitOptions = value;
+        this.remount();
+    }
+    get slug() {
+        return this.getAttribute("slug");
+    }
+    set slug(value) {
+        if (value == null)
+            this.removeAttribute("slug");
+        else
+            this.setAttribute("slug", value);
+    }
+    get submitLabel() {
+        return this.getAttribute("submit-label");
+    }
+    set submitLabel(value) {
+        if (value == null)
+            this.removeAttribute("submit-label");
+        else
+            this.setAttribute("submit-label", value);
+    }
+    get dryRun() {
+        return this.hasAttribute("dry-run");
+    }
+    set dryRun(value) {
+        if (value)
+            this.setAttribute("dry-run", "");
+        else
+            this.removeAttribute("dry-run");
+    }
+    /** Global autofill switch. `undefined` (attribute absent) infers tokens;
+     *  `false` (`auto-complete="false"`) emits `autocomplete="off"` everywhere. */
+    get autoComplete() {
+        const attr = this.getAttribute("auto-complete");
+        if (attr == null)
+            return undefined;
+        return attr !== "false";
+    }
+    set autoComplete(value) {
+        if (value == null)
+            this.removeAttribute("auto-complete");
+        else
+            this.setAttribute("auto-complete", value ? "true" : "false");
+    }
+    /** Per-field autofill overrides keyed by field id. Settable as a JS object
+     *  property or as the `field-auto-complete` JSON attribute. */
+    get fieldAutoComplete() {
+        if (this._fieldAutoComplete !== undefined)
+            return this._fieldAutoComplete;
+        return parseFieldAutoComplete(this.getAttribute("field-auto-complete"));
+    }
+    set fieldAutoComplete(value) {
+        this._fieldAutoComplete = value;
+        this.remount();
+    }
+    // ── Lifecycle ───────────────────────────────────────────────────────────────
+    connectedCallback() {
+        this.mount();
+    }
+    disconnectedCallback() {
+        this.teardown();
+    }
+    attributeChangedCallback(_name, oldValue, newValue) {
+        if (oldValue === newValue)
+            return;
+        // Any observed attribute changing re-derives the mount options.
+        this.remount();
+    }
+    /** Imperatively submit the form (parity with `mountBiabForm`'s handle). */
+    submit(options) {
+        return this.instance?.submit(options);
+    }
+    /** Reset values / errors / step. */
+    reset() {
+        this.instance?.reset();
+    }
+    /** Re-fetch (or re-adopt) the schema. */
+    reload() {
+        return this.instance?.reload();
+    }
+    // ── Internals ────────────────────────────────────────────────────────────────
+    mount() {
+        if (this.instance)
+            return;
+        const client = this._client ?? defaultClient ?? undefined;
+        const slug = this.getAttribute("slug") ?? undefined;
+        // Need either a client+slug or a pre-fetched schema to render.
+        if (!this._schema && (!client || !slug)) {
+            this.replaceChildren();
+            const hint = document.createElement("div");
+            hint.className = "biab-form biab-form__error";
+            hint.textContent =
+                "<biab-form> needs a `slug` + a client (set `.client` or call setBiabFormClient), or a pre-fetched `.schema`.";
+            this.append(hint);
+            return;
+        }
+        const extraClass = this.getAttribute("class") ?? undefined;
+        const submitLabel = this.getAttribute("submit-label") ?? undefined;
+        const autoComplete = this.autoComplete;
+        const fieldAutoComplete = this.fieldAutoComplete;
+        this.instance = mountBiabForm(this, {
+            ...(client ? { client } : {}),
+            ...(slug ? { slug } : {}),
+            ...(this._schema ? { schema: this._schema } : {}),
+            ...(submitLabel ? { submitLabel } : {}),
+            ...(this.hasAttribute("dry-run") ? { dryRun: true } : {}),
+            ...(extraClass ? { class: extraClass } : {}),
+            ...(this._submitOptions ? { submitOptions: this._submitOptions } : {}),
+            ...(autoComplete !== undefined ? { autoComplete } : {}),
+            ...(fieldAutoComplete ? { fieldAutoComplete } : {}),
+            onSubmit: (data) => this.emit("biab-form-submit", { data }),
+            onSuccess: (result) => this.emit("biab-form-success", result),
+            onError: (result) => this.emit("biab-form-error", result),
+        });
+    }
+    teardown() {
+        this.instance?.destroy();
+        this.instance = null;
+    }
+    /** Tear down + re-mount with current attrs/props. Cheap; ignored pre-connect. */
+    remount() {
+        if (!this.isConnected)
+            return;
+        this.teardown();
+        this.mount();
+    }
+    emit(type, detail) {
+        this.dispatchEvent(new CustomEvent(type, { detail, bubbles: true, composed: true }));
+    }
+}
+/**
+ * Parse the `field-auto-complete` JSON attribute into a per-field overrides
+ * record. Returns `undefined` on absent/blank/invalid JSON or a non-object so a
+ * malformed attribute silently falls back to inferred tokens.
+ */
+function parseFieldAutoComplete(raw) {
+    if (raw == null || raw.trim() === "")
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Malformed JSON — ignore and fall back to inferred tokens.
+    }
+    return undefined;
+}
+/**
+ * Register `<biab-form>` once. Idempotent and SSR-safe (no-op when
+ * `customElements` is unavailable, e.g. on the server). Called automatically on
+ * import; also exported so a consumer can register under a custom tag name.
+ */
+export function defineBiabForm(tagName = "biab-form") {
+    if (typeof customElements === "undefined")
+        return;
+    if (customElements.get(tagName))
+        return;
+    customElements.define(tagName, BiabFormElement);
+}
+// Auto-register on import (the common case: `import "@businessdash/sdk/element"`).
+defineBiabForm();
+//# sourceMappingURL=element.js.map

package/dist/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"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"}

package/dist/enums.d.ts

@@ -0,0 +1,25 @@
+export interface EnumEntry {
+    value: string;
+    label: string;
+}
+export declare function Enums<const T extends readonly (string | {
+    value: string;
+    label?: string;
+})[]>(definitions: T): {
+    type: "enum";
+    entries: EnumEntry[];
+    values: { [K in keyof T]: T[K] extends string ? T[K] : T[K] extends {
+        value: infer V;
+    } ? V : never; };
+    isValid: (val: unknown) => boolean;
+    getLabel: (val: string) => string | undefined;
+};
+export type InferEnumValues<T extends {
+    values: readonly string[];
+}> = T["values"][number];
+export type Enum = EnumEntry;
+export type DefineEnums = EnumEntry;
+export type InferEnum<T extends {
+    values: readonly string[];
+}> = InferEnumValues<T>;
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAGD,wBAAgB,KAAK,CACpB,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,EACtE,WAAW,EAAE,CAAC;;;YAkBoC,GAChD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAChC,CAAC,CAAC,CAAC,CAAC,GACJ,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC,CAAA;KAAE,GAC9B,CAAC,GACD,KAAK,GACT;mBACc,OAAO,KAAG,OAAO;oBAChB,MAAM,KAAG,MAAM,GAAG,SAAS;EAG5C;AAGD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,IAClE,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC;AAC7B,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AACpC,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,IAC5D,eAAe,CAAC,CAAC,CAAC,CAAC"}

package/dist/enums.js

@@ -0,0 +1,38 @@
+// Core utility to extract and humanize strings into clean labels
+function formatLabel(value) {
+    // 1. Separate camelCase/PascalCase boundaries (e.g., "inProgress" -> "in Progress")
+    const spaced = value.replace(/(?<=[a-z])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])/g, " ");
+    // 2. Normalize snake_case (_) and kebab-case (-) into clear spaces
+    const normalized = spaced.replace(/[_-]+/g, " ").trim();
+    // 3. Capitalize the first letter of each discrete word
+    return normalized
+        .toLowerCase()
+        .split(" ")
+        .filter((word) => word.length > 0) // Clean up any duplicate spacing artifacts
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+// The core runtime handler implementation for the Pull Request
+export function Enums(definitions) {
+    // Normalize mixed inputs to a standard array layout
+    const entries = definitions.map((item) => {
+        if (typeof item === "string") {
+            return {
+                value: item,
+                label: formatLabel(item),
+            };
+        }
+        return {
+            value: item.value,
+            label: item.label ?? formatLabel(item.value),
+        };
+    });
+    return {
+        type: "enum",
+        entries,
+        values: entries.map((e) => e.value),
+        isValid: (val) => entries.some((e) => e.value === val),
+        getLabel: (val) => entries.find((e) => e.value === val)?.label,
+    };
+}
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,SAAS,WAAW,CAAC,KAAa;IACjC,oFAAoF;IACpF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAC3B,+CAA+C,EAC/C,GAAG,CACH,CAAC;IACF,mEAAmE;IACnE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,uDAAuD;IACvD,OAAO,UAAU;SACf,WAAW,EAAE;SACb,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,2CAA2C;SAC7E,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAOD,+DAA+D;AAC/D,MAAM,UAAU,KAAK,CAEnB,WAAc;IACf,oDAAoD;IACpD,MAAM,OAAO,GAAgB,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACN,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;aACxB,CAAC;QACH,CAAC;QACD,OAAO;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;SAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACN,IAAI,EAAE,MAAe;QACrB,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAMjC;QACD,OAAO,EAAE,CAAC,GAAY,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC;QACxE,QAAQ,EAAE,CAAC,GAAW,EAAsB,EAAE,CAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,KAAK;KAC5C,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,195 @@
+export declare class BiabApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    readonly path: string;
+    constructor(input: {
+        status: number;
+        path: string;
+        message: string;
+        body: unknown;
+    });
+}
+/**
+ * Discriminated body BIAB returns when the package API refuses to
+ * run a handler — three reasons:
+ *
+ * - `plan_required` — feature not in the org's plan (customer can
+ *   still use site; upsell card is the right UI).
+ * - `payment_required` — org's billing is 0-60 days past-due.
+ *   Static-data routes still serve; interactive ones return this
+ *   shape and the org's customer-facing site keeps working.
+ * - `service_suspended` — 60+ days past-due. Everything returns
+ *   this shape. The SDK consumer should render a 503 fallback page
+ *   so search engines treat the outage as temporary, not
+ *   permanent.
+ *
+ * READ endpoints return 200 with this body so consumers can branch
+ * cleanly without try/catch; WRITE endpoints return 402 so
+ * accidental mutations surface as exceptions.
+ */
+export type BiabPlanGateBody = {
+    available: false;
+    reason: "plan_required";
+    requiredFeature: string;
+    requiredPlan: string;
+    planDisplayName: string;
+    upgradeUrl: string;
+    message: string;
+} | {
+    available: false;
+    reason: "payment_required";
+    daysLapsed: number;
+    daysUntilSuspension: number;
+    upgradeUrl: string;
+    message: string;
+} | {
+    available: false;
+    reason: "service_suspended";
+    daysLapsed: number;
+    upgradeUrl: string;
+    message: string;
+};
+export declare function isBiabPlanGateBody(value: unknown): value is BiabPlanGateBody;
+/**
+ * Base class for every billing/entitlement rejection. Catch this to
+ * handle "the SDK refused to serve" uniformly; catch one of the three
+ * subclasses (or `instanceof`-narrow on this class) to branch on the
+ * specific reason.
+ */
+export declare class BiabAccessRejectedError extends Error {
+    readonly reason: "plan_required" | "payment_required" | "service_suspended";
+    readonly upgradeUrl: string;
+    readonly featureMessage: string;
+    readonly path: string;
+    readonly status: number;
+    constructor(input: {
+        body: BiabPlanGateBody;
+        path: string;
+        status: number;
+    });
+}
+/**
+ * Thrown when the org's plan doesn't include the feature the call
+ * needs. The org can resolve this by upgrading (or by adding the
+ * specific feature à la carte once that surface ships).
+ */
+export declare class BiabFeatureNotEntitledError extends BiabAccessRejectedError {
+    readonly feature: string;
+    readonly requiredPlan: string;
+    readonly planDisplayName: string;
+    constructor(input: {
+        body: Extract<BiabPlanGateBody, {
+            reason: "plan_required";
+        }>;
+        path: string;
+        status: number;
+    });
+}
+/**
+ * Thrown when the org's billing is 0-60 days past-due. Static-data
+ * routes (marketing bundle, sitemap, robots, parallel-page reads,
+ * gallery/blog reads) continue serving normally — interactive ones
+ * (forms, cart, scheduling bookings, chatbot writes) throw this.
+ */
+export declare class BiabPaymentLapsedError extends BiabAccessRejectedError {
+    readonly daysLapsed: number;
+    readonly daysUntilSuspension: number;
+    constructor(input: {
+        body: Extract<BiabPlanGateBody, {
+            reason: "payment_required";
+        }>;
+        path: string;
+        status: number;
+    });
+}
+/**
+ * Thrown when the org's billing has been past-due for more than 60
+ * days. Every SDK call throws this; the consumer's framework-level
+ * page handler should catch it and return HTTP 503 with a "site
+ * temporarily unavailable" page so search engines treat the outage
+ * as temporary. `robots.txt` and `sitemap.xml` separately switch to
+ * suspended-mode bodies (`Disallow: /` / empty) for the same reason.
+ */
+export declare class BiabServiceSuspendedError extends BiabAccessRejectedError {
+    readonly daysLapsed: number;
+    constructor(input: {
+        body: Extract<BiabPlanGateBody, {
+            reason: "service_suspended";
+        }>;
+        path: string;
+        status: number;
+    });
+}
+/**
+ * Factory the transport uses to throw the right subclass.
+ */
+export declare function accessRejectionFromBody(input: {
+    body: BiabPlanGateBody;
+    path: string;
+    status: number;
+}): BiabAccessRejectedError;
+/**
+ * Result shape returned by `unwrapAccess` — either the data the
+ * inner promise resolved to, OR a `rejected` descriptor (one of the
+ * three reasons) so the consumer can render the appropriate card.
+ * Errors that aren't access rejections continue to throw.
+ *
+ * ```ts
+ * const result = await unwrapAccess(() => client.gallery.list());
+ * if (result.rejected) {
+ *   switch (result.rejected.reason) {
+ *     case "plan_required": return <UpsellCard {...result.rejected} />;
+ *     case "payment_required": return <BillingLapsedCard {...result.rejected} />;
+ *     case "service_suspended": return <SiteUnavailableCard {...result.rejected} />;
+ *   }
+ * }
+ * return <Gallery items={result.data} />;
+ * ```
+ */
+export type UnwrappedAccess<T> = {
+    data: T;
+    rejected: null;
+} | {
+    data: null;
+    rejected: {
+        reason: "plan_required";
+        feature: string;
+        requiredPlan: string;
+        planDisplayName: string;
+        upgradeUrl: string;
+        message: string;
+    } | {
+        reason: "payment_required";
+        daysLapsed: number;
+        daysUntilSuspension: number;
+        upgradeUrl: string;
+        message: string;
+    } | {
+        reason: "service_suspended";
+        daysLapsed: number;
+        upgradeUrl: string;
+        message: string;
+    };
+};
+export declare function unwrapAccess<T>(fn: () => Promise<T>): Promise<UnwrappedAccess<T>>;
+/**
+ * Back-compat alias for the plan-only escape hatch. Same shape as
+ * `unwrapAccess` but only catches `BiabFeatureNotEntitledError` —
+ * other access rejections (payment lapse, suspension) still throw.
+ * Prefer `unwrapAccess` for new code.
+ */
+export type UnwrappedEntitlement<T> = {
+    data: T;
+    notEntitled: null;
+} | {
+    data: null;
+    notEntitled: {
+        feature: string;
+        requiredPlan: string;
+        planDisplayName: string;
+        upgradeUrl: string;
+        featureMessage: string | null;
+    };
+};
+export declare function unwrapEntitlement<T>(fn: () => Promise<T>): Promise<UnwrappedEntitlement<T>>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}