@farthershore/farthershore-js 0.0.0

package/dist/catalog.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+import { type FartherShoreConfig } from "./config.js";
+import { type ProductResource } from "./resources/product.js";
+import { type AuthResource } from "./resources/auth.js";
+import { type KeysResource } from "./resources/keys.js";
+import { type UsageResource } from "./resources/usage.js";
+import { type BillingResource } from "./resources/billing.js";
+import { type PlansResource } from "./resources/plans.js";
+import { type AnalyticsResource } from "./resources/analytics.js";
+import { type FeatureHandle, type GatewayRequestInit } from "./resources/feature.js";
+import type { Bootstrap } from "./types.js";
+export interface FartherShoreClient {
+    /** Resolve + cache the product/env/gateway for the current portal host. Safe
+     *  to call repeatedly (memoized). */
+    bootstrap(): Promise<Bootstrap>;
+    /** Set the consumer API key used for Gateway feature calls. */
+    setApiKey(key: string | null): void;
+    /** Set the Core session bearer directly (e.g. from the Clerk browser SDK). */
+    setSessionToken(token: string | null): void;
+    readonly product: ProductResource;
+    readonly auth: AuthResource;
+    readonly keys: KeysResource;
+    readonly usage: UsageResource;
+    readonly billing: BillingResource;
+    /** The product's plan catalog + the subscribe/checkout flow. */
+    readonly plans: PlansResource;
+    readonly analytics: AnalyticsResource;
+    /** A handle to a builder-defined feature, routed through the Gateway. */
+    feature(name: string): FeatureHandle;
+    /** Generic Gateway call (alias for `feature("…").fetch`). */
+    invoke(path: string, init?: GatewayRequestInit): Promise<Response>;
+}
+export declare function createFartherShoreClient(config: FartherShoreConfig): FartherShoreClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC;yCACqC;IACrC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,+DAA+D;IAC/D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,8EAA8E;IAC9E,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAE5C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAEtC,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACrC,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACpE;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAwCpB"}

package/dist/client.js

@@ -0,0 +1,56 @@
+// The client factory. Frontend code creates one client (usually with just a
+// coreUrl), then expresses intent — `fs.usage.summary()`, `fs.keys.list()`,
+// `fs.feature("weather").json("/forecast")`. The client owns ALL routing: Core
+// vs Gateway, auth, host/env scoping.
+import { buildContext, } from "./config.js";
+import { resolveBootstrap } from "./bootstrap.js";
+import { gatewayFetch } from "./http.js";
+import { createProductResource, } from "./resources/product.js";
+import { createAuthResource } from "./resources/auth.js";
+import { createKeysResource } from "./resources/keys.js";
+import { createUsageResource } from "./resources/usage.js";
+import { createBillingResource, } from "./resources/billing.js";
+import { createPlansResource } from "./resources/plans.js";
+import { createAnalyticsResource, } from "./resources/analytics.js";
+import { createFeature, } from "./resources/feature.js";
+export function createFartherShoreClient(config) {
+    const ctx = buildContext(config);
+    let cached = null;
+    let inflight = null;
+    function ensureBootstrap() {
+        if (cached)
+            return Promise.resolve(cached);
+        if (!inflight) {
+            inflight = resolveBootstrap(ctx)
+                .then((b) => {
+                cached = b;
+                inflight = null;
+                return b;
+            })
+                .catch((e) => {
+                inflight = null;
+                throw e;
+            });
+        }
+        return inflight;
+    }
+    return {
+        bootstrap: ensureBootstrap,
+        setApiKey(key) {
+            ctx.apiKey = key;
+        },
+        setSessionToken(token) {
+            ctx.sessionToken = token;
+        },
+        product: createProductResource(ensureBootstrap),
+        auth: createAuthResource(ctx),
+        keys: createKeysResource(ctx),
+        usage: createUsageResource(ctx),
+        billing: createBillingResource(ctx),
+        plans: createPlansResource(ctx, ensureBootstrap),
+        analytics: createAnalyticsResource(),
+        feature: (name) => createFeature(ctx, name),
+        invoke: (path, init) => gatewayFetch(ctx, path, init),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,sCAAsC;AAEtC,OAAO,EAGL,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,uBAAuB,GAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,GAGd,MAAM,wBAAwB,CAAC;AA2BhC,MAAM,UAAU,wBAAwB,CACtC,MAA0B;IAE1B,MAAM,GAAG,GAAkB,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAA8B,IAAI,CAAC;IAC/C,SAAS,eAAe;QACtB,IAAI,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC;iBAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,MAAM,GAAG,CAAC,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;gBACpB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,eAAe;QAC1B,SAAS,CAAC,GAAG;YACX,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QACnB,CAAC;QACD,eAAe,CAAC,KAAK;YACnB,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,qBAAqB,CAAC,eAAe,CAAC;QAC/C,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAC7B,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAC7B,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC;QAC/B,OAAO,EAAE,qBAAqB,CAAC,GAAG,CAAC;QACnC,KAAK,EAAE,mBAAmB,CAAC,GAAG,EAAE,eAAe,CAAC;QAChD,SAAS,EAAE,uBAAuB,EAAE;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC;QAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,53 @@
+export type FetchLike = typeof fetch;
+/** Returns the current session bearer token (Clerk session JWT or persona JWT),
+ *  or null/undefined when signed out. May be async (e.g. Clerk's getToken). */
+export type TokenProvider = () => string | null | undefined | Promise<string | null | undefined>;
+export interface FartherShoreConfig {
+    /** Platform Core base URL (cross-origin from a static portal), e.g.
+     *  `https://core.farthershore.com`. The only required field. */
+    coreUrl: string;
+    /** Portal host that identifies the product/env to Core. Defaults to
+     *  `globalThis.location.host` in the browser. */
+    portalHost?: string;
+    /** Pin the product id. Usually omitted — `bootstrap()` discovers it from the
+     *  portal host. */
+    productId?: string;
+    /** Ephemeral/preview environment id (scopes test-mode + env-branch reads). */
+    environmentId?: string | null;
+    /** Owning org id for org-owned subscriptions (the `x-fs-organization-id`
+     *  header / `organizationId` query). */
+    organizationId?: string | null;
+    /** Override the Gateway origin. Normally derived from the product's
+     *  `runtimeHostname` discovered at bootstrap. */
+    gatewayUrl?: string;
+    /** The consumer API key (`fsk_…`) used to authenticate Gateway feature calls.
+     *  Settable later via `fs.setApiKey()`. */
+    apiKey?: string;
+    /** Session token provider for Core calls. The host app owns the session (the
+     *  Clerk browser SDK, or the persona sign-in flow `fs.auth.signIn`). When the
+     *  persona flow is used, the SDK manages the token itself. */
+    getToken?: TokenProvider;
+    /** Injectable fetch (tests / non-browser runtimes). Defaults to global fetch. */
+    fetch?: FetchLike;
+}
+/** Mutable, per-client runtime context the resources share. Bootstrap fills in
+ *  the discovered product/env/gateway; sign-in fills in the session token. */
+export interface ClientContext {
+    coreUrl: string;
+    portalHost: string | null;
+    productId: string | null;
+    environmentId: string | null;
+    organizationId: string | null;
+    gatewayUrl: string | null;
+    apiKey: string | null;
+    /** SDK-managed session token (set by `fs.auth.signIn`), falling back to the
+     *  configured `getToken` provider. */
+    sessionToken: string | null;
+    getToken?: TokenProvider;
+    fetch: FetchLike;
+}
+export declare function buildContext(config: FartherShoreConfig): ClientContext;
+/** Resolve the bearer token for a Core request: the SDK-managed session token
+ *  (persona sign-in) wins, else the configured provider. */
+export declare function resolveToken(ctx: ClientContext): Promise<string | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC;+EAC+E;AAC/E,MAAM,MAAM,aAAa,GAAG,MACxB,MAAM,GACN,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC;oEACgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;qDACiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uBACmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;4CACwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;qDACiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;+CAC2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;kEAE8D;IAC9D,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,iFAAiF;IACjF,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;8EAC8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;0CACsC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAMD,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAgCtE;AAED;4DAC4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO7E"}

package/dist/config.js

@@ -0,0 +1,48 @@
+// Client configuration + the shared request context the resources read.
+//
+// The whole point of the SDK: frontend code never sees Core/Gateway URLs, auth
+// endpoints, or routing rules. It configures the client ONCE (usually just a
+// coreUrl) and expresses intent (`fs.usage.summary()`); the SDK owns where the
+// request goes and how it's authenticated.
+function trimTrailingSlash(u) {
+    return u.replace(/\/+$/, "");
+}
+export function buildContext(config) {
+    if (!config.coreUrl) {
+        throw new Error("createFartherShoreClient: `coreUrl` is required");
+    }
+    const portalHost = config.portalHost ??
+        (typeof globalThis !== "undefined" &&
+            globalThis.location?.host
+            ? globalThis.location.host
+            : null);
+    const fetchImpl = config.fetch ??
+        (typeof fetch !== "undefined" ? fetch.bind(globalThis) : undefined);
+    if (!fetchImpl) {
+        throw new Error("createFartherShoreClient: no global fetch; pass `fetch` in the config");
+    }
+    return {
+        coreUrl: trimTrailingSlash(config.coreUrl),
+        portalHost: portalHost ? portalHost.toLowerCase() : null,
+        productId: config.productId ?? null,
+        environmentId: config.environmentId ?? null,
+        organizationId: config.organizationId ?? null,
+        gatewayUrl: config.gatewayUrl ? trimTrailingSlash(config.gatewayUrl) : null,
+        apiKey: config.apiKey ?? null,
+        sessionToken: null,
+        getToken: config.getToken,
+        fetch: fetchImpl,
+    };
+}
+/** Resolve the bearer token for a Core request: the SDK-managed session token
+ *  (persona sign-in) wins, else the configured provider. */
+export async function resolveToken(ctx) {
+    if (ctx.sessionToken)
+        return ctx.sessionToken;
+    if (ctx.getToken) {
+        const t = await ctx.getToken();
+        return t ?? null;
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AA0D3C,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,UAAU,GACd,MAAM,CAAC,UAAU;QACjB,CAAC,OAAO,UAAU,KAAK,WAAW;YACjC,UAA+C,CAAC,QAAQ,EAAE,IAAI;YAC7D,CAAC,CAAE,UAA6C,CAAC,QAAQ,CAAC,IAAI;YAC9D,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,SAAS,GACb,MAAM,CAAC,KAAK;QACZ,CAAC,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QACxD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC3C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;QAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;4DAC4D;AAC5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAkB;IACnD,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC;IAC9C,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+export declare class FartherShoreError extends Error {
+    constructor(message: string);
+}
+/** A non-2xx response from Core or the Gateway. Carries the platform error
+ *  envelope `{ error: { code, message } }` when present. */
+export declare class FartherShoreApiError extends FartherShoreError {
+    readonly status: number;
+    readonly code: string;
+    readonly body: unknown;
+    constructor(status: number, code: string, message: string, body: unknown);
+}
+/** A network-level failure (DNS, connection, CORS, abort). */
+export declare class FartherShoreNetworkError extends FartherShoreError {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/** Thrown when calling a surface that has no platform endpoint yet (an honest
+ *  stub — the SDK never silently no-ops a missing capability). */
+export declare class FartherShoreNotImplementedError extends FartherShoreError {
+    constructor(message: string);
+}
+/** Thrown when the client is used before `bootstrap()` has resolved the product
+ *  it needs (e.g. a per-product call with no configured productId). */
+export declare class FartherShoreNotReadyError extends FartherShoreError {
+    constructor(message: string);
+}
+//# 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":"AAEA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;4DAC4D;AAC5D,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBACX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAOzE;AAED,8DAA8D;AAC9D,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;kEACkE;AAClE,qBAAa,+BAAgC,SAAQ,iBAAiB;gBACxD,OAAO,EAAE,MAAM;CAI5B;AAED;uEACuE;AACvE,qBAAa,yBAA0B,SAAQ,iBAAiB;gBAClD,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,47 @@
+// SDK error model. Every failure a frontend can catch is one of these.
+export class FartherShoreError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FartherShoreError";
+    }
+}
+/** A non-2xx response from Core or the Gateway. Carries the platform error
+ *  envelope `{ error: { code, message } }` when present. */
+export class FartherShoreApiError extends FartherShoreError {
+    status;
+    code;
+    body;
+    constructor(status, code, message, body) {
+        super(message);
+        this.name = "FartherShoreApiError";
+        this.status = status;
+        this.code = code;
+        this.body = body;
+    }
+}
+/** A network-level failure (DNS, connection, CORS, abort). */
+export class FartherShoreNetworkError extends FartherShoreError {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "FartherShoreNetworkError";
+        this.cause = cause;
+    }
+}
+/** Thrown when calling a surface that has no platform endpoint yet (an honest
+ *  stub — the SDK never silently no-ops a missing capability). */
+export class FartherShoreNotImplementedError extends FartherShoreError {
+    constructor(message) {
+        super(message);
+        this.name = "FartherShoreNotImplementedError";
+    }
+}
+/** Thrown when the client is used before `bootstrap()` has resolved the product
+ *  it needs (e.g. a per-product call with no configured productId). */
+export class FartherShoreNotReadyError extends FartherShoreError {
+    constructor(message) {
+        super(message);
+        this.name = "FartherShoreNotReadyError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;4DAC4D;AAC5D,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IAChD,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAU;IACvB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe,EAAE,IAAa;QACtE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IACpD,KAAK,CAAW;IACzB,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;kEACkE;AAClE,MAAM,OAAO,+BAAgC,SAAQ,iBAAiB;IACpE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAED;uEACuE;AACvE,MAAM,OAAO,yBAA0B,SAAQ,iBAAiB;IAC9D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,22 @@
+import { type ClientContext } from "./config.js";
+export interface CoreRequest {
+    method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+    path: string;
+    query?: Record<string, string | number | undefined | null>;
+    body?: unknown;
+    /** "session" attaches the consumer session bearer; "none" is for public
+     *  endpoints (resolve/discover). Defaults to "session". */
+    auth?: "session" | "none";
+}
+/** Issue a Core request, returning the parsed JSON body (typed by the caller).
+ *  Adds the consumer session bearer + the host/env/org scoping headers Core
+ *  needs, and maps non-2xx to {@link FartherShoreApiError}. */
+export declare function coreFetch<T>(ctx: ClientContext, req: CoreRequest): Promise<T>;
+/** Issue a Gateway (builder-feature) request. Auth is the consumer API key
+ *  (`fsk_…`), NOT the session token. Returns the raw `Response` so callers can
+ *  consume any content type; throws {@link FartherShoreApiError} on non-2xx with
+ *  the body already read. */
+export declare function gatewayFetch(ctx: ClientContext, path: string, init?: RequestInit & {
+    apiKey?: string;
+}): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,aAAa,CAAC;AAG/D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;+DAC2D;IAC3D,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC3B;AAwCD;;+DAE+D;AAC/D,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,CAAC,CAAC,CAmCZ;AAED;;;6BAG6B;AAC7B,wBAAsB,YAAY,CAChC,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}

package/dist/http.js

@@ -0,0 +1,104 @@
+// Transport. The two destinations the SDK owns — Core (platform APIs) and the
+// Gateway (builder features) — and the auth each one needs. Frontend code never
+// constructs a URL or sets an auth header; it goes through here.
+import { resolveToken } from "./config.js";
+import { FartherShoreApiError, FartherShoreNetworkError } from "./errors.js";
+function buildUrl(base, path, query) {
+    const url = new URL(base + path);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== null)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    return url.toString();
+}
+async function parseBody(res) {
+    const ct = res.headers.get("content-type") ?? "";
+    if (ct.includes("application/json")) {
+        return res.json().catch(() => null);
+    }
+    return res.text().catch(() => null);
+}
+function extractError(status, body) {
+    if (body && typeof body === "object" && "error" in body) {
+        const e = body.error;
+        if (e) {
+            return {
+                code: e.code ?? "unknown",
+                message: e.message ?? `Request failed (${status})`,
+            };
+        }
+    }
+    return { code: "unknown", message: `Request failed (${status})` };
+}
+/** Issue a Core request, returning the parsed JSON body (typed by the caller).
+ *  Adds the consumer session bearer + the host/env/org scoping headers Core
+ *  needs, and maps non-2xx to {@link FartherShoreApiError}. */
+export async function coreFetch(ctx, req) {
+    const headers = { accept: "application/json" };
+    if (req.body !== undefined)
+        headers["content-type"] = "application/json";
+    if (ctx.portalHost)
+        headers["x-portal-host"] = ctx.portalHost;
+    if (ctx.environmentId)
+        headers["x-environment-id"] = ctx.environmentId;
+    if (ctx.organizationId)
+        headers["x-fs-organization-id"] = ctx.organizationId;
+    if (req.auth !== "none") {
+        const token = await resolveToken(ctx);
+        if (token)
+            headers["authorization"] = `Bearer ${token}`;
+    }
+    const url = buildUrl(ctx.coreUrl, req.path, req.query);
+    let res;
+    try {
+        res = await ctx.fetch(url, {
+            method: req.method,
+            headers,
+            body: req.body !== undefined ? JSON.stringify(req.body) : undefined,
+        });
+    }
+    catch (err) {
+        throw new FartherShoreNetworkError(`Core request failed: ${err instanceof Error ? err.message : String(err)}`, err);
+    }
+    if (res.status === 204)
+        return undefined;
+    const body = await parseBody(res);
+    if (!res.ok) {
+        const { code, message } = extractError(res.status, body);
+        throw new FartherShoreApiError(res.status, code, message, body);
+    }
+    return body;
+}
+/** Issue a Gateway (builder-feature) request. Auth is the consumer API key
+ *  (`fsk_…`), NOT the session token. Returns the raw `Response` so callers can
+ *  consume any content type; throws {@link FartherShoreApiError} on non-2xx with
+ *  the body already read. */
+export async function gatewayFetch(ctx, path, init = {}) {
+    if (!ctx.gatewayUrl) {
+        throw new FartherShoreNetworkError("Gateway origin unknown — call fs.bootstrap() first (or set gatewayUrl).");
+    }
+    const apiKey = init.apiKey ?? ctx.apiKey;
+    const headers = new Headers(init.headers);
+    if (apiKey && !headers.has("authorization")) {
+        headers.set("authorization", `Bearer ${apiKey}`);
+    }
+    const url = ctx.gatewayUrl + (path.startsWith("/") ? path : `/${path}`);
+    const { apiKey: _omit, ...rest } = init;
+    void _omit;
+    let res;
+    try {
+        res = await ctx.fetch(url, { ...rest, headers });
+    }
+    catch (err) {
+        throw new FartherShoreNetworkError(`Gateway request failed: ${err instanceof Error ? err.message : String(err)}`, err);
+    }
+    if (!res.ok) {
+        const body = await parseBody(res.clone());
+        const { code, message } = extractError(res.status, body);
+        throw new FartherShoreApiError(res.status, code, message, body);
+    }
+    return res;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { createFartherShoreClient } from "./client.js";
+export type { FartherShoreClient } from "./client.js";
+export type { FartherShoreConfig, TokenProvider, FetchLike } from "./config.js";
+export { FartherShoreError, FartherShoreApiError, FartherShoreNetworkError, FartherShoreNotImplementedError, FartherShoreNotReadyError, } from "./errors.js";
+export type { Branding, Product, Meter, AuthStrategy, EnvironmentInfo, Bootstrap, Plan, PlanMeter, PlanLimit, Grant, Subscriber, Session, ApiKey, CreatedApiKey, UsageSummary, UsageEvent, Subscription, SignInResult, } from "./types.js";
+export type { ProductResource } from "./resources/product.js";
+export type { AuthResource } from "./resources/auth.js";
+export type { KeysResource } from "./resources/keys.js";
+export type { UsageResource, UsageRange } from "./resources/usage.js";
+export type { BillingResource, CreditBalance } from "./resources/billing.js";
+export type { PlansResource, SubscribeInput, SubscribeResult, } from "./resources/plans.js";
+export type { AnalyticsResource } from "./resources/analytics.js";
+export type { FeatureHandle, GatewayRequestInit } from "./resources/feature.js";
+export { classifyPlan, isFreePlan, isPayAsYouGoPlan, formatPlanPrice, formatCents, formatPriceFromMicros, summarizeMeterPricing, formatMinimumSpend, synthesizePlanFeatures, effectiveGrants, buildGrantRows, quotaForDimension, computeProgressBar, buildMeterUsageRows, } from "./catalog.js";
+export type { PlanKind, GrantRow, MeterUsageRow } from "./catalog.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,QAAQ,EACR,OAAO,EACP,KAAK,EACL,YAAY,EACZ,eAAe,EACf,SAAS,EACT,IAAI,EACJ,SAAS,EACT,SAAS,EACT,KAAK,EACL,UAAU,EACV,OAAO,EACP,MAAM,EACN,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAKhF,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+// @farthershore/farthershore-js — the Farther Shore Frontend SDK.
+//
+// The canonical browser integration layer between a static frontend artifact and
+// the Farther Shore platform. Frontend code expresses intent; the SDK owns where
+// requests go (Core vs Gateway), how they're authenticated, and host/env scoping.
+//
+//   import { createFartherShoreClient } from "@farthershore/farthershore-js";
+//   const fs = createFartherShoreClient({ coreUrl: "https://core.farthershore.com" });
+//   const { product } = await fs.bootstrap();
+//   const keys = await fs.keys.list();
+//   const forecast = await fs.feature("weather").json("/forecast?city=NYC");
+export { createFartherShoreClient } from "./client.js";
+export { FartherShoreError, FartherShoreApiError, FartherShoreNetworkError, FartherShoreNotImplementedError, FartherShoreNotReadyError, } from "./errors.js";
+// Pure catalog/pricing display helpers (plan classification, price/grant/quota
+// formatting) — port of the SSR portal's renderers so any frontend renders the
+// catalog identically without re-deriving the math.
+export { classifyPlan, isFreePlan, isPayAsYouGoPlan, formatPlanPrice, formatCents, formatPriceFromMicros, summarizeMeterPricing, formatMinimumSpend, synthesizePlanFeatures, effectiveGrants, buildGrantRows, quotaForDimension, computeProgressBar, buildMeterUsageRows, } from "./catalog.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,kFAAkF;AAClF,EAAE;AACF,8EAA8E;AAC9E,uFAAuF;AACvF,8CAA8C;AAC9C,uCAAuC;AACvC,6EAA6E;AAE7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAKvD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAoCrB,+EAA+E;AAC/E,+EAA+E;AAC/E,oDAAoD;AACpD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/react/hooks.d.ts

@@ -0,0 +1,47 @@
+import type { ApiKey, Bootstrap, CreatedApiKey, CreditBalance, FeatureHandle, Plan, Product, Session, SubscribeInput, SubscribeResult, Subscription, UsageEvent, UsageSummary } from "../index.js";
+import { type AsyncResult } from "./use-async.js";
+export declare function useBootstrap(): AsyncResult<Bootstrap>;
+export declare function useProduct(): AsyncResult<Product>;
+export interface SessionResult extends AsyncResult<Session> {
+    signIn(input: {
+        apiKey: string;
+    }): Promise<void>;
+    signOut(): Promise<void>;
+}
+export declare function useSession(): SessionResult;
+export interface ApiKeysResult extends AsyncResult<ApiKey[]> {
+    create(input?: {
+        label?: string;
+        scopes?: string[];
+    }): Promise<CreatedApiKey>;
+    revoke(keyId: string): Promise<void>;
+    rotate(keyId: string): Promise<CreatedApiKey>;
+}
+export declare function useApiKeys(): ApiKeysResult;
+export interface UsageData {
+    summary: UsageSummary;
+    events: UsageEvent[];
+}
+export declare function useUsage(range?: {
+    from?: string;
+    to?: string;
+}): AsyncResult<UsageData>;
+export interface BillingResult extends AsyncResult<Subscription | null> {
+    openBillingPortal(input?: {
+        returnUrl?: string;
+    }): Promise<{
+        url: string;
+    }>;
+}
+export declare function useBilling(): BillingResult;
+/** The product's plan catalog + the subscribe/checkout mutation. The data is
+ *  the same plan list `bootstrap()` resolves; `subscribe()` starts checkout. */
+export interface PlansResult extends AsyncResult<Plan[]> {
+    subscribe(input: SubscribeInput): Promise<SubscribeResult>;
+}
+export declare function usePlans(): PlansResult;
+/** Live prepaid/credit balance for the current subscription, or null. */
+export declare function useCreditBalance(): AsyncResult<CreditBalance | null>;
+/** A stable handle to a builder feature (routed through the Gateway). */
+export declare function useFeature(name: string): FeatureHandle;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,IAAI,EACJ,OAAO,EACP,OAAO,EACP,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE5D,wBAAgB,YAAY,IAAI,WAAW,CAAC,SAAS,CAAC,CAGrD;AAED,wBAAgB,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC,CAGjD;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW,CAAC,OAAO,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,wBAAgB,UAAU,IAAI,aAAa,CAc1C;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW,CAAC,MAAM,EAAE,CAAC;IAC1D,MAAM,CAAC,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/C;AACD,wBAAgB,UAAU,IAAI,aAAa,CAoB1C;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AACD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,WAAW,CAAC,SAAS,CAAC,CASzB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC;IACrE,iBAAiB,CAAC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AACD,wBAAgB,UAAU,IAAI,aAAa,CAO1C;AAED;gFACgF;AAChF,MAAM,WAAW,WAAY,SAAQ,WAAW,CAAC,IAAI,EAAE,CAAC;IACtD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D;AACD,wBAAgB,QAAQ,IAAI,WAAW,CAOtC;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,CAGpE;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAGtD"}