@tappify/extension-sdk 2.0.0

package/dist/handler-CZIlZ5vu.d.ts

@@ -0,0 +1,227 @@
+import { JSONWebKeySet } from 'jose';
+import { K as TapPlatformFilter, a as TapFilters, $ as TapSettingsValues, w as TapCredentialValues, ab as ToolId, ac as ToolInput, A as ActionId, k as ActionInput, f as TapProcedureName, g as TapProcedureInput, h as TapProcedureOutput, c as TapHostEvents } from './types-DDAGLpov.js';
+
+/** Which install made the call, as the token's claims name it. */
+interface TappifyInstall {
+    /** The install id, which is the key to scope anything you store yourself by. */
+    id: string;
+    extensionId: string;
+    /** `null` for an install on the workspace rather than one project. */
+    projectId: string | null;
+    organizationId: string;
+}
+/** The project and the filter bar the call was made from. */
+interface TappifyCallContext {
+    projectId: string | null;
+    /** The same value as `filters.platform`, hoisted for convenience. */
+    platform: TapPlatformFilter;
+    /** The range start, as `YYYY-MM-DD`, or an empty string when none was sent. */
+    from: string;
+    /** The range end, as `YYYY-MM-DD`, or an empty string when none was sent. */
+    to: string;
+    filters: TapFilters;
+}
+/**
+ * The install- and organization-scoped storage documents Tappify passes to the
+ * server on every call, keyed by collection name.
+ */
+type TappifyDocuments = Record<string, unknown> & {
+    /** The settings contribution's document, or `null` before it is first saved. */
+    settings?: TapSettingsValues | null;
+};
+/** The verified claims of an install token, as `verifyTappifyToken` returns them. */
+interface TappifyClaims {
+    iss: string;
+    /** Always `ext:<extensionId>`, which is what the verifier checked. */
+    aud: string;
+    exp: number;
+    iat: number;
+    installId: string;
+    extensionId: string;
+    projectId: string | null;
+    organizationId: string;
+    /** The scopes the install granted, as strings. */
+    scopes: string[];
+    /** Present when the token carries one, naming the teammate behind the call. */
+    userId?: string;
+}
+/** The single argument every route handler receives. */
+interface TappifyRequest<TInput = unknown, TEvent = unknown> {
+    install: TappifyInstall;
+    context: TappifyCallContext;
+    /**
+     * The call's `input`, or `{}` when the body carried none, and `undefined` on a
+     * context or events route, which take no input.
+     */
+    input: TInput;
+    credentials: TapCredentialValues;
+    documents: TappifyDocuments;
+    /** The event payload on an events route, and `undefined` on every other. */
+    event: TEvent | undefined;
+    /** The idempotency key from `X-Tappify-Event-Id`; deduplicate writes on it. */
+    eventId: string;
+    claims: TappifyClaims;
+    /** The original request, for a header or the raw body. */
+    request: Request;
+}
+/**
+ * The signature every entry in `TappifyHandlerOptions` has: one argument, and a
+ * value or a promise of one.
+ */
+type TappifyRouteHandler<TInput = unknown, TOutput = unknown, TEvent = unknown> = (request: TappifyRequest<TInput, TEvent>) => TOutput | Promise<TOutput>;
+/** What the `GET /tappify/health` route answers with. */
+interface TappifyHealth {
+    /** Whether the server is ready to take calls; the publish check reads it. */
+    ok: boolean;
+    version?: string;
+    /** A line for the owner when the server is not ready. */
+    message?: string;
+}
+/** What Tappify asks a connector's metrics route for. */
+interface MetricsInput {
+    projectId: string | null;
+    platform: TapPlatformFilter;
+    /** The metric keys to answer for, from the ones the manifest declares. */
+    metrics: string[];
+    from: string;
+    to: string;
+}
+/** One metric's answer inside a `MetricsResponse`. */
+interface MetricsSeries {
+    /** The declared metric key this series answers for. */
+    metric: string;
+    /** Has to match the unit the manifest declares for that key. */
+    unit: 'count' | 'ratio' | 'currency' | 'seconds' | 'bytes';
+    /** One value per declared dimension, when the series is broken down. */
+    dimensions?: Record<string, string>;
+    /** `[timestamp, value]` pairs, oldest first. */
+    points: [string, number][];
+}
+/** What a connector's metrics route answers with: one series per asked metric. */
+interface MetricsResponse {
+    series: MetricsSeries[];
+}
+/** What a mention route answers with: the items the owner can pick from. */
+interface MentionItems {
+    items: {
+        id: string;
+        label: string;
+    }[];
+}
+/** What a context route answers with, for the owner's chat to read. */
+interface ContextBlock {
+    /** A line of prose the assistant can use as it is. */
+    summary: string;
+    /** The numbers behind the summary, for the assistant to quote. */
+    data?: Record<string, unknown>;
+}
+/** The work-tracker operations a handler's `work` table can answer. */
+type WorkOperation = 'list_containers' | 'create' | 'attach' | 'comment' | 'status' | 'resolve';
+/** The second argument of `verifyTappifyToken`. */
+interface VerifyTokenOptions {
+    /** The `id` from the manifest; the token's audience has to be `ext:<id>`. */
+    extensionId: string;
+    /** Where to fetch the signing keys. Defaults to `DEFAULT_JWKS_URL`. */
+    jwksUrl?: string;
+    /** A key set to verify against, which skips the fetch. For tests. */
+    jwks?: JSONWebKeySet;
+}
+/**
+ * The routes and settings `createTappifyHandler` builds a fetch handler from.
+ *
+ * @remarks
+ * The `tools`, `actions` and `procedures` tables are keyed by the names the
+ * augmentation `tappify extension types` writes, so a handler for an undeclared
+ * name does not compile. `events` is keyed by Tappify's own event catalogue and
+ * `work` by the fixed set of work operations; `mentions` and `context` take any id.
+ * A route Tappify calls with no handler registered answers 404 with
+ * `TAP_HANDLER_MISSING`. Export this object as well as the handler: the testing
+ * entry's `createTestClient` takes the options, not the built handler.
+ */
+interface TappifyHandlerOptions {
+    /** The `id` from the manifest, which the install token's audience has to match. */
+    extensionId: string;
+    /** Where to fetch the signing keys. Defaults to `DEFAULT_JWKS_URL`. */
+    jwksUrl?: string;
+    /** A key set to verify against, which skips the fetch. For tests. */
+    jwks?: JSONWebKeySet;
+    /** The prefix your framework mounts the handler under, such as `/api`. */
+    basePath?: string;
+    /** Answers `GET /tappify/health`. Left out, the route answers `{ ok: true }`. */
+    health?: () => TappifyHealth | Promise<TappifyHealth>;
+    /** Answers `POST /tappify/metrics` for a connector contribution. */
+    metrics?: TappifyRouteHandler<MetricsInput, MetricsResponse>;
+    /** One handler per declared tool, answering `POST /tappify/tools/<id>`. */
+    tools?: {
+        [T in ToolId]?: TappifyRouteHandler<ToolInput<T>, unknown>;
+    };
+    /** One handler per declared mention, answering `GET /tappify/mentions/<id>?q=`. */
+    mentions?: Record<string, TappifyRouteHandler<{
+        q: string;
+    }, MentionItems>>;
+    /** One handler per declared action, answering `POST /tappify/actions/<id>`. */
+    actions?: {
+        [A in ActionId]?: TappifyRouteHandler<ActionInput<A>, unknown>;
+    };
+    /** One handler per declared procedure, which is what `useTapServer` calls. */
+    procedures?: {
+        [N in TapProcedureName]?: TappifyRouteHandler<TapProcedureInput<N>, TapProcedureOutput<N>>;
+    };
+    /** One handler per declared context block, answering `GET /tappify/context/<id>`. */
+    context?: Record<string, TappifyRouteHandler<undefined, ContextBlock>>;
+    /** One handler per Tappify event you subscribe to; each answers 204. */
+    events?: {
+        [E in keyof TapHostEvents]?: TappifyRouteHandler<undefined, void, TapHostEvents[E]>;
+    };
+    /** One handler per work operation, answering `POST /tappify/work/<operation>`. */
+    work?: {
+        [O in WorkOperation]?: TappifyRouteHandler<Record<string, unknown>, unknown>;
+    };
+}
+
+/**
+ * What `createTappifyHandler` returns: a `fetch` handler, which is what Cloudflare
+ * Workers, Vercel and the two adapters all take.
+ */
+type TappifyFetchHandler = (request: Request) => Promise<Response>;
+/**
+ * Builds the one `fetch` handler that answers every route Tappify calls on your
+ * server.
+ *
+ * @remarks
+ * It routes the paths under `/tappify`, minus `basePath` when your framework mounts
+ * it under a prefix, and hands each matched handler a `TappifyRequest`. Every
+ * route but `GET /tappify/health` needs a bearer install token, which it verifies
+ * with `verifyTappifyToken`, and an `X-Tappify-Event-Id` header; a missing token is
+ * 401 `TAP_TOKEN_MISSING`, a missing id 400 `TAP_EVENT_ID_MISSING`, an unknown path
+ * 404 `TAP_ROUTE_UNKNOWN` and a declared name with no handler 404
+ * `TAP_HANDLER_MISSING`. A body that is not JSON is 400 `TAP_BODY_INVALID` and one
+ * over 1 MB is 413 `TAP_BODY_TOO_LARGE`. A `TapServerError` a handler throws is
+ * answered with its own code and status, and a `TapError` other than the two token
+ * failures with its own code and 400; anything else becomes 500
+ * `TAP_INTERNAL_ERROR` with a fixed message, so an internal failure never reaches
+ * the owner. An events route answers 204 with no body, and every other route
+ * answers the handler's return value as JSON. Export the options object as well as
+ * the handler: `createTestClient` takes the options.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   createTappifyHandler,
+ *   type TappifyHandlerOptions,
+ * } from '@tappify/extension-sdk/server';
+ *
+ * const handlerOptions: TappifyHandlerOptions = {
+ *   extensionId: 'starter',
+ *   health: () => ({ ok: true, version: '0.1.0' }),
+ *   procedures: {
+ *     getSummary: () => ({ installs: 1260, delta: 0.087, topKeyword: 'photo editor' }),
+ *   },
+ * };
+ *
+ * const handler = createTappifyHandler(handlerOptions);
+ * ```
+ */
+declare function createTappifyHandler(options: TappifyHandlerOptions): TappifyFetchHandler;
+
+export { type ContextBlock as C, type MentionItems as M, type TappifyFetchHandler as T, type VerifyTokenOptions as V, type WorkOperation as W, type TappifyClaims as a, type MetricsInput as b, type MetricsResponse as c, type MetricsSeries as d, type TappifyCallContext as e, type TappifyDocuments as f, type TappifyHandlerOptions as g, type TappifyHealth as h, type TappifyInstall as i, type TappifyRequest as j, type TappifyRouteHandler as k, createTappifyHandler as l };

package/dist/handler-kU9Jf36K.d.cts

@@ -0,0 +1,227 @@
+import { JSONWebKeySet } from 'jose';
+import { K as TapPlatformFilter, a as TapFilters, $ as TapSettingsValues, w as TapCredentialValues, ab as ToolId, ac as ToolInput, A as ActionId, k as ActionInput, f as TapProcedureName, g as TapProcedureInput, h as TapProcedureOutput, c as TapHostEvents } from './types-DrpQSv_2.cjs';
+
+/** Which install made the call, as the token's claims name it. */
+interface TappifyInstall {
+    /** The install id, which is the key to scope anything you store yourself by. */
+    id: string;
+    extensionId: string;
+    /** `null` for an install on the workspace rather than one project. */
+    projectId: string | null;
+    organizationId: string;
+}
+/** The project and the filter bar the call was made from. */
+interface TappifyCallContext {
+    projectId: string | null;
+    /** The same value as `filters.platform`, hoisted for convenience. */
+    platform: TapPlatformFilter;
+    /** The range start, as `YYYY-MM-DD`, or an empty string when none was sent. */
+    from: string;
+    /** The range end, as `YYYY-MM-DD`, or an empty string when none was sent. */
+    to: string;
+    filters: TapFilters;
+}
+/**
+ * The install- and organization-scoped storage documents Tappify passes to the
+ * server on every call, keyed by collection name.
+ */
+type TappifyDocuments = Record<string, unknown> & {
+    /** The settings contribution's document, or `null` before it is first saved. */
+    settings?: TapSettingsValues | null;
+};
+/** The verified claims of an install token, as `verifyTappifyToken` returns them. */
+interface TappifyClaims {
+    iss: string;
+    /** Always `ext:<extensionId>`, which is what the verifier checked. */
+    aud: string;
+    exp: number;
+    iat: number;
+    installId: string;
+    extensionId: string;
+    projectId: string | null;
+    organizationId: string;
+    /** The scopes the install granted, as strings. */
+    scopes: string[];
+    /** Present when the token carries one, naming the teammate behind the call. */
+    userId?: string;
+}
+/** The single argument every route handler receives. */
+interface TappifyRequest<TInput = unknown, TEvent = unknown> {
+    install: TappifyInstall;
+    context: TappifyCallContext;
+    /**
+     * The call's `input`, or `{}` when the body carried none, and `undefined` on a
+     * context or events route, which take no input.
+     */
+    input: TInput;
+    credentials: TapCredentialValues;
+    documents: TappifyDocuments;
+    /** The event payload on an events route, and `undefined` on every other. */
+    event: TEvent | undefined;
+    /** The idempotency key from `X-Tappify-Event-Id`; deduplicate writes on it. */
+    eventId: string;
+    claims: TappifyClaims;
+    /** The original request, for a header or the raw body. */
+    request: Request;
+}
+/**
+ * The signature every entry in `TappifyHandlerOptions` has: one argument, and a
+ * value or a promise of one.
+ */
+type TappifyRouteHandler<TInput = unknown, TOutput = unknown, TEvent = unknown> = (request: TappifyRequest<TInput, TEvent>) => TOutput | Promise<TOutput>;
+/** What the `GET /tappify/health` route answers with. */
+interface TappifyHealth {
+    /** Whether the server is ready to take calls; the publish check reads it. */
+    ok: boolean;
+    version?: string;
+    /** A line for the owner when the server is not ready. */
+    message?: string;
+}
+/** What Tappify asks a connector's metrics route for. */
+interface MetricsInput {
+    projectId: string | null;
+    platform: TapPlatformFilter;
+    /** The metric keys to answer for, from the ones the manifest declares. */
+    metrics: string[];
+    from: string;
+    to: string;
+}
+/** One metric's answer inside a `MetricsResponse`. */
+interface MetricsSeries {
+    /** The declared metric key this series answers for. */
+    metric: string;
+    /** Has to match the unit the manifest declares for that key. */
+    unit: 'count' | 'ratio' | 'currency' | 'seconds' | 'bytes';
+    /** One value per declared dimension, when the series is broken down. */
+    dimensions?: Record<string, string>;
+    /** `[timestamp, value]` pairs, oldest first. */
+    points: [string, number][];
+}
+/** What a connector's metrics route answers with: one series per asked metric. */
+interface MetricsResponse {
+    series: MetricsSeries[];
+}
+/** What a mention route answers with: the items the owner can pick from. */
+interface MentionItems {
+    items: {
+        id: string;
+        label: string;
+    }[];
+}
+/** What a context route answers with, for the owner's chat to read. */
+interface ContextBlock {
+    /** A line of prose the assistant can use as it is. */
+    summary: string;
+    /** The numbers behind the summary, for the assistant to quote. */
+    data?: Record<string, unknown>;
+}
+/** The work-tracker operations a handler's `work` table can answer. */
+type WorkOperation = 'list_containers' | 'create' | 'attach' | 'comment' | 'status' | 'resolve';
+/** The second argument of `verifyTappifyToken`. */
+interface VerifyTokenOptions {
+    /** The `id` from the manifest; the token's audience has to be `ext:<id>`. */
+    extensionId: string;
+    /** Where to fetch the signing keys. Defaults to `DEFAULT_JWKS_URL`. */
+    jwksUrl?: string;
+    /** A key set to verify against, which skips the fetch. For tests. */
+    jwks?: JSONWebKeySet;
+}
+/**
+ * The routes and settings `createTappifyHandler` builds a fetch handler from.
+ *
+ * @remarks
+ * The `tools`, `actions` and `procedures` tables are keyed by the names the
+ * augmentation `tappify extension types` writes, so a handler for an undeclared
+ * name does not compile. `events` is keyed by Tappify's own event catalogue and
+ * `work` by the fixed set of work operations; `mentions` and `context` take any id.
+ * A route Tappify calls with no handler registered answers 404 with
+ * `TAP_HANDLER_MISSING`. Export this object as well as the handler: the testing
+ * entry's `createTestClient` takes the options, not the built handler.
+ */
+interface TappifyHandlerOptions {
+    /** The `id` from the manifest, which the install token's audience has to match. */
+    extensionId: string;
+    /** Where to fetch the signing keys. Defaults to `DEFAULT_JWKS_URL`. */
+    jwksUrl?: string;
+    /** A key set to verify against, which skips the fetch. For tests. */
+    jwks?: JSONWebKeySet;
+    /** The prefix your framework mounts the handler under, such as `/api`. */
+    basePath?: string;
+    /** Answers `GET /tappify/health`. Left out, the route answers `{ ok: true }`. */
+    health?: () => TappifyHealth | Promise<TappifyHealth>;
+    /** Answers `POST /tappify/metrics` for a connector contribution. */
+    metrics?: TappifyRouteHandler<MetricsInput, MetricsResponse>;
+    /** One handler per declared tool, answering `POST /tappify/tools/<id>`. */
+    tools?: {
+        [T in ToolId]?: TappifyRouteHandler<ToolInput<T>, unknown>;
+    };
+    /** One handler per declared mention, answering `GET /tappify/mentions/<id>?q=`. */
+    mentions?: Record<string, TappifyRouteHandler<{
+        q: string;
+    }, MentionItems>>;
+    /** One handler per declared action, answering `POST /tappify/actions/<id>`. */
+    actions?: {
+        [A in ActionId]?: TappifyRouteHandler<ActionInput<A>, unknown>;
+    };
+    /** One handler per declared procedure, which is what `useTapServer` calls. */
+    procedures?: {
+        [N in TapProcedureName]?: TappifyRouteHandler<TapProcedureInput<N>, TapProcedureOutput<N>>;
+    };
+    /** One handler per declared context block, answering `GET /tappify/context/<id>`. */
+    context?: Record<string, TappifyRouteHandler<undefined, ContextBlock>>;
+    /** One handler per Tappify event you subscribe to; each answers 204. */
+    events?: {
+        [E in keyof TapHostEvents]?: TappifyRouteHandler<undefined, void, TapHostEvents[E]>;
+    };
+    /** One handler per work operation, answering `POST /tappify/work/<operation>`. */
+    work?: {
+        [O in WorkOperation]?: TappifyRouteHandler<Record<string, unknown>, unknown>;
+    };
+}
+
+/**
+ * What `createTappifyHandler` returns: a `fetch` handler, which is what Cloudflare
+ * Workers, Vercel and the two adapters all take.
+ */
+type TappifyFetchHandler = (request: Request) => Promise<Response>;
+/**
+ * Builds the one `fetch` handler that answers every route Tappify calls on your
+ * server.
+ *
+ * @remarks
+ * It routes the paths under `/tappify`, minus `basePath` when your framework mounts
+ * it under a prefix, and hands each matched handler a `TappifyRequest`. Every
+ * route but `GET /tappify/health` needs a bearer install token, which it verifies
+ * with `verifyTappifyToken`, and an `X-Tappify-Event-Id` header; a missing token is
+ * 401 `TAP_TOKEN_MISSING`, a missing id 400 `TAP_EVENT_ID_MISSING`, an unknown path
+ * 404 `TAP_ROUTE_UNKNOWN` and a declared name with no handler 404
+ * `TAP_HANDLER_MISSING`. A body that is not JSON is 400 `TAP_BODY_INVALID` and one
+ * over 1 MB is 413 `TAP_BODY_TOO_LARGE`. A `TapServerError` a handler throws is
+ * answered with its own code and status, and a `TapError` other than the two token
+ * failures with its own code and 400; anything else becomes 500
+ * `TAP_INTERNAL_ERROR` with a fixed message, so an internal failure never reaches
+ * the owner. An events route answers 204 with no body, and every other route
+ * answers the handler's return value as JSON. Export the options object as well as
+ * the handler: `createTestClient` takes the options.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   createTappifyHandler,
+ *   type TappifyHandlerOptions,
+ * } from '@tappify/extension-sdk/server';
+ *
+ * const handlerOptions: TappifyHandlerOptions = {
+ *   extensionId: 'starter',
+ *   health: () => ({ ok: true, version: '0.1.0' }),
+ *   procedures: {
+ *     getSummary: () => ({ installs: 1260, delta: 0.087, topKeyword: 'photo editor' }),
+ *   },
+ * };
+ *
+ * const handler = createTappifyHandler(handlerOptions);
+ * ```
+ */
+declare function createTappifyHandler(options: TappifyHandlerOptions): TappifyFetchHandler;
+
+export { type ContextBlock as C, type MentionItems as M, type TappifyFetchHandler as T, type VerifyTokenOptions as V, type WorkOperation as W, type TappifyClaims as a, type MetricsInput as b, type MetricsResponse as c, type MetricsSeries as d, type TappifyCallContext as e, type TappifyDocuments as f, type TappifyHandlerOptions as g, type TappifyHealth as h, type TappifyInstall as i, type TappifyRequest as j, type TappifyRouteHandler as k, createTappifyHandler as l };

package/dist/host.cjs

@@ -0,0 +1,24 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk7KIKOH5Hcjs = require('./chunk-7KIKOH5H.cjs');
+
+
+var _chunkOPPYEA7Fcjs = require('./chunk-OPPYEA7F.cjs');
+require('./chunk-2DBSVKAU.cjs');
+
+// src/host/collect-styles.ts
+function collectStyles(remoteModule) {
+  if (typeof remoteModule !== "object" || remoteModule === null) return [];
+  if (!("styles" in remoteModule)) return [];
+  const styles = remoteModule.styles;
+  if (!Array.isArray(styles)) return [];
+  return styles.filter((entry) => typeof entry === "string");
+}
+
+
+
+
+
+exports.TapContext = _chunkOPPYEA7Fcjs.TapContext; exports.TapHostProvider = _chunk7KIKOH5Hcjs.TapHostProvider; exports.collectStyles = collectStyles; exports.createHostQueryClient = _chunk7KIKOH5Hcjs.createHostQueryClient;
+//# sourceMappingURL=host.cjs.map

package/dist/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/host.cjs","../src/host/collect-styles.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACTO,SAAS,aAAA,CAAc,YAAA,EAAiC;AAC7D,EAAA,GAAA,CAAI,OAAO,aAAA,IAAiB,SAAA,GAAY,aAAA,IAAiB,IAAA,EAAM,OAAO,CAAC,CAAA;AACvE,EAAA,GAAA,CAAI,CAAA,CAAE,SAAA,GAAY,YAAA,CAAA,EAAe,OAAO,CAAC,CAAA;AAEzC,EAAA,MAAM,OAAA,EAAS,YAAA,CAAa,MAAA;AAC5B,EAAA,GAAA,CAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA,EAAG,OAAO,CAAC,CAAA;AAEpC,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,CAAC,KAAA,EAAA,GAA2B,OAAO,MAAA,IAAU,QAAQ,CAAA;AAC5E;ADSA;AACE;AACA;AACA;AACA;AACF,+NAAC","file":"/Users/vulakh/Desktop/Work/Tappify/extension-sdk/dist/host.cjs","sourcesContent":[null,"export function collectStyles(remoteModule: unknown): string[] {\n  if (typeof remoteModule !== 'object' || remoteModule === null) return [];\n  if (!('styles' in remoteModule)) return [];\n\n  const styles = remoteModule.styles;\n  if (!Array.isArray(styles)) return [];\n\n  return styles.filter((entry): entry is string => typeof entry === 'string');\n}\n"]}

package/dist/host.d.cts

@@ -0,0 +1,24 @@
+export { T as TapContext } from './context-Dt6xh_5t.cjs';
+import { T as Tap } from './types-DrpQSv_2.cjs';
+export { A as ActionId, k as ActionInput, P as PromptId, l as PromptInput, m as TapActionMap, n as TapActionRun, o as TapApp, p as TapChangeKey, q as TapChatCard, r as TapCollection, s as TapComparisonSide, t as TapConfirmOptions, u as TapCrashIssue, v as TapCrashesResult, w as TapCredentialValues, x as TapCredentials, y as TapDateRange, a as TapFilters, z as TapFormatters, B as TapHostEventMap, c as TapHostEvents, C as TapInternals, D as TapKeyword, E as TapKeywordsResult, F as TapListing, G as TapListingResult, H as TapPageProps, I as TapPath, J as TapPlatform, K as TapPlatformFilter, g as TapProcedureInput, L as TapProcedureMap, f as TapProcedureName, h as TapProcedureOutput, M as TapProcedures, N as TapProjectResult, O as TapPromptMap, d as TapQuery, Q as TapRelease, e as TapResult, R as TapRevenueResult, S as TapReview, U as TapReviewsResult, V as TapRowActionProps, W as TapSeriesMetric, X as TapSeriesPoint, Y as TapSeriesResult, Z as TapSettings, _ as TapSettingsProps, $ as TapSettingsValues, a0 as TapSingleton, j as TapSingletonDocument, i as TapSingletonName, b as TapSize, a1 as TapStorage, a2 as TapStorageMap, a3 as TapTabProps, a4 as TapTableColumn, a5 as TapTelemetryEvents, a6 as TapToastTone, a7 as TapToolMap, a8 as TapWebhookMap, a9 as TapWidgetProps, aa as TelemetryEvent, ab as ToolId, ac as ToolInput, ad as WebhookName, ae as WebhookPayload } from './types-DrpQSv_2.cjs';
+import { QueryClient } from '@tanstack/react-query';
+import { ReactNode, ReactElement } from 'react';
+export { D as DataQueryKind, H as HostEventName, a as HostPage, S as ScopeKey, b as SlotId } from './constants-DJ_KgZpN.cjs';
+
+declare function collectStyles(remoteModule: unknown): string[];
+
+interface TapHostProviderProps {
+    tap: Tap;
+    children: ReactNode;
+    /**
+     * A host that already renders a QueryClientProvider leaves this out; a
+     * standalone host such as the portal preview passes one from
+     * `createHostQueryClient()` so the data hooks find a client.
+     */
+    queryClient?: QueryClient;
+}
+declare function TapHostProvider({ tap, children, queryClient, }: TapHostProviderProps): ReactElement;
+/** The query client a standalone host hands to `TapHostProvider`; reads never retry. */
+declare function createHostQueryClient(): QueryClient;
+
+export { Tap, TapHostProvider, type TapHostProviderProps, collectStyles, createHostQueryClient };

package/dist/host.d.ts

@@ -0,0 +1,24 @@
+export { T as TapContext } from './context-Ml7k_V14.js';
+import { T as Tap } from './types-DDAGLpov.js';
+export { A as ActionId, k as ActionInput, P as PromptId, l as PromptInput, m as TapActionMap, n as TapActionRun, o as TapApp, p as TapChangeKey, q as TapChatCard, r as TapCollection, s as TapComparisonSide, t as TapConfirmOptions, u as TapCrashIssue, v as TapCrashesResult, w as TapCredentialValues, x as TapCredentials, y as TapDateRange, a as TapFilters, z as TapFormatters, B as TapHostEventMap, c as TapHostEvents, C as TapInternals, D as TapKeyword, E as TapKeywordsResult, F as TapListing, G as TapListingResult, H as TapPageProps, I as TapPath, J as TapPlatform, K as TapPlatformFilter, g as TapProcedureInput, L as TapProcedureMap, f as TapProcedureName, h as TapProcedureOutput, M as TapProcedures, N as TapProjectResult, O as TapPromptMap, d as TapQuery, Q as TapRelease, e as TapResult, R as TapRevenueResult, S as TapReview, U as TapReviewsResult, V as TapRowActionProps, W as TapSeriesMetric, X as TapSeriesPoint, Y as TapSeriesResult, Z as TapSettings, _ as TapSettingsProps, $ as TapSettingsValues, a0 as TapSingleton, j as TapSingletonDocument, i as TapSingletonName, b as TapSize, a1 as TapStorage, a2 as TapStorageMap, a3 as TapTabProps, a4 as TapTableColumn, a5 as TapTelemetryEvents, a6 as TapToastTone, a7 as TapToolMap, a8 as TapWebhookMap, a9 as TapWidgetProps, aa as TelemetryEvent, ab as ToolId, ac as ToolInput, ad as WebhookName, ae as WebhookPayload } from './types-DDAGLpov.js';
+import { QueryClient } from '@tanstack/react-query';
+import { ReactNode, ReactElement } from 'react';
+export { D as DataQueryKind, H as HostEventName, a as HostPage, S as ScopeKey, b as SlotId } from './constants-DJ_KgZpN.js';
+
+declare function collectStyles(remoteModule: unknown): string[];
+
+interface TapHostProviderProps {
+    tap: Tap;
+    children: ReactNode;
+    /**
+     * A host that already renders a QueryClientProvider leaves this out; a
+     * standalone host such as the portal preview passes one from
+     * `createHostQueryClient()` so the data hooks find a client.
+     */
+    queryClient?: QueryClient;
+}
+declare function TapHostProvider({ tap, children, queryClient, }: TapHostProviderProps): ReactElement;
+/** The query client a standalone host hands to `TapHostProvider`; reads never retry. */
+declare function createHostQueryClient(): QueryClient;
+
+export { Tap, TapHostProvider, type TapHostProviderProps, collectStyles, createHostQueryClient };

package/dist/host.mjs

@@ -0,0 +1,24 @@
+import {
+  TapHostProvider,
+  createHostQueryClient
+} from "./chunk-4C5Z3CIK.mjs";
+import {
+  TapContext
+} from "./chunk-QHM7XNRK.mjs";
+import "./chunk-CSTYBKZC.mjs";
+
+// src/host/collect-styles.ts
+function collectStyles(remoteModule) {
+  if (typeof remoteModule !== "object" || remoteModule === null) return [];
+  if (!("styles" in remoteModule)) return [];
+  const styles = remoteModule.styles;
+  if (!Array.isArray(styles)) return [];
+  return styles.filter((entry) => typeof entry === "string");
+}
+export {
+  TapContext,
+  TapHostProvider,
+  collectStyles,
+  createHostQueryClient
+};
+//# sourceMappingURL=host.mjs.map

package/dist/host.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host/collect-styles.ts"],"sourcesContent":["export function collectStyles(remoteModule: unknown): string[] {\n  if (typeof remoteModule !== 'object' || remoteModule === null) return [];\n  if (!('styles' in remoteModule)) return [];\n\n  const styles = remoteModule.styles;\n  if (!Array.isArray(styles)) return [];\n\n  return styles.filter((entry): entry is string => typeof entry === 'string');\n}\n"],"mappings":";;;;;;;;;;AAAO,SAAS,cAAc,cAAiC;AAC7D,MAAI,OAAO,iBAAiB,YAAY,iBAAiB,KAAM,QAAO,CAAC;AACvE,MAAI,EAAE,YAAY,cAAe,QAAO,CAAC;AAEzC,QAAM,SAAS,aAAa;AAC5B,MAAI,CAAC,MAAM,QAAQ,MAAM,EAAG,QAAO,CAAC;AAEpC,SAAO,OAAO,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ;AAC5E;","names":[]}