@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/sharing/headless/useGroupMembers.d.ts

@@ -0,0 +1,22 @@
+import type { GroupMemberList } from '@marinoscar/platform-contract/sharing';
+import type { SharingClient, SharingPageQuery } from './client.js';
+import type { SharingResource } from './types.js';
+/**
+ * Lists a group's members, admins first. For a member of the group or a
+ * `groups:admin` holder.
+ *
+ * @param id - the group id; `undefined` skips the request.
+ * @param options - the page (default 1, page size 100) and `client`.
+ * @returns `{ data, loading, error, refresh }`.
+ *
+ * @example
+ * ```tsx
+ * const members = useGroupMembers(groupId);
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function useGroupMembers(id: string | undefined, options?: SharingPageQuery & {
+    client?: SharingClient;
+}): SharingResource<GroupMemberList>;
+//# sourceMappingURL=useGroupMembers.d.ts.map

package/dist/sharing/headless/useGroupMembers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGroupMembers.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/useGroupMembers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAI7E,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,OAAO,GAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,aAAa,CAAA;CAAO,GAC1D,eAAe,CAAC,eAAe,CAAC,CAQlC"}

package/dist/sharing/headless/useGroupMembers.js

@@ -0,0 +1,28 @@
+// The members of one group (issue #731; `GET /groups/:id/members`, #728).
+import { useAsyncResource } from '../internal/use-async-resource.js';
+import { useSharingClient } from '../internal/use-sharing-client.js';
+/**
+ * Lists a group's members, admins first. For a member of the group or a
+ * `groups:admin` holder.
+ *
+ * @param id - the group id; `undefined` skips the request.
+ * @param options - the page (default 1, page size 100) and `client`.
+ * @returns `{ data, loading, error, refresh }`.
+ *
+ * @example
+ * ```tsx
+ * const members = useGroupMembers(groupId);
+ * ```
+ *
+ * @stability experimental
+ */
+export function useGroupMembers(id, options = {}) {
+    const client = useSharingClient(options.client, 'useGroupMembers');
+    const page = options.page ?? 1;
+    const pageSize = options.pageSize ?? 100;
+    return useAsyncResource((signal) => client.listMembers(id ?? '', { page, pageSize }, { signal }), `${id ?? ''}:${page}:${pageSize}`, {
+        enabled: id !== undefined && id !== '',
+        fallbackMessage: 'Could not load the members.',
+    });
+}
+//# sourceMappingURL=useGroupMembers.js.map

package/dist/sharing/headless/useGroupMembers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGroupMembers.js","sourceRoot":"","sources":["../../../src/sharing/headless/useGroupMembers.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAI1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAIrE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAsB,EACtB,UAAyD,EAAE;IAE3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;IACzC,OAAO,gBAAgB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,QAAQ,EAAE,EAAE;QACnI,OAAO,EAAE,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE;QACtC,eAAe,EAAE,6BAA6B;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/sharing/headless/useGroupRoles.d.ts

@@ -0,0 +1,25 @@
+import type { GroupRoleList } from '@marinoscar/platform-contract/sharing';
+import type { SharingClient } from './client.js';
+import type { SharingResource } from './types.js';
+/**
+ * Loads the registered group roles: `admin`, `editor`, `viewer` and any the app
+ * registered on the API with `registerGroupRole`, strongest first, each with
+ * its label and actions. A member role picker lists these.
+ *
+ * @param options - `enabled` (default `true`) and `client`.
+ * @returns `{ data, loading, error, refresh }`.
+ *
+ * @example
+ * ```tsx
+ * const roles = useGroupRoles();
+ * const options = (roles.data?.items ?? []).map((role) => ({ value: role.id, label: role.label }));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useGroupRoles(options?: {
+    enabled?: boolean;
+    client?: SharingClient;
+}): SharingResource<GroupRoleList>;
+//# sourceMappingURL=useGroupRoles.d.ts.map

package/dist/sharing/headless/useGroupRoles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGroupRoles.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/useGroupRoles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAI3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAO,GAAG,eAAe,CAAC,aAAa,CAAC,CAOzH"}

package/dist/sharing/headless/useGroupRoles.js

@@ -0,0 +1,29 @@
+// The group roles the API offers (PP-14.15b; `GET /sharing/group-roles`).
+import { useAsyncResource } from '../internal/use-async-resource.js';
+import { useSharingClient } from '../internal/use-sharing-client.js';
+/**
+ * Loads the registered group roles: `admin`, `editor`, `viewer` and any the app
+ * registered on the API with `registerGroupRole`, strongest first, each with
+ * its label and actions. A member role picker lists these.
+ *
+ * @param options - `enabled` (default `true`) and `client`.
+ * @returns `{ data, loading, error, refresh }`.
+ *
+ * @example
+ * ```tsx
+ * const roles = useGroupRoles();
+ * const options = (roles.data?.items ?? []).map((role) => ({ value: role.id, label: role.label }));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function useGroupRoles(options = {}) {
+    const client = useSharingClient(options.client, 'useGroupRoles');
+    const enabled = options.enabled ?? true;
+    return useAsyncResource((signal) => client.listGroupRoles({ signal }), `group-roles:${String(enabled)}`, {
+        enabled,
+        fallbackMessage: 'Could not load the group roles.',
+    });
+}
+//# sourceMappingURL=useGroupRoles.js.map

package/dist/sharing/headless/useGroupRoles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGroupRoles.js","sourceRoot":"","sources":["../../../src/sharing/headless/useGroupRoles.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAI1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAIrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,UAAyD,EAAE;IACvF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACxC,OAAO,gBAAgB,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE;QACvG,OAAO;QACP,eAAe,EAAE,iCAAiC;KACnD,CAAC,CAAC;AACL,CAAC"}

package/dist/sharing/headless/useGroups.d.ts

@@ -0,0 +1,111 @@
+import type { CreateGroupInput, GroupDto, GroupInviteDto, GroupList, GroupMemberDto, GroupMembershipDto, GroupRole } from '@marinoscar/platform-contract/sharing';
+import type { SharingClient } from './client.js';
+import type { SharingResource } from './types.js';
+/**
+ * What {@link useGroups} takes.
+ *
+ * @stability experimental
+ */
+export interface UseGroupsOptions {
+    /** `mine` (default): groups the viewer belongs to. `all`: every group of the organization (`groups:admin`). */
+    scope?: 'mine' | 'all';
+    /** 1-based page. Default 1. */
+    page?: number;
+    /** Page size, at most 100. Default 100 (a picker wants them all). */
+    pageSize?: number;
+    /** `false` skips the request (e.g. `all` without `groups:admin`). Default `true`. */
+    enabled?: boolean;
+    /** The client to use. Default: one over the host's transport. */
+    client?: SharingClient;
+}
+/**
+ * Lists groups: the viewer's (`mine`) or, for a `groups:admin` holder, every
+ * group of the organization (`all`).
+ *
+ * @param options - the scope, the page, or just `'mine'` / `'all'`.
+ * @returns `{ data, loading, error, refresh }`; `data` is the page.
+ * @throws Error when no `client` is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error } = useGroups('mine');
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function useGroups(options?: UseGroupsOptions | 'mine' | 'all'): SharingResource<GroupList>;
+/**
+ * Loads one group (`GET /groups/:id`). A group the viewer may not see is a
+ * `404`, never a `403`.
+ *
+ * @param id - the group id; `undefined` skips the request.
+ * @param options - `client`: the client to use.
+ * @returns `{ data, loading, error, refresh }`.
+ *
+ * @stability experimental
+ */
+export declare function useGroup(id: string | undefined, options?: {
+    client?: SharingClient;
+}): SharingResource<GroupDto>;
+/**
+ * Every write on groups, their members and their invites. Each action
+ * rejects with a `SharingError` (show `message`, branch on `reason`:
+ * `VERSION_CONFLICT`, `GROUP_OWNS_RESOURCES`, `LAST_GROUP_ADMIN`, ...).
+ *
+ * @stability experimental
+ */
+export interface GroupActions {
+    /** A call is in flight. */
+    pending: boolean;
+    /** Create a group; the viewer becomes its admin. */
+    create(input: CreateGroupInput): Promise<GroupDto>;
+    /** Rename or re-describe a group; `version` is sent as `If-Match` (a stale one is `VERSION_CONFLICT`). */
+    update(id: string, input: {
+        name?: string;
+        description?: string | null;
+    }, version: number): Promise<GroupDto>;
+    /** Delete a group (`GROUP_OWNS_RESOURCES` while it still owns records). */
+    remove(id: string): Promise<void>;
+    /** Add a member directly, by e-mail or user id. */
+    addMember(id: string, input: {
+        email: string;
+        role?: GroupRole;
+    } | {
+        userId: string;
+        role?: GroupRole;
+    }): Promise<GroupMemberDto>;
+    /** Change a member's role (`LAST_GROUP_ADMIN` for the last admin). */
+    updateMember(id: string, userId: string, role: GroupRole): Promise<GroupMemberDto>;
+    /** Remove a member; with the viewer's own id, leave the group (`LAST_GROUP_ADMIN` for the last admin). */
+    removeMember(id: string, userId: string): Promise<void>;
+    /** Invite an address. */
+    invite(id: string, input: {
+        email: string;
+        role?: GroupRole;
+    }): Promise<GroupInviteDto>;
+    /** Revoke a pending invite. */
+    revokeInvite(id: string, inviteId: string): Promise<void>;
+    /** Accept one of the viewer's invites. */
+    accept(inviteId: string): Promise<GroupMembershipDto>;
+    /** Decline one of the viewer's invites. */
+    decline(inviteId: string): Promise<void>;
+}
+/**
+ * The group writes. Pair it with the read hooks and call their `refresh`
+ * after a write.
+ *
+ * @param options - `client`: the client to use.
+ * @returns the actions and a `pending` flag.
+ *
+ * @example
+ * ```tsx
+ * const actions = useGroupActions();
+ * await actions.update(group.id, { name }, group.version);
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function useGroupActions(options?: {
+    client?: SharingClient;
+}): GroupActions;
+//# sourceMappingURL=useGroups.d.ts.map

package/dist/sharing/headless/useGroups.d.ts.map

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

package/dist/sharing/headless/useGroups.js

@@ -0,0 +1,79 @@
+// Groups: the list, one group, and every write on groups, members and invites
+// (issue #731; routes from #728).
+import { useMemo } from 'react';
+import { useActionRunner } from '../internal/use-action-runner.js';
+import { useAsyncResource } from '../internal/use-async-resource.js';
+import { useSharingClient } from '../internal/use-sharing-client.js';
+/**
+ * Lists groups: the viewer's (`mine`) or, for a `groups:admin` holder, every
+ * group of the organization (`all`).
+ *
+ * @param options - the scope, the page, or just `'mine'` / `'all'`.
+ * @returns `{ data, loading, error, refresh }`; `data` is the page.
+ * @throws Error when no `client` is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error } = useGroups('mine');
+ * ```
+ *
+ * @stability experimental
+ */
+export function useGroups(options = {}) {
+    const opts = typeof options === 'string' ? { scope: options } : options;
+    const client = useSharingClient(opts.client, 'useGroups');
+    const scope = opts.scope ?? 'mine';
+    const page = opts.page ?? 1;
+    const pageSize = opts.pageSize ?? 100;
+    return useAsyncResource((signal) => client.listGroups({ scope, page, pageSize }, { signal }), `${scope}:${page}:${pageSize}:${String(opts.enabled ?? true)}`, { enabled: opts.enabled ?? true, fallbackMessage: 'Could not load the groups.' });
+}
+/**
+ * Loads one group (`GET /groups/:id`). A group the viewer may not see is a
+ * `404`, never a `403`.
+ *
+ * @param id - the group id; `undefined` skips the request.
+ * @param options - `client`: the client to use.
+ * @returns `{ data, loading, error, refresh }`.
+ *
+ * @stability experimental
+ */
+export function useGroup(id, options = {}) {
+    const client = useSharingClient(options.client, 'useGroup');
+    return useAsyncResource((signal) => client.getGroup(id ?? '', { signal }), id ?? '', {
+        enabled: id !== undefined && id !== '',
+        fallbackMessage: 'Could not load the group.',
+    });
+}
+/**
+ * The group writes. Pair it with the read hooks and call their `refresh`
+ * after a write.
+ *
+ * @param options - `client`: the client to use.
+ * @returns the actions and a `pending` flag.
+ *
+ * @example
+ * ```tsx
+ * const actions = useGroupActions();
+ * await actions.update(group.id, { name }, group.version);
+ * ```
+ *
+ * @stability experimental
+ */
+export function useGroupActions(options = {}) {
+    const client = useSharingClient(options.client, 'useGroupActions');
+    const { pending, run } = useActionRunner();
+    const actions = useMemo(() => ({
+        create: (input) => run(() => client.createGroup(input), 'Could not create the group.'),
+        update: (id, input, version) => run(() => client.updateGroup(id, input, version), 'Could not save the group.'),
+        remove: (id) => run(() => client.deleteGroup(id), 'Could not delete the group.'),
+        addMember: (id, input) => run(() => client.addMember(id, input), 'Could not add the member.'),
+        updateMember: (id, userId, role) => run(() => client.updateMember(id, userId, role), "Could not change the member's role."),
+        removeMember: (id, userId) => run(() => client.removeMember(id, userId), 'Could not remove the member.'),
+        invite: (id, input) => run(() => client.createInvite(id, input), 'Could not send the invitation.'),
+        revokeInvite: (id, inviteId) => run(() => client.revokeInvite(id, inviteId), 'Could not revoke the invitation.'),
+        accept: (inviteId) => run(() => client.acceptInvite(inviteId), 'Could not accept the invitation.'),
+        decline: (inviteId) => run(() => client.declineInvite(inviteId), 'Could not decline the invitation.'),
+    }), [client, run]);
+    return { pending, ...actions };
+}
+//# sourceMappingURL=useGroups.js.map

package/dist/sharing/headless/useGroups.js.map

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

package/dist/sharing/headless/useLinkGrants.d.ts

@@ -0,0 +1,43 @@
+import type { LinkGrantView } from '@marinoscar/platform-contract/sharing';
+import type { CreateLinkInput, IssuedLinkGrant, SharingClient } from './client.js';
+import type { ResourceRef, SharingResource } from './types.js';
+/**
+ * What {@link useLinkGrants} returns: the record's active links and the link writes.
+ *
+ * @stability experimental
+ */
+export interface UseLinkGrantsReturn extends SharingResource<LinkGrantView[]> {
+    /** A write is in flight. */
+    pending: boolean;
+    /** Create a link. The token is in the result's `url` once; never store it. Rejects with a `SharingError`. */
+    create(input?: CreateLinkInput): Promise<IssuedLinkGrant>;
+    /** Revoke a link: the next resolution of its token is a `404`. Rejects with a `SharingError`. */
+    revoke(grantId: string): Promise<void>;
+    /**
+     * Copy a share URL to the clipboard. Resolves `true` when it was copied,
+     * `false` when the browser refused (show the URL as text to copy by hand).
+     */
+    copyUrl(url: string): Promise<boolean>;
+}
+/**
+ * The link grants of one record. The links route arrives with #730: until it
+ * is deployed the list fails with a `404`, which a component shows as "links
+ * are not available".
+ *
+ * @param resource - the record.
+ * @param options - `enabled` (default `true`) and `client`.
+ * @returns the active links, `{ loading, error, refresh }` and `create`, `revoke`, `copyUrl`.
+ *
+ * @example
+ * ```tsx
+ * const links = useLinkGrants(resource);
+ * const { url } = await links.create({ expiresAt: null });
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function useLinkGrants(resource: ResourceRef, options?: {
+    enabled?: boolean;
+    client?: SharingClient;
+}): UseLinkGrantsReturn;
+//# sourceMappingURL=useLinkGrants.d.ts.map

package/dist/sharing/headless/useLinkGrants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkGrants.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/useLinkGrants.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAO3E,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe,CAAC,aAAa,EAAE,CAAC;IAC3E,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,6GAA6G;IAC7G,MAAM,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,iGAAiG;IACjG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAO,GAAG,mBAAmB,CAgBrI"}

package/dist/sharing/headless/useLinkGrants.js

@@ -0,0 +1,35 @@
+// Link shares of one record (issue #731; routes from #730): list, create,
+// revoke, copy.
+import { useCallback } from 'react';
+import { copyText } from '../internal/clipboard.js';
+import { useActionRunner } from '../internal/use-action-runner.js';
+import { useAsyncResource } from '../internal/use-async-resource.js';
+import { useSharingClient } from '../internal/use-sharing-client.js';
+/**
+ * The link grants of one record. The links route arrives with #730: until it
+ * is deployed the list fails with a `404`, which a component shows as "links
+ * are not available".
+ *
+ * @param resource - the record.
+ * @param options - `enabled` (default `true`) and `client`.
+ * @returns the active links, `{ loading, error, refresh }` and `create`, `revoke`, `copyUrl`.
+ *
+ * @example
+ * ```tsx
+ * const links = useLinkGrants(resource);
+ * const { url } = await links.create({ expiresAt: null });
+ * ```
+ *
+ * @stability experimental
+ */
+export function useLinkGrants(resource, options = {}) {
+    const client = useSharingClient(options.client, 'useLinkGrants');
+    const enabled = options.enabled ?? true;
+    const { type, id } = resource;
+    const list = useAsyncResource((signal) => client.listLinkGrants({ type, id }, { signal }), `${type}:${id}:${String(enabled)}`, { enabled, fallbackMessage: 'Could not load the links.' });
+    const { pending, run } = useActionRunner();
+    const create = useCallback((input) => run(() => client.createLinkGrant({ type, id }, input), 'Could not create the link.'), [client, run, type, id]);
+    const revoke = useCallback((grantId) => run(() => client.revokeGrant(grantId), 'Could not revoke the link.'), [client, run]);
+    return { ...list, pending, create, revoke, copyUrl: copyText };
+}
+//# sourceMappingURL=useLinkGrants.js.map

package/dist/sharing/headless/useLinkGrants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkGrants.js","sourceRoot":"","sources":["../../../src/sharing/headless/useLinkGrants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gBAAgB;AAGhB,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAuBrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,QAAqB,EAAE,UAAyD,EAAE;IAC9G,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACxC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,QAAQ,CAAC;IAC9B,MAAM,IAAI,GAAG,gBAAgB,CAC3B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAC3D,GAAG,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,EAClC,EAAE,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,CAC1D,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,eAAe,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,KAAuB,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,4BAA4B,CAAC,EACjH,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CACxB,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACrI,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACjE,CAAC"}

package/dist/sharing/headless/usePublicLink.d.ts

@@ -0,0 +1,68 @@
+import type { PublicLinkResolution } from '@marinoscar/platform-contract/sharing';
+import type { PlatformApiClient } from '../../core/index.js';
+import type { SharingClient } from './client.js';
+import type { SharingError } from './types.js';
+/**
+ * The token in a URL fragment (`#lnk_…`), or `null` when the fragment is
+ * empty or is not a well-formed link token (`LINK_TOKEN_PATTERN`: `lnk_` and
+ * 43 base64url characters), which is then never sent. Pure: it neither reads
+ * nor changes the location.
+ *
+ * @param hash - `location.hash`, with or without the leading `#`.
+ * @returns the token, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function parseLinkTokenFromHash(hash: string): string | null;
+/**
+ * Where the public link resolution stands.
+ *
+ * @stability experimental
+ */
+export type PublicLinkStatus = 'loading' | 'ready' | 'unavailable';
+/**
+ * What {@link usePublicLink} returns.
+ *
+ * @stability experimental
+ */
+export interface UsePublicLinkReturn {
+    /** `loading` until the API answers; `ready` with a resolution; `unavailable` for EVERY failure. */
+    status: PublicLinkStatus;
+    /** What the token resolved to, or `null`. */
+    resolution: PublicLinkResolution | null;
+    /** The token, in memory only, for a renderer's own `x-link-token` calls; `null` when there is none. */
+    token: string | null;
+    /** The failure, or `null`. Show the neutral message whatever it is; never the token. */
+    error: SharingError | null;
+    /** `status === 'loading'`. */
+    loading: boolean;
+}
+/**
+ * What {@link usePublicLink} takes.
+ *
+ * @stability experimental
+ */
+export interface UsePublicLinkOptions {
+    /** The transport, for a page outside the app's `PlatformHostProvider` (the public route usually is). */
+    apiClient?: PlatformApiClient;
+    /** A sharing client, instead of `apiClient` (moved routes, tests). */
+    client?: SharingClient;
+}
+/**
+ * Resolves the link token in the page's URL fragment. See the module header
+ * for the token handling rules (fragment removed at once, memory only, header
+ * only, never logged).
+ *
+ * @param options - `apiClient` or `client`; default the host's transport.
+ * @returns `{ status, resolution, token, error, loading }`.
+ * @throws Error when neither is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { status, resolution, token } = usePublicLink({ apiClient });
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function usePublicLink(options?: UsePublicLinkOptions): UsePublicLinkReturn;
+//# sourceMappingURL=usePublicLink.d.ts.map

package/dist/sharing/headless/usePublicLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePublicLink.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/usePublicLink.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAIlF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlE;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,mGAAmG;IACnG,MAAM,EAAE,gBAAgB,CAAC;IACzB,6CAA6C;IAC7C,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,uGAAuG;IACvG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wFAAwF;IACxF,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,wGAAwG;IACxG,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAuErF"}

package/dist/sharing/headless/usePublicLink.js

@@ -0,0 +1,145 @@
+// =============================================================================
+// usePublicLink: resolve the link token of the public `/s` page (issue #731)
+// =============================================================================
+//
+// A share URL is `${APP_URL}/s#lnk_…` (`buildLinkUrl`): the token rides in the
+// FRAGMENT, which a browser never sends to a server, so it never reaches an
+// access log, a span or a `Referer`. This hook keeps it that way in the
+// browser:
+//
+//   1. it reads the token from `window.location.hash`;
+//   2. it removes the fragment from the address bar AT ONCE, with
+//      `history.replaceState` (keeping the router's history state), before any
+//      request, so the token survives in neither the history, a screenshot, a
+//      bookmark nor a later `Referer`;
+//   3. it keeps the token in memory only (a ref and state): NEVER
+//      `localStorage`, `sessionStorage`, a cookie or IndexedDB, which any
+//      script on the origin could read. A reload after the fragment is gone
+//      shows the neutral message; the recipient opens the original link again;
+//   4. it calls `GET /public/links/current` with the token in `x-link-token`
+//      (`LINK_TOKEN_HEADER`), never in a path or a query string;
+//   5. it never logs the token.
+//
+// Every failure (unknown, expired, revoked, malformed, throttled, network) is
+// the same `unavailable` status, matching the API's uniform 404.
+// =============================================================================
+import { LINK_TOKEN_PATTERN } from '@marinoscar/platform-contract/sharing';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { useOptionalPlatformHost } from '../../core/index.js';
+import { createSharingClient } from './client.js';
+import { toSharingError } from './errors.js';
+/**
+ * The token in a URL fragment (`#lnk_…`), or `null` when the fragment is
+ * empty or is not a well-formed link token (`LINK_TOKEN_PATTERN`: `lnk_` and
+ * 43 base64url characters), which is then never sent. Pure: it neither reads
+ * nor changes the location.
+ *
+ * @param hash - `location.hash`, with or without the leading `#`.
+ * @returns the token, or `null`.
+ *
+ * @stability experimental
+ */
+export function parseLinkTokenFromHash(hash) {
+    let raw = hash.startsWith('#') ? hash.slice(1) : hash;
+    try {
+        raw = decodeURIComponent(raw);
+    }
+    catch {
+        return null;
+    }
+    raw = raw.trim();
+    return LINK_TOKEN_PATTERN.test(raw) ? raw : null;
+}
+const NO_TOKEN = {
+    message: 'This link is not available.',
+    status: null,
+    reason: null,
+    retryAfterSeconds: null,
+    details: undefined,
+};
+/** Removes the fragment from the address bar without a navigation, keeping the history state. */
+function clearHash() {
+    const { pathname, search } = window.location;
+    window.history.replaceState(window.history.state, '', `${pathname}${search}`);
+}
+/**
+ * Resolves the link token in the page's URL fragment. See the module header
+ * for the token handling rules (fragment removed at once, memory only, header
+ * only, never logged).
+ *
+ * @param options - `apiClient` or `client`; default the host's transport.
+ * @returns `{ status, resolution, token, error, loading }`.
+ * @throws Error when neither is given and no `PlatformHostProvider` is mounted.
+ *
+ * @example
+ * ```tsx
+ * const { status, resolution, token } = usePublicLink({ apiClient });
+ * ```
+ *
+ * @stability experimental
+ */
+export function usePublicLink(options = {}) {
+    const hostApi = useOptionalPlatformHost()?.api;
+    const api = options.apiClient ?? hostApi;
+    const client = useMemo(() => {
+        if (options.client)
+            return options.client;
+        if (!api) {
+            throw new Error('usePublicLink: no apiClient, no client and no PlatformHostProvider. Pass the app transport as `apiClient`.');
+        }
+        return createSharingClient(api);
+    }, [options.client, api]);
+    // The token survives a StrictMode effect re-run in this ref: the second run
+    // finds the fragment already gone and reuses it.
+    const tokenRef = useRef(null);
+    const [state, setState] = useState({
+        status: 'loading',
+        resolution: null,
+        token: null,
+        error: null,
+    });
+    useEffect(() => {
+        let controller = null;
+        const capture = () => {
+            const hash = window.location.hash;
+            if (hash === '' || hash === '#')
+                return false;
+            clearHash();
+            tokenRef.current = parseLinkTokenFromHash(hash);
+            return true;
+        };
+        const resolve = () => {
+            controller?.abort();
+            const current = new AbortController();
+            controller = current;
+            const token = tokenRef.current;
+            if (token === null) {
+                setState({ status: 'unavailable', resolution: null, token: null, error: NO_TOKEN });
+                return;
+            }
+            setState({ status: 'loading', resolution: null, token, error: null });
+            client.resolvePublicLink(token, { signal: current.signal }).then((resolution) => {
+                if (!current.signal.aborted)
+                    setState({ status: 'ready', resolution, token, error: null });
+            }, (err) => {
+                if (!current.signal.aborted) {
+                    setState({ status: 'unavailable', resolution: null, token, error: toSharingError(err, NO_TOKEN.message) });
+                }
+            });
+        };
+        capture();
+        resolve();
+        // A second link pasted into the same tab changes only the fragment.
+        const onHashChange = () => {
+            if (capture())
+                resolve();
+        };
+        window.addEventListener('hashchange', onHashChange);
+        return () => {
+            window.removeEventListener('hashchange', onHashChange);
+            controller?.abort();
+        };
+    }, [client]);
+    return { ...state, loading: state.status === 'loading' };
+}
+//# sourceMappingURL=usePublicLink.js.map

package/dist/sharing/headless/usePublicLink.js.map

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