@farthershore/farthershore-js 0.0.0

package/dist/react/hooks.js

@@ -0,0 +1,87 @@
+// Thin hooks over the client — each is a data-fetch (useAsync) plus, where it
+// makes sense, the matching mutations (so a component never reaches for the raw
+// client). All routing/auth still lives in the SDK.
+import { useMemo } from "react";
+import { useFartherShore } from "./provider.js";
+import { useAsync } from "./use-async.js";
+export function useBootstrap() {
+    const fs = useFartherShore();
+    return useAsync(() => fs.bootstrap(), [fs]);
+}
+export function useProduct() {
+    const fs = useFartherShore();
+    return useAsync(() => fs.product.get(), [fs]);
+}
+export function useSession() {
+    const fs = useFartherShore();
+    const state = useAsync(() => fs.auth.getSession(), [fs]);
+    return {
+        ...state,
+        async signIn(input) {
+            await fs.auth.signIn(input);
+            state.refresh();
+        },
+        async signOut() {
+            await fs.auth.signOut();
+            state.refresh();
+        },
+    };
+}
+export function useApiKeys() {
+    const fs = useFartherShore();
+    const state = useAsync(() => fs.keys.list(), [fs]);
+    return {
+        ...state,
+        async create(input) {
+            const key = await fs.keys.create(input);
+            state.refresh();
+            return key;
+        },
+        async revoke(keyId) {
+            await fs.keys.revoke(keyId);
+            state.refresh();
+        },
+        async rotate(keyId) {
+            const key = await fs.keys.rotate(keyId);
+            state.refresh();
+            return key;
+        },
+    };
+}
+export function useUsage(range) {
+    const fs = useFartherShore();
+    return useAsync(async () => {
+        const [summary, events] = await Promise.all([
+            fs.usage.summary(range),
+            fs.usage.events(range),
+        ]);
+        return { summary, events };
+    }, [fs, range?.from, range?.to]);
+}
+export function useBilling() {
+    const fs = useFartherShore();
+    const state = useAsync(() => fs.billing.subscription(), [fs]);
+    return {
+        ...state,
+        openBillingPortal: (input) => fs.billing.openBillingPortal(input),
+    };
+}
+export function usePlans() {
+    const fs = useFartherShore();
+    const state = useAsync(() => fs.plans.list(), [fs]);
+    return {
+        ...state,
+        subscribe: (input) => fs.plans.subscribe(input),
+    };
+}
+/** Live prepaid/credit balance for the current subscription, or null. */
+export function useCreditBalance() {
+    const fs = useFartherShore();
+    return useAsync(() => fs.billing.creditBalance(), [fs]);
+}
+/** A stable handle to a builder feature (routed through the Gateway). */
+export function useFeature(name) {
+    const fs = useFartherShore();
+    return useMemo(() => fs.feature(name), [fs, name]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/react/hooks.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,7 @@
+export { FartherShoreProvider, useFartherShore } from "./provider.js";
+export type { FartherShoreProviderProps } from "./provider.js";
+export { useAsync } from "./use-async.js";
+export type { AsyncState, AsyncResult } from "./use-async.js";
+export { useBootstrap, useProduct, useSession, useApiKeys, useUsage, useBilling, usePlans, useCreditBalance, useFeature, } from "./hooks.js";
+export type { SessionResult, ApiKeysResult, UsageData, BillingResult, PlansResult, } from "./hooks.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,10 @@
+// @farthershore/farthershore-js/react — React bindings for the Frontend SDK.
+//
+//   import { FartherShoreProvider, useApiKeys } from "@farthershore/farthershore-js/react";
+//
+// `react` is an OPTIONAL peer dependency — only consumers of this subpath pull it
+// in; the core SDK ('@farthershore/farthershore-js') stays framework-agnostic.
+export { FartherShoreProvider, useFartherShore } from "./provider.js";
+export { useAsync } from "./use-async.js";
+export { useBootstrap, useProduct, useSession, useApiKeys, useUsage, useBilling, usePlans, useCreditBalance, useFeature, } from "./hooks.js";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,4FAA4F;AAC5F,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/react/provider.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from "react";
+import { type FartherShoreClient, type FartherShoreConfig } from "../index.js";
+export interface FartherShoreProviderProps {
+    /** A pre-built client (preferred — you own its config + lifetime). */
+    client?: FartherShoreClient;
+    /** Or a config to build one internally. Pass a STABLE object (module-level /
+     *  memoized) so the client isn't recreated every render. */
+    config?: FartherShoreConfig;
+    children: ReactNode;
+}
+/** Provides one Farther Shore client to the tree. Mount once at the app root. */
+export declare function FartherShoreProvider({ client, config, children, }: FartherShoreProviderProps): import("react/jsx-runtime").JSX.Element;
+/** The client from context. Throws if used outside a provider. */
+export declare function useFartherShore(): FartherShoreClient;
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;gEAC4D;IAC5D,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,MAAM,EACN,QAAQ,GACT,EAAE,yBAAyB,2CAc3B;AAED,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,kBAAkB,CAQpD"}

package/dist/react/provider.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+import { createFartherShoreClient, } from "../index.js";
+const FartherShoreContext = createContext(null);
+/** Provides one Farther Shore client to the tree. Mount once at the app root. */
+export function FartherShoreProvider({ client, config, children, }) {
+    const value = useMemo(() => {
+        if (client)
+            return client;
+        if (!config) {
+            throw new Error("FartherShoreProvider requires a `client` or `config`.");
+        }
+        return createFartherShoreClient(config);
+    }, [client, config]);
+    return (_jsx(FartherShoreContext.Provider, { value: value, children: children }));
+}
+/** The client from context. Throws if used outside a provider. */
+export function useFartherShore() {
+    const client = useContext(FartherShoreContext);
+    if (!client) {
+        throw new Error("useFartherShore must be used within <FartherShoreProvider>.");
+    }
+    return client;
+}
+//# sourceMappingURL=provider.js.map

package/dist/react/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAC3E,OAAO,EACL,wBAAwB,GAGzB,MAAM,aAAa,CAAC;AAErB,MAAM,mBAAmB,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC;AAW3E,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,EACnC,MAAM,EACN,MAAM,EACN,QAAQ,GACkB;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAqB,GAAG,EAAE;QAC7C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAErB,OAAO,CACL,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACvC,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/react/use-async.d.ts

@@ -0,0 +1,14 @@
+export interface AsyncState<T> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+export interface AsyncResult<T> extends AsyncState<T> {
+    /** Re-run the async function. */
+    refresh: () => void;
+}
+/** A small data-fetching primitive the hooks share: tracks {data, loading,
+ *  error}, re-runs when `deps` change or `refresh()` is called, and ignores a
+ *  resolution after unmount/dep-change (no setState-after-unmount). */
+export declare function useAsync<T>(fn: () => Promise<T>, deps: readonly unknown[]): AsyncResult<T>;
+//# sourceMappingURL=use-async.d.ts.map

package/dist/react/use-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async.d.ts","sourceRoot":"","sources":["../../src/react/use-async.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACnD,iCAAiC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;uEAEuE;AACvE,wBAAgB,QAAQ,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,SAAS,OAAO,EAAE,GACvB,WAAW,CAAC,CAAC,CAAC,CAkChB"}

package/dist/react/use-async.js

@@ -0,0 +1,39 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+/** A small data-fetching primitive the hooks share: tracks {data, loading,
+ *  error}, re-runs when `deps` change or `refresh()` is called, and ignores a
+ *  resolution after unmount/dep-change (no setState-after-unmount). */
+export function useAsync(fn, deps) {
+    const [state, setState] = useState({
+        data: null,
+        loading: true,
+        error: null,
+    });
+    const [nonce, setNonce] = useState(0);
+    const fnRef = useRef(fn);
+    fnRef.current = fn;
+    useEffect(() => {
+        let active = true;
+        setState((s) => ({ data: s.data, loading: true, error: null }));
+        fnRef
+            .current()
+            .then((data) => {
+            if (active)
+                setState({ data, loading: false, error: null });
+        })
+            .catch((e) => {
+            if (active) {
+                setState({
+                    data: null,
+                    loading: false,
+                    error: e instanceof Error ? e : new Error(String(e)),
+                });
+            }
+        });
+        return () => {
+            active = false;
+        };
+    }, [...deps, nonce]);
+    const refresh = useCallback(() => setNonce((n) => n + 1), []);
+    return { ...state, refresh };
+}
+//# sourceMappingURL=use-async.js.map

package/dist/react/use-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async.js","sourceRoot":"","sources":["../../src/react/use-async.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAajE;;uEAEuE;AACvE,MAAM,UAAU,QAAQ,CACtB,EAAoB,EACpB,IAAwB;IAExB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB;QAChD,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACzB,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChE,KAAK;aACF,OAAO,EAAE;aACT,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,MAAM;gBAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YACpB,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,IAAI;oBACV,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAErB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/resources/_shared.d.ts

@@ -0,0 +1,6 @@
+import { type ClientContext } from "../config.js";
+/** The product id, or a clear error telling the caller to bootstrap first. */
+export declare function requireProductId(ctx: ClientContext): string;
+/** Build a `/portal/products/:id/me…` path. */
+export declare function mePath(productId: string, suffix?: string): string;
+//# sourceMappingURL=_shared.d.ts.map

package/dist/resources/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/resources/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAO3D;AAED,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAE7D"}

package/dist/resources/_shared.js

@@ -0,0 +1,13 @@
+import { FartherShoreNotReadyError } from "../errors.js";
+/** The product id, or a clear error telling the caller to bootstrap first. */
+export function requireProductId(ctx) {
+    if (!ctx.productId) {
+        throw new FartherShoreNotReadyError("product unknown — call fs.bootstrap() first, or pass productId to createFartherShoreClient().");
+    }
+    return ctx.productId;
+}
+/** Build a `/portal/products/:id/me…` path. */
+export function mePath(productId, suffix = "") {
+    return `/portal/products/${encodeURIComponent(productId)}/me${suffix}`;
+}
+//# sourceMappingURL=_shared.js.map

package/dist/resources/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../src/resources/_shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,GAAkB;IACjD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,yBAAyB,CACjC,+FAA+F,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,SAAS,CAAC;AACvB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,SAAiB,EAAE,MAAM,GAAG,EAAE;IACnD,OAAO,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,MAAM,MAAM,EAAE,CAAC;AACzE,CAAC"}

package/dist/resources/analytics.d.ts

@@ -0,0 +1,8 @@
+export interface AnalyticsResource {
+    /** Request analytics — no consumer-facing platform endpoint yet. The closest
+     *  data today is `usage.events()` (recent events) + audit logs. Throws to stay
+     *  honest rather than silently returning empty. */
+    requests(): never;
+}
+export declare function createAnalyticsResource(): AnalyticsResource;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/resources/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/resources/analytics.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC;;uDAEmD;IACnD,QAAQ,IAAI,KAAK,CAAC;CACnB;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAQ3D"}

package/dist/resources/analytics.js

@@ -0,0 +1,9 @@
+import { FartherShoreNotImplementedError } from "../errors.js";
+export function createAnalyticsResource() {
+    return {
+        requests() {
+            throw new FartherShoreNotImplementedError("analytics.requests() has no consumer endpoint yet — closest data is usage.events(). (Deferred.)");
+        },
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/resources/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/resources/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAS/D,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ;YACN,MAAM,IAAI,+BAA+B,CACvC,iGAAiG,CAClG,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/auth.d.ts

@@ -0,0 +1,18 @@
+import { type ClientContext } from "../config.js";
+import type { Session, SignInResult } from "../types.js";
+export interface AuthResource {
+    /** The current session (authenticated + a light subscriber slice). Resolves to
+     *  `{ authenticated: false }` on a 401/403 rather than throwing. */
+    getSession(): Promise<Session>;
+    /** Test/preview-env sign-in: exchange an `fsk_test_…` access key for a session
+     *  (persona strategy). Clerk-strategy envs sign in via the Clerk browser SDK —
+     *  pass `getToken` to the client config and call `setToken` instead. */
+    signIn(input: {
+        apiKey: string;
+    }): Promise<SignInResult>;
+    signOut(): Promise<void>;
+    /** Set the session bearer directly (e.g. from Clerk's `session.getToken()`). */
+    setToken(token: string | null): void;
+}
+export declare function createAuthResource(ctx: ClientContext): AuthResource;
+//# sourceMappingURL=auth.d.ts.map

package/dist/resources/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/resources/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAgBrE,MAAM,WAAW,YAAY;IAC3B;wEACoE;IACpE,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B;;4EAEwE;IACxE,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CA2DnE"}

package/dist/resources/auth.js

@@ -0,0 +1,61 @@
+import { coreFetch } from "../http.js";
+import { FartherShoreApiError } from "../errors.js";
+import { mePath, requireProductId } from "./_shared.js";
+export function createAuthResource(ctx) {
+    return {
+        async getSession() {
+            const productId = requireProductId(ctx);
+            try {
+                const raw = await coreFetch(ctx, {
+                    method: "GET",
+                    path: mePath(productId),
+                });
+                const s = raw.subscriber;
+                const subscriber = s
+                    ? {
+                        status: s.status ?? null,
+                        planKey: s.planKey ?? null,
+                        compiledPlanId: s.compiledPlanId ?? null,
+                    }
+                    : null;
+                return { authenticated: true, subscriber };
+            }
+            catch (err) {
+                if (err instanceof FartherShoreApiError &&
+                    (err.status === 401 || err.status === 403)) {
+                    return { authenticated: false, subscriber: null };
+                }
+                throw err;
+            }
+        },
+        async signIn(input) {
+            const raw = await coreFetch(ctx, {
+                method: "POST",
+                path: "/portal/auth/persona-session",
+                body: { apiKey: input.apiKey },
+                auth: "none",
+            });
+            ctx.sessionToken = raw.sessionToken;
+            return {
+                token: raw.sessionToken,
+                expiresAt: raw.expiresAt,
+                user: raw.user,
+            };
+        },
+        async signOut() {
+            try {
+                await coreFetch(ctx, {
+                    method: "POST",
+                    path: "/portal/auth/persona-logout",
+                });
+            }
+            finally {
+                ctx.sessionToken = null;
+            }
+        },
+        setToken(token) {
+            ctx.sessionToken = token;
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/resources/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/resources/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AA4BxD,MAAM,UAAU,kBAAkB,CAAC,GAAkB;IACnD,OAAO;QACL,KAAK,CAAC,UAAU;YACd,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAuB,GAAG,EAAE;oBACrD,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;iBACxB,CAAC,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;gBACzB,MAAM,UAAU,GAAsB,CAAC;oBACrC,CAAC,CAAC;wBACE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;wBACxB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;wBAC1B,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;qBACzC;oBACH,CAAC,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IACE,GAAG,YAAY,oBAAoB;oBACnC,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,EAC1C,CAAC;oBACD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBACpD,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAoB,GAAG,EAAE;gBAClD,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,8BAA8B;gBACpC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;gBAC9B,IAAI,EAAE,MAAM;aACb,CAAC,CAAC;YACH,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;YACpC,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,YAAY;gBACvB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,MAAM,SAAS,CAAO,GAAG,EAAE;oBACzB,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,6BAA6B;iBACpC,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,KAAK;YACZ,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/billing.d.ts

@@ -0,0 +1,33 @@
+import { type ClientContext } from "../config.js";
+import type { Subscription } from "../types.js";
+/** Live Stripe-backed credit balance for the current subscription. `null` when
+ *  the subscription has no credit grants / no Stripe binding, or the upstream
+ *  fetch is unavailable. */
+export interface CreditBalance {
+    /** Spendable balance remaining, in cents. */
+    availableCents: number;
+    /** Total ledger balance, in cents. */
+    ledgerCents: number;
+    /** Currency code (USD-only today). */
+    currency: string;
+}
+export interface BillingResource {
+    /** The consumer's current subscription for this product, or null. */
+    subscription(): Promise<Subscription | null>;
+    /** Open the Stripe-hosted billing portal (payment method + invoices). Returns
+     *  the URL to navigate to. This is also how invoices are viewed in V0. */
+    openBillingPortal(input?: {
+        returnUrl?: string;
+    }): Promise<{
+        url: string;
+    }>;
+    /** Live prepaid/credit balance for the current subscription, or null when
+     *  there is no credit surface. Degrades to null rather than throwing on a
+     *  404 (no subscription/grant). */
+    creditBalance(): Promise<CreditBalance | null>;
+    /** Structured invoice list — no platform endpoint; use openBillingPortal().
+     *  Throws to stay honest. */
+    invoices(): never;
+}
+export declare function createBillingResource(ctx: ClientContext): BillingResource;
+//# sourceMappingURL=billing.d.ts.map

package/dist/resources/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/resources/billing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+BhD;;4BAE4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,YAAY,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC7C;8EAC0E;IAC1E,iBAAiB,CAAC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E;;uCAEmC;IACnC,aAAa,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC/C;iCAC6B;IAC7B,QAAQ,IAAI,KAAK,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CA6DzE"}

package/dist/resources/billing.js

@@ -0,0 +1,61 @@
+import { coreFetch } from "../http.js";
+import { FartherShoreApiError, FartherShoreNotImplementedError, } from "../errors.js";
+import { mePath, requireProductId } from "./_shared.js";
+export function createBillingResource(ctx) {
+    return {
+        async subscription() {
+            const productId = requireProductId(ctx);
+            const raw = await coreFetch(ctx, {
+                method: "GET",
+                path: mePath(productId, "/subscription"),
+            });
+            if (!raw)
+                return null;
+            return {
+                id: raw.subscriptionId ?? raw.id ?? "",
+                status: raw.status ?? raw.subscriptionLifecycle ?? raw.lifecycle ?? "",
+                planKey: raw.planKey ?? raw.plan?.planKey ?? null,
+                planName: raw.planName ?? raw.plan?.displayName ?? raw.plan?.planName ?? null,
+                raw,
+            };
+        },
+        async openBillingPortal(input = {}) {
+            const productId = requireProductId(ctx);
+            const raw = await coreFetch(ctx, {
+                method: "POST",
+                path: mePath(productId, "/billing-portal-session"),
+                body: { returnUrl: input.returnUrl },
+            });
+            return { url: raw.url };
+        },
+        async creditBalance() {
+            const productId = requireProductId(ctx);
+            try {
+                const raw = await coreFetch(ctx, {
+                    method: "GET",
+                    path: mePath(productId, "/credit-balance"),
+                });
+                if (!raw.balance)
+                    return null;
+                return {
+                    availableCents: raw.balance.availableCents,
+                    ledgerCents: raw.balance.ledgerCents,
+                    currency: raw.balance.currency,
+                };
+            }
+            catch (err) {
+                // No subscription / no credit grant on file → degrade to null so the
+                // portal still renders the rest of the billing surface.
+                if (err instanceof FartherShoreApiError &&
+                    (err.status === 404 || err.status === 401 || err.status === 403)) {
+                    return null;
+                }
+                throw err;
+            }
+        },
+        invoices() {
+            throw new FartherShoreNotImplementedError("billing.invoices() has no JSON endpoint — use billing.openBillingPortal() for Stripe-hosted invoices. (Deferred.)");
+        },
+    };
+}
+//# sourceMappingURL=billing.js.map

package/dist/resources/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/resources/billing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAyDxD,MAAM,UAAU,qBAAqB,CAAC,GAAkB;IACtD,OAAO;QACL,KAAK,CAAC,YAAY;YAChB,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAyB,GAAG,EAAE;gBACvD,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC;aACzC,CAAC,CAAC;YACH,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO;gBACL,EAAE,EAAE,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE;gBACtC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,qBAAqB,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE;gBACtE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI;gBACjD,QAAQ,EACN,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI;gBACrE,GAAG;aACJ,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,iBAAiB,CAAC,KAAK,GAAG,EAAE;YAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAmB,GAAG,EAAE;gBACjD,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,yBAAyB,CAAC;gBAClD,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;aACrC,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,aAAa;YACjB,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAmB,GAAG,EAAE;oBACjD,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;iBAC3C,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,OAAO;oBAAE,OAAO,IAAI,CAAC;gBAC9B,OAAO;oBACL,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc;oBAC1C,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW;oBACpC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ;iBAC/B,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,qEAAqE;gBACrE,wDAAwD;gBACxD,IACE,GAAG,YAAY,oBAAoB;oBACnC,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,EAChE,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,QAAQ;YACN,MAAM,IAAI,+BAA+B,CACvC,mHAAmH,CACpH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/feature.d.ts

@@ -0,0 +1,17 @@
+import { type ClientContext } from "../config.js";
+export interface GatewayRequestInit extends RequestInit {
+    /** Override the consumer API key for this call (else the client's apiKey). */
+    apiKey?: string;
+}
+/** A handle to one builder-defined feature. The Gateway routes by HTTP
+ *  method+path (it proxies the product's own routes); the feature name is a
+ *  label/metadata. Frontend code never sees the gateway URL. */
+export interface FeatureHandle {
+    readonly name: string;
+    /** Call a route on the product's Gateway. Returns the raw Response. */
+    fetch(path: string, init?: GatewayRequestInit): Promise<Response>;
+    /** Convenience: fetch + parse JSON. */
+    json<T = unknown>(path: string, init?: GatewayRequestInit): Promise<T>;
+}
+export declare function createFeature(ctx: ClientContext, name: string): FeatureHandle;
+//# sourceMappingURL=feature.d.ts.map

package/dist/resources/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/resources/feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;gEAEgE;AAChE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,uCAAuC;IACvC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAW7E"}

package/dist/resources/feature.js

@@ -0,0 +1,14 @@
+import { gatewayFetch } from "../http.js";
+export function createFeature(ctx, name) {
+    return {
+        name,
+        fetch(path, init) {
+            return gatewayFetch(ctx, path, init);
+        },
+        async json(path, init) {
+            const res = await gatewayFetch(ctx, path, init);
+            return (await res.json());
+        },
+    };
+}
+//# sourceMappingURL=feature.js.map

package/dist/resources/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../src/resources/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmB1C,MAAM,UAAU,aAAa,CAAC,GAAkB,EAAE,IAAY;IAC5D,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,IAAI,EAAE,IAAI;YACd,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAyB;YACnD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/keys.d.ts

@@ -0,0 +1,15 @@
+import { type ClientContext } from "../config.js";
+import type { ApiKey, CreatedApiKey } from "../types.js";
+export interface KeysResource {
+    list(): Promise<ApiKey[]>;
+    /** Create a key. The returned `secret` is shown ONCE. */
+    create(input?: {
+        label?: string;
+        scopes?: string[];
+    }): Promise<CreatedApiKey>;
+    revoke(keyId: string): Promise<void>;
+    /** Rotate a key — revokes the old and returns a new `secret` (shown once). */
+    rotate(keyId: string): Promise<CreatedApiKey>;
+}
+export declare function createKeysResource(ctx: ClientContext): KeysResource;
+//# sourceMappingURL=keys.d.ts.map

package/dist/resources/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/resources/keys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAmCzD,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1B,yDAAyD;IACzD,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,8EAA8E;IAC9E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAyCnE"}

package/dist/resources/keys.js

@@ -0,0 +1,55 @@
+import { coreFetch } from "../http.js";
+import { mePath, requireProductId } from "./_shared.js";
+function mapKey(k) {
+    return {
+        id: k.id,
+        keyPrefix: k.keyPrefix,
+        label: k.label ?? null,
+        // Normalize the platform enum casing (ACTIVE/REVOKED) to a stable lowercase
+        // SDK contract so consumers can compare against "active"/"revoked".
+        status: (k.status ?? "").toLowerCase(),
+        createdAt: k.createdAt,
+        lastUsedAt: k.lastUsedAt ?? null,
+        revokedAt: k.revokedAt ?? null,
+    };
+}
+function withSecret(k) {
+    return { ...mapKey(k), secret: k.plaintext ?? k.rawKey ?? "" };
+}
+export function createKeysResource(ctx) {
+    return {
+        async list() {
+            const productId = requireProductId(ctx);
+            const raw = await coreFetch(ctx, {
+                method: "GET",
+                path: mePath(productId, "/api-keys"),
+            });
+            return raw.map(mapKey);
+        },
+        async create(input = {}) {
+            const productId = requireProductId(ctx);
+            const raw = await coreFetch(ctx, {
+                method: "POST",
+                path: mePath(productId, "/api-keys"),
+                body: { label: input.label, scopes: input.scopes },
+            });
+            return withSecret(raw);
+        },
+        async revoke(keyId) {
+            const productId = requireProductId(ctx);
+            await coreFetch(ctx, {
+                method: "DELETE",
+                path: mePath(productId, `/api-keys/${encodeURIComponent(keyId)}`),
+            });
+        },
+        async rotate(keyId) {
+            const productId = requireProductId(ctx);
+            const raw = await coreFetch(ctx, {
+                method: "POST",
+                path: mePath(productId, `/api-keys/${encodeURIComponent(keyId)}/rotate`),
+            });
+            return withSecret(raw);
+        },
+    };
+}
+//# sourceMappingURL=keys.js.map

package/dist/resources/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/resources/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAgBxD,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;QACtB,4EAA4E;QAC5E,oEAAoE;QACpE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;QACtC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;QAChC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAgB;IAClC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACjE,CAAC;AAWD,MAAM,UAAU,kBAAkB,CAAC,GAAkB;IACnD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAW,GAAG,EAAE;gBACzC,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;aACrC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE;YACrB,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAgB,GAAG,EAAE;gBAC9C,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;gBACpC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;aACnD,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,SAAS,CAAO,GAAG,EAAE;gBACzB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAgB,GAAG,EAAE;gBAC9C,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,MAAM,CACV,SAAS,EACT,aAAa,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAChD;aACF,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}