@raster-app/react 0.0.0-stage → 0.1.0-canary-2e1834e

package/dist/use-organizations.d.ts

@@ -0,0 +1,36 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import { type Organization, type RasterApiError, type RasterClient } from '@raster-app/sdk';
+/** `/me`, which both the organization list and each library's access are read from. */
+export declare function meQuery(client: RasterClient, identity: string | null): {
+    queryKey: readonly ["raster", string | null, "me"];
+    queryFn: () => Promise<{
+        organizationId: string;
+        organizationName: string | null;
+        plan: string | null;
+        libraries: {
+            library: string;
+            access: "read" | "write";
+        }[];
+        user?: {
+            name: string | null;
+        };
+    } | {
+        organizations: {
+            organizationId: string;
+            organizationName: string | null;
+            plan: string | null;
+            libraries: {
+                library: string;
+                access: "read" | "write";
+            }[];
+        }[];
+        user: {
+            name: string | null;
+        };
+    }>;
+};
+/**
+ * Every organization the current credential reaches, resolved from `/me`. An account in none
+ * gets an empty list.
+ */
+export declare function useOrganizations(): UseQueryResult<Array<Organization>, RasterApiError>;

package/dist/use-organizations.js

@@ -0,0 +1,23 @@
+import { useQuery } from '@tanstack/react-query';
+import { meOrganizationList, } from '@raster-app/sdk';
+import { useRasterClient } from './context.js';
+import { rasterKeys } from './query-keys.js';
+import { useCredentialIdentity } from './use-session.js';
+/** `/me`, which both the organization list and each library's access are read from. */
+export function meQuery(client, identity) {
+    return { queryKey: rasterKeys.me(identity), queryFn: () => client.me() };
+}
+/**
+ * Every organization the current credential reaches, resolved from `/me`. An account in none
+ * gets an empty list.
+ */
+export function useOrganizations() {
+    const client = useRasterClient();
+    const identity = useCredentialIdentity();
+    return useQuery({
+        ...meQuery(client, identity),
+        select: meOrganizationList,
+        enabled: identity !== null,
+    });
+}
+//# sourceMappingURL=use-organizations.js.map

package/dist/use-organizations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-organizations.js","sourceRoot":"","sources":["../src/use-organizations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErE,OAAO,EAKN,kBAAkB,GAClB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAExD,uFAAuF;AACvF,MAAM,UAAU,OAAO,CAAC,MAAoB,EAAE,QAAuB;IACpE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC/B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAEhC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IAExC,OAAO,QAAQ,CAA0C;QACxD,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC5B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,QAAQ,KAAK,IAAI;KAC1B,CAAC,CAAA;AACH,CAAC","sourcesContent":["import { type UseQueryResult, useQuery } from '@tanstack/react-query'\n\nimport {\n\ttype Me,\n\ttype Organization,\n\ttype RasterApiError,\n\ttype RasterClient,\n\tmeOrganizationList,\n} from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\nimport { rasterKeys } from './query-keys.js'\nimport { useCredentialIdentity } from './use-session.js'\n\n/** `/me`, which both the organization list and each library's access are read from. */\nexport function meQuery(client: RasterClient, identity: string | null) {\n\treturn { queryKey: rasterKeys.me(identity), queryFn: () => client.me() }\n}\n\n/**\n * Every organization the current credential reaches, resolved from `/me`. An account in none\n * gets an empty list.\n */\nexport function useOrganizations(): UseQueryResult<Array<Organization>, RasterApiError> {\n\tconst client = useRasterClient()\n\n\tconst identity = useCredentialIdentity()\n\n\treturn useQuery<Me, RasterApiError, Array<Organization>>({\n\t\t...meQuery(client, identity),\n\t\tselect: meOrganizationList,\n\t\tenabled: identity !== null,\n\t})\n}\n"]}

package/dist/use-promote-variant.d.ts

@@ -0,0 +1,43 @@
+import type { Asset, RasterApiError } from '@raster-app/sdk';
+type PromoteOptions = {
+    organizationId: string;
+    libraryId: string;
+    /** The asset whose default is being replaced. */
+    assetId: string;
+    /** The variant to make the new default. */
+    variantId: string;
+    /**
+     * Applied to the asset in the library's cached list straight away, and kept until the swap
+     * lands or fails — say, to show the variant as the default already.
+     */
+    optimistic?: (asset: Asset) => Asset;
+};
+export type PromoteState = {
+    status: 'idle';
+} | {
+    status: 'promoting';
+}
+/** The swap landed; `asset` is the asset as it now reads. */
+ | {
+    status: 'done';
+    asset: Asset;
+}
+/** Raster took the promote, but had not swapped the files when the wait gave up. */
+ | {
+    status: 'timed-out';
+} | {
+    status: 'error';
+    error: RasterApiError;
+};
+export type VariantPromote = {
+    state: PromoteState;
+    /**
+     * Promote a variant to be its asset's default, then wait until Raster has swapped the files
+     * (`assets.waitUntilPromoted`). Resolves with the asset as it then reads; null leaves the
+     * rest to `state`.
+     */
+    promote: (options: PromoteOptions) => Promise<Asset | null>;
+    reset: () => void;
+};
+export declare function usePromoteVariant(): VariantPromote;
+export {};

package/dist/use-promote-variant.js

@@ -0,0 +1,65 @@
+import { useMutation, useQueryClient, } from '@tanstack/react-query';
+import { useCallback } from 'react';
+import { useRasterClient } from './context.js';
+import { rasterKeys } from './query-keys.js';
+import { useCredentialIdentity } from './use-session.js';
+function replaceAsset(data, assetId, update) {
+    if (data === undefined)
+        return undefined;
+    return {
+        ...data,
+        pages: data.pages.map((page) => page.map((asset) => (asset.id === assetId ? update(asset) : asset))),
+    };
+}
+function promoteState(mutation) {
+    if (mutation.isPending)
+        return { status: 'promoting' };
+    if (mutation.isError)
+        return { status: 'error', error: mutation.error };
+    if (!mutation.isSuccess)
+        return { status: 'idle' };
+    return mutation.data === null ? { status: 'timed-out' } : { status: 'done', asset: mutation.data };
+}
+export function usePromoteVariant() {
+    const client = useRasterClient();
+    const queryClient = useQueryClient();
+    const identity = useCredentialIdentity();
+    const mutation = useMutation({
+        mutationFn: async (options) => {
+            await client.assets.promote(options);
+            return client.assets.waitUntilPromoted(options);
+        },
+        onMutate: async ({ organizationId, libraryId, assetId, optimistic }) => {
+            if (optimistic === undefined)
+                return;
+            const key = rasterKeys.assets(identity, organizationId, libraryId);
+            // A page landing after this would put the asset back as it was.
+            await queryClient.cancelQueries({ queryKey: key });
+            queryClient.setQueryData(key, (data) => replaceAsset(data, assetId, optimistic));
+        },
+        // Landed, the asset as it now reads replaces the cached one. Otherwise the list is read
+        // again, which also undoes an optimistic update that never landed.
+        onSettled: (asset, _error, { organizationId, libraryId, assetId }) => {
+            const key = rasterKeys.assets(identity, organizationId, libraryId);
+            if (asset) {
+                queryClient.setQueryData(key, (data) => replaceAsset(data, assetId, () => asset));
+            }
+            else {
+                void queryClient.invalidateQueries({ queryKey: key });
+            }
+            void queryClient.invalidateQueries({ queryKey: rasterKeys.search(identity, organizationId) });
+        },
+    });
+    const { mutateAsync, reset } = mutation;
+    const state = promoteState(mutation);
+    const promote = useCallback(async (options) => {
+        try {
+            return await mutateAsync(options);
+        }
+        catch {
+            return null;
+        }
+    }, [mutateAsync]);
+    return { state, promote, reset };
+}
+//# sourceMappingURL=use-promote-variant.js.map

package/dist/use-promote-variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-promote-variant.js","sourceRoot":"","sources":["../src/use-promote-variant.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype InfiniteData,\n\ttype UseMutationResult,\n\tuseMutation,\n\tuseQueryClient,\n} from '@tanstack/react-query'\nimport { useCallback } from 'react'\n\nimport type { Asset, RasterApiError } from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\nimport { rasterKeys } from './query-keys.js'\nimport { useCredentialIdentity } from './use-session.js'\n\ntype PromoteOptions = {\n\torganizationId: string\n\tlibraryId: string\n\t/** The asset whose default is being replaced. */\n\tassetId: string\n\t/** The variant to make the new default. */\n\tvariantId: string\n\t/**\n\t * Applied to the asset in the library's cached list straight away, and kept until the swap\n\t * lands or fails — say, to show the variant as the default already.\n\t */\n\toptimistic?: (asset: Asset) => Asset\n}\n\nexport type PromoteState =\n\t| { status: 'idle' }\n\t| { status: 'promoting' }\n\t/** The swap landed; `asset` is the asset as it now reads. */\n\t| { status: 'done'; asset: Asset }\n\t/** Raster took the promote, but had not swapped the files when the wait gave up. */\n\t| { status: 'timed-out' }\n\t| { status: 'error'; error: RasterApiError }\n\nexport type VariantPromote = {\n\tstate: PromoteState\n\t/**\n\t * Promote a variant to be its asset's default, then wait until Raster has swapped the files\n\t * (`assets.waitUntilPromoted`). Resolves with the asset as it then reads; null leaves the\n\t * rest to `state`.\n\t */\n\tpromote: (options: PromoteOptions) => Promise<Asset | null>\n\treset: () => void\n}\n\ntype AssetPages = InfiniteData<Array<Asset>>\n\nfunction replaceAsset(\n\tdata: AssetPages | undefined,\n\tassetId: string,\n\tupdate: (asset: Asset) => Asset\n): AssetPages | undefined {\n\tif (data === undefined) return undefined\n\treturn {\n\t\t...data,\n\t\tpages: data.pages.map((page) =>\n\t\t\tpage.map((asset) => (asset.id === assetId ? update(asset) : asset))\n\t\t),\n\t}\n}\n\nfunction promoteState(\n\tmutation: UseMutationResult<Asset | null, RasterApiError, PromoteOptions>\n): PromoteState {\n\tif (mutation.isPending) return { status: 'promoting' }\n\tif (mutation.isError) return { status: 'error', error: mutation.error }\n\tif (!mutation.isSuccess) return { status: 'idle' }\n\treturn mutation.data === null ? { status: 'timed-out' } : { status: 'done', asset: mutation.data }\n}\n\nexport function usePromoteVariant(): VariantPromote {\n\tconst client = useRasterClient()\n\tconst queryClient = useQueryClient()\n\n\tconst identity = useCredentialIdentity()\n\tconst mutation = useMutation<Asset | null, RasterApiError, PromoteOptions>({\n\t\tmutationFn: async (options) => {\n\t\t\tawait client.assets.promote(options)\n\t\t\treturn client.assets.waitUntilPromoted(options)\n\t\t},\n\t\tonMutate: async ({ organizationId, libraryId, assetId, optimistic }) => {\n\t\t\tif (optimistic === undefined) return\n\t\t\tconst key = rasterKeys.assets(identity, organizationId, libraryId)\n\t\t\t// A page landing after this would put the asset back as it was.\n\t\t\tawait queryClient.cancelQueries({ queryKey: key })\n\t\t\tqueryClient.setQueryData<AssetPages>(key, (data) => replaceAsset(data, assetId, optimistic))\n\t\t},\n\t\t// Landed, the asset as it now reads replaces the cached one. Otherwise the list is read\n\t\t// again, which also undoes an optimistic update that never landed.\n\t\tonSettled: (asset, _error, { organizationId, libraryId, assetId }) => {\n\t\t\tconst key = rasterKeys.assets(identity, organizationId, libraryId)\n\t\t\tif (asset) {\n\t\t\t\tqueryClient.setQueryData<AssetPages>(key, (data) =>\n\t\t\t\t\treplaceAsset(data, assetId, () => asset)\n\t\t\t\t)\n\t\t\t} else {\n\t\t\t\tvoid queryClient.invalidateQueries({ queryKey: key })\n\t\t\t}\n\t\t\tvoid queryClient.invalidateQueries({ queryKey: rasterKeys.search(identity, organizationId) })\n\t\t},\n\t})\n\n\tconst { mutateAsync, reset } = mutation\n\tconst state = promoteState(mutation)\n\n\tconst promote = useCallback<VariantPromote['promote']>(\n\t\tasync (options) => {\n\t\t\ttry {\n\t\t\t\treturn await mutateAsync(options)\n\t\t\t} catch {\n\t\t\t\treturn null\n\t\t\t}\n\t\t},\n\t\t[mutateAsync]\n\t)\n\n\treturn { state, promote, reset }\n}\n"]}

package/dist/use-session.d.ts

@@ -0,0 +1,22 @@
+import { type StoredCredentials } from '@raster-app/sdk';
+export type RasterSession = {
+    /** `undefined` until the store has been read. Distinguishes "loading" from "signed out". */
+    credentials: StoredCredentials | undefined;
+    /** Whether there is any credential to call the API with — a session or an API key. */
+    isConfigured: boolean;
+    /** Whether the credential is an OAuth session specifically (an API key is not). */
+    isSignedIn: boolean;
+    /** The account name, for "Signed in as …". Null for an API key. */
+    userName: string | null;
+    signOut: () => Promise<void>;
+};
+/**
+ * The current credential, re-rendering on every change — a sign-in, a token refresh, a
+ * sign-out. `useSyncExternalStore` also catches a change between render and effect.
+ */
+export declare function useSession(): RasterSession;
+/**
+ * The sign-in every query key is scoped by, or null while there is none to fetch with. A token
+ * refresh keeps it; a different account, or the same one signing in again, changes it.
+ */
+export declare function useCredentialIdentity(): string | null;

package/dist/use-session.js

@@ -0,0 +1,37 @@
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+import { isConfigured as isConfiguredCredentials } from '@raster-app/sdk';
+import { useRasterClient } from './context.js';
+/**
+ * The current credential, re-rendering on every change — a sign-in, a token refresh, a
+ * sign-out. `useSyncExternalStore` also catches a change between render and effect.
+ */
+export function useSession() {
+    const client = useRasterClient();
+    const credentials = useSyncExternalStore(useCallback((listener) => client.session.subscribe(listener), [client]), () => client.session.current(), () => undefined);
+    const signOut = useCallback(() => client.auth.signOut(), [client]);
+    // Hydration is single-flight in the SDK, so calling it from every mounted consumer costs
+    // one store read in total.
+    useEffect(() => {
+        void client.session.hydrate().catch(() => {
+            // A store that cannot be read leaves the client signed out, so the host shows its
+            // sign-in screen.
+        });
+    }, [client]);
+    return {
+        credentials,
+        isConfigured: isConfiguredCredentials(credentials),
+        isSignedIn: credentials?.oauth != null,
+        userName: credentials?.userName ?? null,
+        signOut,
+    };
+}
+/**
+ * The sign-in every query key is scoped by, or null while there is none to fetch with. A token
+ * refresh keeps it; a different account, or the same one signing in again, changes it.
+ */
+export function useCredentialIdentity() {
+    const client = useRasterClient();
+    const { isConfigured } = useSession();
+    return isConfigured ? client.session.credentialIdentity() : null;
+}
+//# sourceMappingURL=use-session.js.map

package/dist/use-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-session.js","sourceRoot":"","sources":["../src/use-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAEpE,OAAO,EAA0B,YAAY,IAAI,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEjG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAc9C;;;GAGG;AACH,MAAM,UAAU,UAAU;IACzB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAEhC,MAAM,WAAW,GAAG,oBAAoB,CACvC,WAAW,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EACvE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAC9B,GAAG,EAAE,CAAC,SAAS,CACf,CAAA;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAElE,yFAAyF;IACzF,2BAA2B;IAC3B,SAAS,CAAC,GAAG,EAAE;QACd,KAAK,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YACxC,kFAAkF;YAClF,kBAAkB;QACnB,CAAC,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,OAAO;QACN,WAAW;QACX,YAAY,EAAE,uBAAuB,CAAC,WAAW,CAAC;QAClD,UAAU,EAAE,WAAW,EAAE,KAAK,IAAI,IAAI;QACtC,QAAQ,EAAE,WAAW,EAAE,QAAQ,IAAI,IAAI;QACvC,OAAO;KACP,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACpC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CAAA;IAErC,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACjE,CAAC","sourcesContent":["import { useCallback, useEffect, useSyncExternalStore } from 'react'\n\nimport { type StoredCredentials, isConfigured as isConfiguredCredentials } from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\n\nexport type RasterSession = {\n\t/** `undefined` until the store has been read. Distinguishes \"loading\" from \"signed out\". */\n\tcredentials: StoredCredentials | undefined\n\t/** Whether there is any credential to call the API with — a session or an API key. */\n\tisConfigured: boolean\n\t/** Whether the credential is an OAuth session specifically (an API key is not). */\n\tisSignedIn: boolean\n\t/** The account name, for \"Signed in as …\". Null for an API key. */\n\tuserName: string | null\n\tsignOut: () => Promise<void>\n}\n\n/**\n * The current credential, re-rendering on every change — a sign-in, a token refresh, a\n * sign-out. `useSyncExternalStore` also catches a change between render and effect.\n */\nexport function useSession(): RasterSession {\n\tconst client = useRasterClient()\n\n\tconst credentials = useSyncExternalStore(\n\t\tuseCallback((listener) => client.session.subscribe(listener), [client]),\n\t\t() => client.session.current(),\n\t\t() => undefined\n\t)\n\n\tconst signOut = useCallback(() => client.auth.signOut(), [client])\n\n\t// Hydration is single-flight in the SDK, so calling it from every mounted consumer costs\n\t// one store read in total.\n\tuseEffect(() => {\n\t\tvoid client.session.hydrate().catch(() => {\n\t\t\t// A store that cannot be read leaves the client signed out, so the host shows its\n\t\t\t// sign-in screen.\n\t\t})\n\t}, [client])\n\n\treturn {\n\t\tcredentials,\n\t\tisConfigured: isConfiguredCredentials(credentials),\n\t\tisSignedIn: credentials?.oauth != null,\n\t\tuserName: credentials?.userName ?? null,\n\t\tsignOut,\n\t}\n}\n\n/**\n * The sign-in every query key is scoped by, or null while there is none to fetch with. A token\n * refresh keeps it; a different account, or the same one signing in again, changes it.\n */\nexport function useCredentialIdentity(): string | null {\n\tconst client = useRasterClient()\n\tconst { isConfigured } = useSession()\n\n\treturn isConfigured ? client.session.credentialIdentity() : null\n}\n"]}

package/dist/use-sign-in.d.ts

@@ -0,0 +1,34 @@
+import { type DeviceAuthorization, type RasterApiError } from '@raster-app/sdk';
+export type SignInState = {
+    status: 'idle';
+} | {
+    status: 'connecting';
+}
+/** The device grant is waiting for the user to approve in their browser. */
+ | {
+    status: 'awaitingApproval';
+    device: DeviceAuthorization;
+} | {
+    status: 'error';
+    error: RasterApiError;
+};
+export type SignIn = {
+    state: SignInState;
+    /** Device grant (RFC 8628). Works in every host. */
+    signInWithDevice: () => Promise<void>;
+    /** Verify and adopt a pasted organization API key. */
+    connectApiKey: (apiKey: string) => Promise<void>;
+    /** Abandon a device sign-in that is still waiting. */
+    cancel: () => void;
+    reset: () => void;
+};
+/**
+ * Drives both ways in — the device grant and an API key — and holds their state: a device
+ * grant waiting on the user, or the error that ended an attempt. Read the credential itself
+ * with `useSession`. `scope` and `organizationId` go to the device grant, as
+ * `auth.signInWithDevice` takes them.
+ */
+export declare function useSignIn(options?: {
+    scope?: 'user' | 'org';
+    organizationId?: string;
+}): SignIn;

package/dist/use-sign-in.js

@@ -0,0 +1,79 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { isAbortError, toRasterApiError, } from '@raster-app/sdk';
+import { useRasterClient } from './context.js';
+/**
+ * Drives both ways in — the device grant and an API key — and holds their state: a device
+ * grant waiting on the user, or the error that ended an attempt. Read the credential itself
+ * with `useSession`. `scope` and `organizationId` go to the device grant, as
+ * `auth.signInWithDevice` takes them.
+ */
+export function useSignIn(options = {}) {
+    const { scope, organizationId } = options;
+    const client = useRasterClient();
+    const [state, setState] = useState({ status: 'idle' });
+    const controllerRef = useRef(null);
+    const mountedRef = useRef(true);
+    /** Ignore results that arrive after unmount; `setState` on a dead component is noise. */
+    const settle = useCallback((next) => {
+        if (mountedRef.current)
+            setState(next);
+    }, []);
+    const fail = useCallback((caught) => {
+        // A cancellation is not a failure to report — the user asked for it.
+        if (isAbortError(caught)) {
+            settle({ status: 'idle' });
+            return;
+        }
+        settle({ status: 'error', error: toRasterApiError(caught) });
+    }, [settle]);
+    const signInWithDevice = useCallback(async () => {
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        settle({ status: 'connecting' });
+        try {
+            await client.auth.signInWithDevice({
+                signal: controller.signal,
+                onCode: (device) => settle({ status: 'awaitingApproval', device }),
+                scope,
+                organizationId,
+            });
+            settle({ status: 'idle' });
+        }
+        catch (caught) {
+            fail(caught);
+        }
+    }, [client, settle, fail, scope, organizationId]);
+    const connectApiKey = useCallback(async (apiKey) => {
+        settle({ status: 'connecting' });
+        try {
+            await client.auth.connect({ apiKey });
+            settle({ status: 'idle' });
+        }
+        catch (caught) {
+            fail(caught);
+        }
+    }, [client, settle, fail]);
+    const cancel = useCallback(() => {
+        controllerRef.current?.abort();
+        settle({ status: 'idle' });
+    }, [settle]);
+    const reset = useCallback(() => settle({ status: 'idle' }), [settle]);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+            // A device sign-in polls indefinitely. Leaving it running after unmount would keep
+            // hitting the token endpoint for a screen nobody is looking at.
+            controllerRef.current?.abort();
+        };
+    }, []);
+    return {
+        state,
+        signInWithDevice,
+        connectApiKey,
+        cancel,
+        reset,
+    };
+}
+//# sourceMappingURL=use-sign-in.js.map

package/dist/use-sign-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sign-in.js","sourceRoot":"","sources":["../src/use-sign-in.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\nimport {\n\ttype DeviceAuthorization,\n\ttype RasterApiError,\n\tisAbortError,\n\ttoRasterApiError,\n} from '@raster-app/sdk'\n\nimport { useRasterClient } from './context.js'\n\nexport type SignInState =\n\t| { status: 'idle' }\n\t| { status: 'connecting' }\n\t/** The device grant is waiting for the user to approve in their browser. */\n\t| { status: 'awaitingApproval'; device: DeviceAuthorization }\n\t| { status: 'error'; error: RasterApiError }\n\nexport type SignIn = {\n\tstate: SignInState\n\t/** Device grant (RFC 8628). Works in every host. */\n\tsignInWithDevice: () => Promise<void>\n\t/** Verify and adopt a pasted organization API key. */\n\tconnectApiKey: (apiKey: string) => Promise<void>\n\t/** Abandon a device sign-in that is still waiting. */\n\tcancel: () => void\n\treset: () => void\n}\n\n/**\n * Drives both ways in — the device grant and an API key — and holds their state: a device\n * grant waiting on the user, or the error that ended an attempt. Read the credential itself\n * with `useSession`. `scope` and `organizationId` go to the device grant, as\n * `auth.signInWithDevice` takes them.\n */\nexport function useSignIn(\n\toptions: { scope?: 'user' | 'org'; organizationId?: string } = {}\n): SignIn {\n\tconst { scope, organizationId } = options\n\tconst client = useRasterClient()\n\n\tconst [state, setState] = useState<SignInState>({ status: 'idle' })\n\n\tconst controllerRef = useRef<AbortController | null>(null)\n\tconst mountedRef = useRef(true)\n\n\t/** Ignore results that arrive after unmount; `setState` on a dead component is noise. */\n\tconst settle = useCallback((next: SignInState) => {\n\t\tif (mountedRef.current) setState(next)\n\t}, [])\n\n\tconst fail = useCallback(\n\t\t(caught: unknown) => {\n\t\t\t// A cancellation is not a failure to report — the user asked for it.\n\t\t\tif (isAbortError(caught)) {\n\t\t\t\tsettle({ status: 'idle' })\n\t\t\t\treturn\n\t\t\t}\n\t\t\tsettle({ status: 'error', error: toRasterApiError(caught) })\n\t\t},\n\t\t[settle]\n\t)\n\n\tconst signInWithDevice = useCallback(async () => {\n\t\tcontrollerRef.current?.abort()\n\t\tconst controller = new AbortController()\n\t\tcontrollerRef.current = controller\n\n\t\tsettle({ status: 'connecting' })\n\t\ttry {\n\t\t\tawait client.auth.signInWithDevice({\n\t\t\t\tsignal: controller.signal,\n\t\t\t\tonCode: (device) => settle({ status: 'awaitingApproval', device }),\n\t\t\t\tscope,\n\t\t\t\torganizationId,\n\t\t\t})\n\t\t\tsettle({ status: 'idle' })\n\t\t} catch (caught) {\n\t\t\tfail(caught)\n\t\t}\n\t}, [client, settle, fail, scope, organizationId])\n\n\tconst connectApiKey = useCallback(\n\t\tasync (apiKey: string) => {\n\t\t\tsettle({ status: 'connecting' })\n\t\t\ttry {\n\t\t\t\tawait client.auth.connect({ apiKey })\n\t\t\t\tsettle({ status: 'idle' })\n\t\t\t} catch (caught) {\n\t\t\t\tfail(caught)\n\t\t\t}\n\t\t},\n\t\t[client, settle, fail]\n\t)\n\n\tconst cancel = useCallback(() => {\n\t\tcontrollerRef.current?.abort()\n\t\tsettle({ status: 'idle' })\n\t}, [settle])\n\n\tconst reset = useCallback(() => settle({ status: 'idle' }), [settle])\n\n\tuseEffect(() => {\n\t\tmountedRef.current = true\n\t\treturn () => {\n\t\t\tmountedRef.current = false\n\t\t\t// A device sign-in polls indefinitely. Leaving it running after unmount would keep\n\t\t\t// hitting the token endpoint for a screen nobody is looking at.\n\t\t\tcontrollerRef.current?.abort()\n\t\t}\n\t}, [])\n\n\treturn {\n\t\tstate,\n\t\tsignInWithDevice,\n\t\tconnectApiKey,\n\t\tcancel,\n\t\treset,\n\t}\n}\n"]}

package/package.json

@@ -1,6 +1,58 @@
 {
-  "name": "@raster-app/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+	"name": "@raster-app/react",
+	"version": "0.1.0-canary-2e1834e",
+	"description": "React provider and hooks for the Raster SDK: session, organizations, libraries, assets, search and uploads.",
+	"license": "MIT",
+	"homepage": "https://raster.app/docs",
+	"keywords": [
+		"raster",
+		"dam",
+		"assets",
+		"react",
+		"hooks",
+		"figma",
+		"sanity",
+		"plugin"
+	],
+	"type": "module",
+	"sideEffects": [
+		"*.css"
+	],
+	"files": [
+		"dist"
+	],
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./styles.css": "./dist/styles.css",
+		"./package.json": "./package.json"
+	},
+	"engines": {
+		"node": ">=24"
+	},
+	"scripts": {
+		"build": "rm -rf dist && tsc -p tsconfig.build.json && cp src/styles.css dist/",
+		"prepack": "bun run build",
+		"dev": "tsc -p tsconfig.build.json --watch",
+		"check-types": "tsc --noEmit",
+		"lint": "biome lint --error-on-warnings .",
+		"test": "bun test"
+	},
+	"dependencies": {
+		"@raster-app/sdk": "0.1.0-canary-2e1834e",
+		"@tanstack/react-query": "^5.103.1"
+	},
+	"peerDependencies": {
+		"react": "^18 || ^19"
+	},
+	"devDependencies": {
+		"@types/react": "^19.2.2",
+		"react": "^19.2.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
 }