@fanvue/builder-sdk 0.3.0 → 0.5.0

package/dist/index-C3CXrRiw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-C3CXrRiw.d.ts","names":[],"sources":["../src/core/constants.ts","../src/core/contracts/access-mode.ts","../src/core/contracts/env.ts","../src/core/contracts/errors.ts","../src/core/contracts/experience-protocol.ts","../src/core/contracts/pagination.ts","../src/core/defaults.ts","../src/core/types.ts","../src/core/oauth.ts","../src/core/session.ts","../src/core/embedded.ts","../src/core/json.ts","../src/core/schemas.ts","../src/core/client.ts","../src/core/machine-auth/machine-auth.ts","../src/core/observability/log-fields.ts","../src/core/observability/readiness.ts","../src/core/observability/sentry-scrubber.ts"],"mappings":"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"}

package/dist/index-CEFYZtlb.d.ts

@@ -0,0 +1,223 @@
+import { C as $strip, b as ZodUnknown, c as ZodLiteral, d as ZodObject, f as ZodOptional, h as ZodString, m as ZodRecord, n as ZodArray, r as ZodBoolean, s as ZodEnum, t as Result, u as ZodNumber, x as output, y as ZodUnion } from "./index-cf3ZMnLJ.js";
+
+//#region src/bridge/protocol.d.ts
+/**
+ * The bridge protocol version spoken by this SDK.
+ *
+ * Both sides send it on every message. Changes within a version must be
+ * additive; anything breaking increments the version, and the host answers the
+ * handshake with the highest version both sides speak.
+ */
+declare const BRIDGE_VERSION = 1;
+/**
+ * Message type the embedded app posts to the host to open a handshake.
+ *
+ * An app may re-announce (it re-posts `ready` until a `hello` lands, in case
+ * the host attached its listener late).
+ */
+declare const BRIDGE_READY_TYPE = "fanvue:bridge:ready";
+/**
+ * Message type the host posts back, carrying the granted capabilities and the port.
+ *
+ * The host answers each verified `ready` with a fresh `hello` and port,
+ * closing the prior port; the app adopts the newest `hello`.
+ */
+declare const BRIDGE_HELLO_TYPE = "fanvue:bridge:hello";
+/** Capability namespace for analytics (`analytics.track`). */
+declare const ANALYTICS_CAPABILITY = "analytics";
+/** Method name for tracking an analytics event. */
+declare const ANALYTICS_TRACK_METHOD = "track";
+/** The host capabilities an app can be granted. Grants are resolved server-side. */
+declare const bridgeCapabilitySchema: ZodEnum<{
+  analytics: "analytics";
+}>;
+/** A host capability an app can be granted. */
+type BridgeCapability = output<typeof bridgeCapabilitySchema>;
+/**
+ * Error codes the host can return for a request.
+ *
+ * - `capability_denied` — the app was not granted the requested capability.
+ * - `invalid_payload` — the payload failed the host's schema for the method.
+ * - `rate_limited` — the app exceeded the host's budget for the method.
+ * - `internal` — the host handler failed unexpectedly.
+ */
+declare const bridgeErrorCodeSchema: ZodEnum<{
+  capability_denied: "capability_denied";
+  invalid_payload: "invalid_payload";
+  rate_limited: "rate_limited";
+  internal: "internal";
+}>;
+/** An error code the host can return for a request. */
+type BridgeErrorCode = output<typeof bridgeErrorCodeSchema>;
+/** Schema for the `ready` message an app posts to `window.parent`. */
+declare const bridgeReadyMessageSchema: ZodObject<{
+  type: ZodLiteral<"fanvue:bridge:ready">;
+  v: ZodLiteral<1>;
+}, $strip>;
+/** The `ready` message an app posts to `window.parent` to open a handshake. */
+type BridgeReadyMessage = output<typeof bridgeReadyMessageSchema>;
+/** Schema for the `hello` message the host posts back with the transferred port. */
+declare const bridgeHelloMessageSchema: ZodObject<{
+  type: ZodLiteral<"fanvue:bridge:hello">;
+  v: ZodLiteral<1>;
+  capabilities: ZodArray<ZodEnum<{
+    analytics: "analytics";
+  }>>;
+}, $strip>;
+/** The `hello` message the host posts back, alongside the transferred port. */
+type BridgeHelloMessage = output<typeof bridgeHelloMessageSchema>;
+/**
+ * Schema for a request sent app → host over the port.
+ *
+ * Capability and method names are bounded so a misbehaving sender cannot make
+ * either side hold or log arbitrarily large strings.
+ */
+declare const bridgeRequestSchema: ZodObject<{
+  v: ZodLiteral<1>;
+  id: ZodString;
+  kind: ZodLiteral<"request">;
+  capability: ZodString;
+  method: ZodString;
+  payload: ZodUnknown;
+}, $strip>;
+/** A request sent app → host over the port, correlated to a response by `id`. */
+type BridgeRequest = output<typeof bridgeRequestSchema>;
+/**
+ * Schema for a response sent host → app over the port.
+ *
+ * The `id` and `error.message` are bounded like the request fields, so a
+ * misbehaving host cannot push oversized strings into the app.
+ */
+declare const bridgeResponseSchema: ZodObject<{
+  v: ZodLiteral<1>;
+  id: ZodString;
+  kind: ZodLiteral<"response">;
+  ok: ZodBoolean;
+  result: ZodOptional<ZodUnknown>;
+  error: ZodOptional<ZodObject<{
+    code: ZodEnum<{
+      capability_denied: "capability_denied";
+      invalid_payload: "invalid_payload";
+      rate_limited: "rate_limited";
+      internal: "internal";
+    }>;
+    message: ZodString;
+  }, $strip>>;
+}, $strip>;
+/** A response sent host → app over the port, correlated to a request by `id`. */
+type BridgeResponse = output<typeof bridgeResponseSchema>;
+/**
+ * Event names an app may emit.
+ *
+ * The host prefixes every name with `embedded_app_` before it reaches
+ * Amplitude, so an app can never emit a core platform event. Names are
+ * snake_case to match the platform's tracking-plan convention.
+ */
+declare const analyticsEventNameSchema: ZodString;
+/**
+ * Properties attached to an analytics event: a flat record of short scalars.
+ *
+ * Nesting is rejected so the payload stays cheap to validate and to read in
+ * Amplitude, and `$`-prefixed keys are rejected because Amplitude reserves them.
+ * Numbers must be finite — `Infinity` and `NaN` do not survive serialisation.
+ */
+declare const analyticsPropertiesSchema: ZodRecord<ZodString, ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>>;
+/** Schema for the payload of `analytics.track`. */
+declare const analyticsTrackPayloadSchema: ZodObject<{
+  eventName: ZodString;
+  properties: ZodOptional<ZodRecord<ZodString, ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean]>>>;
+}, $strip>;
+/** The payload of `analytics.track`. */
+type AnalyticsTrackPayload = output<typeof analyticsTrackPayloadSchema>;
+/** Properties attached to an analytics event. */
+type AnalyticsProperties = output<typeof analyticsPropertiesSchema>;
+//#endregion
+//#region src/bridge/bridge.d.ts
+/**
+ * Why a bridge request failed.
+ *
+ * Beyond the codes the host can return, the SDK adds `TIMEOUT` (the host never
+ * answered) and `PORT_CLOSED` (the message could not be put on the port —
+ * in practice the payload was not structured-cloneable). Note that
+ * `postMessage` on a closed port silently drops rather than throwing, so a
+ * torn-down host surfaces as `TIMEOUT`, not `PORT_CLOSED`.
+ */
+interface BridgeRequestError {
+  code: BridgeErrorCode | 'TIMEOUT' | 'PORT_CLOSED';
+  message: string;
+}
+/** The analytics capability, as exposed on a connected bridge. */
+interface FanvueBridgeAnalytics {
+  track: (eventName: string, properties?: AnalyticsProperties) => Promise<Result<void, BridgeRequestError>>;
+}
+/**
+ * A live connection to the Fanvue host page.
+ *
+ * @property capabilities - The capabilities the host granted this app.
+ * @property has - Whether a given capability was granted. Checking is
+ *   optional: calling a capability without checking is safe and returns
+ *   `capability_denied`.
+ * @property analytics - Fires events through the host page's Amplitude client.
+ */
+interface FanvueBridge {
+  capabilities: readonly BridgeCapability[];
+  has: (capability: BridgeCapability) => boolean;
+  analytics: FanvueBridgeAnalytics;
+}
+//#endregion
+//#region src/bridge/connect.d.ts
+/**
+ * Why connecting to the host failed.
+ *
+ * - `NOT_EMBEDDED` — the app is not running in an iframe, so there is no host.
+ * - `TIMEOUT` — no `hello` arrived. The page is framed by something other than
+ *   Fanvue, or Fanvue refused the handshake (unregistered embed origin).
+ */
+interface BridgeConnectError {
+  code: 'NOT_EMBEDDED' | 'TIMEOUT';
+  message: string;
+}
+/**
+ * Options for {@link connectFanvueBridge}.
+ *
+ * @property timeoutMs - How long to wait for the host's `hello`. Defaults to 3000.
+ */
+interface ConnectFanvueBridgeOptions {
+  timeoutMs?: number;
+}
+/**
+ * Opens the capability bridge to the Fanvue page hosting this app.
+ *
+ * Posts `fanvue:bridge:ready` to `window.parent` and waits for the host's
+ * `fanvue:bridge:hello`, which names the granted capabilities and transfers the
+ * `MessagePort` all later traffic flows over. The host verifies the frame's
+ * origin before replying, so a page framed by anything other than its
+ * registered Fanvue surface simply times out.
+ *
+ * `ready` is re-posted every 500ms until a `hello` lands (or the timeout
+ * fires), because the host may attach its listener after the app's first
+ * announce. The host answers each verified `ready` with a fresh `hello` and
+ * port, closing the prior port — so the bridge keeps listening for the
+ * lifetime of the connection and adopts the newest `hello` by swapping onto
+ * its port. Requests in flight on a superseded port fail by their timeouts.
+ *
+ * Calling this again is safe and is how an app reconnects after the iframe
+ * reloads: the host closes the previous port and re-handshakes.
+ *
+ * Failure is not exceptional — apps are expected to keep working standalone
+ * (local dev, previews) where the connection never succeeds.
+ *
+ * @param options - Optional overrides (e.g. a shorter `timeoutMs`).
+ * @returns A `Result` with the connected {@link FanvueBridge}, or a
+ *   {@link BridgeConnectError} when there is no host to talk to.
+ *
+ * @example
+ * const result = await connectFanvueBridge();
+ * if (result.isOk() && result.value.has('analytics')) {
+ *   await result.value.analytics.track('course_created', { chapters: 4 });
+ * }
+ */
+declare function connectFanvueBridge(options?: ConnectFanvueBridgeOptions): Promise<Result<FanvueBridge, BridgeConnectError>>;
+//#endregion
+export { bridgeCapabilitySchema as C, bridgeRequestSchema as D, bridgeReadyMessageSchema as E, bridgeResponseSchema as O, analyticsTrackPayloadSchema as S, bridgeHelloMessageSchema as T, BridgeReadyMessage as _, FanvueBridge as a, analyticsEventNameSchema as b, ANALYTICS_TRACK_METHOD as c, BRIDGE_HELLO_TYPE as d, BRIDGE_READY_TYPE as f, BridgeHelloMessage as g, BridgeErrorCode as h, BridgeRequestError as i, AnalyticsProperties as l, BridgeCapability as m, ConnectFanvueBridgeOptions as n, FanvueBridgeAnalytics as o, BRIDGE_VERSION as p, connectFanvueBridge as r, ANALYTICS_CAPABILITY as s, BridgeConnectError as t, AnalyticsTrackPayload as u, BridgeRequest as v, bridgeErrorCodeSchema as w, analyticsPropertiesSchema as x, BridgeResponse as y };
+//# sourceMappingURL=index-CEFYZtlb.d.ts.map

package/dist/index-CEFYZtlb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CEFYZtlb.d.ts","names":[],"sources":["../src/bridge/protocol.ts","../src/bridge/bridge.ts","../src/bridge/connect.ts"],"mappings":";;;;;AASA;;;;;cAAa,cAAA;;;;;AAgBb;;cARa,iBAAA;;;AAWb;;;;cAHa,iBAAA;AAMb;AAAA,cAHa,oBAAA;;cAGA,sBAAA;;cAGA,sBAAA,EAAsB,OAAA;;;;KAGvB,gBAAA,GAAmB,MAAA,QAAe,sBAAA;;;;;AAA9C;;;;cAUa,qBAAA,EAAqB,OAAA;;;;;;;KAQtB,eAAA,GAAkB,MAAA,QAAe,qBAAA;;cAGhC,wBAAA,EAAwB,SAAA;;;;;KAMzB,kBAAA,GAAqB,MAAA,QAAe,wBAAA;;cAGnC,wBAAA,EAAwB,SAAA;;;;;;;;KAOzB,kBAAA,GAAqB,MAAA,QAAe,wBAAA;;AAhBhD;;;;;cAwBa,mBAAA,EAAmB,SAAA;;;;;;;;;KAUpB,aAAA,GAAgB,MAAA,QAAe,mBAAA;;;;;;;cAQ9B,oBAAA,EAAoB,SAAA;;;;;;;;;;;;;;;;;KAUrB,cAAA,GAAiB,MAAA,QAAe,oBAAA;;;;;;;;cAS/B,wBAAA,EAAwB,SAAA;;;;;;;;cA0BxB,yBAAA,EAAyB,SAAA,CAAA,SAAA,EAAA,QAAA,WAAA,SAAA,EAAA,SAAA,EAAA,UAAA;;cAazB,2BAAA,EAA2B,SAAA;;;;;KAM5B,qBAAA,GAAwB,MAAA,QAAe,2BAAA;;KAGvC,mBAAA,GAAsB,MAAA,QAAe,yBAAA;;;;AA9JjD;;;;;AAQA;;;UCUiB,kBAAA;EACf,IAAA,EAAM,eAAA;EACN,OAAA;AAAA;;UAIe,qBAAA;EACf,KAAA,GACE,SAAA,UACA,UAAA,GAAa,mBAAA,KACV,OAAA,CAAQ,MAAA,OAAa,kBAAA;AAAA;;;;;ADN5B;;;;;UCkBiB,YAAA;EACf,YAAA,WAAuB,gBAAA;EACvB,GAAA,GAAM,UAAA,EAAY,gBAAA;EAClB,SAAA,EAAW,qBAAA;AAAA;;;;AD3Cb;;;;;AAQA;UEkBiB,kBAAA;EACf,IAAA;EACA,OAAA;AAAA;AFZF;;;;;AAAA,UEoBiB,0BAAA;EACf,SAAA;AAAA;;;AFfF;;;;;AAGA;;;;;;;;;AAGA;;;;;;;;;AAUA;;;;;;;iBEkCgB,mBAAA,CACd,OAAA,GAAU,0BAAA,GACT,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,kBAAA"}