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

package/dist/sharing/headless/client.js

@@ -0,0 +1,102 @@
+// The sharing API calls over the app's transport (issue #731, PP-7.4).
+//
+// Routes (`@marinoscar/platform-contract/sharing`): groups, members and
+// invites (#728), grants and "shared with me" (#729), link grants and the
+// public resolution (#730). Paths are relative to the API base, like every
+// `PlatformApiClient` call.
+import { LINK_TOKEN_HEADER } from '@marinoscar/platform-contract/sharing';
+function query(params) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined)
+            search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : '';
+}
+const enc = encodeURIComponent;
+/**
+ * The active links of a `linkGrantListSchema` page (#730: newest first, a
+ * revoked link included with `url: null`). An array is accepted too.
+ */
+function linkItems(body) {
+    const items = Array.isArray(body)
+        ? body
+        : body !== null && typeof body === 'object' && Array.isArray(body.items)
+            ? (body.items)
+            : [];
+    return items.filter((link) => link.revokedAt === null || link.revokedAt === undefined);
+}
+/** `issuedLinkGrantSchema` (`{ grant, url, token }`, #730); a bare view is accepted too. */
+function issued(body) {
+    const value = (body ?? {});
+    if (value.grant && typeof value.grant === 'object') {
+        return { grant: value.grant, url: value.url ?? value.grant.url ?? null, token: value.token ?? null };
+    }
+    const grant = value;
+    return { grant, url: grant.url ?? null, token: value.token ?? null };
+}
+/**
+ * The sharing client over the app's transport.
+ *
+ * @param api - the app's transport (`usePlatformApi()`).
+ * @param paths - where the routes live, when the app moved them.
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const client = createSharingClient(usePlatformApi());
+ * const groups = await client.listGroups({ scope: 'mine' });
+ * ```
+ *
+ * @stability experimental
+ */
+export function createSharingClient(api, paths = {}) {
+    const groups = paths.groups ?? '/groups';
+    const grants = paths.grants ?? '/grants';
+    const publicLinks = paths.publicLinks ?? '/public/links';
+    const sharing = paths.sharing ?? '/sharing';
+    return {
+        listGroups: (q, options) => api.get(`${groups}${query({ scope: q.scope, page: q.page, pageSize: q.pageSize })}`, options),
+        getGroup: (id, options) => api.get(`${groups}/${enc(id)}`, options),
+        createGroup: (input) => api.post(groups, input),
+        updateGroup: (id, input, version) => api.patch(`${groups}/${enc(id)}`, input, { ifMatch: String(version) }),
+        deleteGroup: (id) => api.delete(`${groups}/${enc(id)}`),
+        listMembers: (id, q = {}, options) => api.get(`${groups}/${enc(id)}/members${query({ page: q.page, pageSize: q.pageSize })}`, options),
+        addMember: (id, input) => api.post(`${groups}/${enc(id)}/members`, input),
+        updateMember: (id, userId, role) => api.patch(`${groups}/${enc(id)}/members/${enc(userId)}`, { role }),
+        removeMember: (id, userId) => api.delete(`${groups}/${enc(id)}/members/${enc(userId)}`),
+        listInvites: (id, q = {}, options) => api.get(`${groups}/${enc(id)}/invites${query({ status: q.status, page: q.page, pageSize: q.pageSize })}`, options),
+        createInvite: (id, input) => api.post(`${groups}/${enc(id)}/invites`, input),
+        revokeInvite: (id, inviteId) => api.delete(`${groups}/${enc(id)}/invites/${enc(inviteId)}`),
+        myInvites: (options) => api.get(`${groups}/invites/mine`, options),
+        acceptInvite: (inviteId) => api.post(`${groups}/invites/${enc(inviteId)}/accept`),
+        declineInvite: (inviteId) => api.post(`${groups}/invites/${enc(inviteId)}/decline`),
+        listGranteeKinds: (options) => api.get(`${sharing}/grantee-kinds`, options),
+        listGroupRoles: (options) => api.get(`${sharing}/group-roles`, options),
+        listGrants: (resource, q = {}, options) => api.get(`${grants}${query({ resourceType: resource.type, resourceId: resource.id, page: q.page, pageSize: q.pageSize })}`, options),
+        createGrant: (resource, target, role, expiresAt) => api.post(grants, {
+            resourceType: resource.type,
+            resourceId: resource.id,
+            grantee: target,
+            role,
+            ...(expiresAt === undefined ? {} : { expiresAt }),
+        }),
+        updateGrant: (id, input) => api.patch(`${grants}/${enc(id)}`, input),
+        revokeGrant: (id) => api.delete(`${grants}/${enc(id)}`),
+        sharedWithMe: (q = {}, options) => api.get(`${grants}/shared-with-me${query({ resourceType: q.resourceType, page: q.page, pageSize: q.pageSize })}`, options),
+        listLinkGrants: async (resource, options) => linkItems(await api.get(`${grants}/links${query({ resourceType: resource.type, resourceId: resource.id, pageSize: 100 })}`, options)),
+        createLinkGrant: async (resource, input = {}) => issued(await api.post(`${grants}/links`, {
+            resourceType: resource.type,
+            resourceId: resource.id,
+            ...(input.role === undefined ? {} : { role: input.role }),
+            ...(input.expiresAt === undefined ? {} : { expiresAt: input.expiresAt }),
+            ...(input.label === undefined ? {} : { label: input.label }),
+        })),
+        resolvePublicLink: (token, options) => api.get(`${publicLinks}/current`, {
+            ...(options?.signal === undefined ? {} : { signal: options.signal }),
+            headers: { ...(options?.headers ?? {}), [LINK_TOKEN_HEADER]: token },
+        }),
+    };
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,35 @@
+import type { SharingError } from './types.js';
+/**
+ * A wait in plain language: "a few seconds", "about a minute", "about 3 minutes".
+ *
+ * @param seconds - the wait, in seconds.
+ * @returns the phrase.
+ *
+ * @stability experimental
+ */
+export declare function describeRetryAfter(seconds: number): string;
+/**
+ * Normalises whatever a sharing call rejected with into a {@link SharingError}.
+ *
+ * @param error - the rejection (a `PlatformApiError`, a network failure, anything).
+ * @param fallback - the message when the error carries none.
+ * @returns the normalised error.
+ *
+ * @example
+ * ```ts
+ * try { await actions.revoke(id); } catch (err) { setError(toSharingError(err).message); }
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function toSharingError(error: unknown, fallback?: string): SharingError;
+/**
+ * Whether `value` is already a {@link SharingError} (the shape the hooks' actions reject with).
+ *
+ * @param value - anything.
+ * @returns `true` for a normalised sharing error.
+ *
+ * @stability experimental
+ */
+export declare function isSharingError(value: unknown): value is SharingError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/errors.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkB/C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAqC,GAAG,YAAY,CAiB1G;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CASpE"}

package/dist/sharing/headless/errors.js

@@ -0,0 +1,93 @@
+// Turning a failed sharing call into something a person can read (issue #731).
+//
+// kvox's `shareErrorMessage` approach: show the API's own `message` (it is
+// written for people and safe to show), except where the UI can say something
+// more useful for a known reason (a 429's wait, a stale version).
+import { isPlatformApiError } from '../../core/index.js';
+function reasonOf(details, code) {
+    if (details !== null && typeof details === 'object') {
+        const reason = details.reason;
+        if (typeof reason === 'string' && reason.length > 0)
+            return reason;
+    }
+    return code ?? null;
+}
+function retryAfterOf(details) {
+    if (details !== null && typeof details === 'object') {
+        const ms = details.retryAfterMs;
+        if (typeof ms === 'number' && Number.isFinite(ms) && ms > 0)
+            return Math.ceil(ms / 1000);
+    }
+    return null;
+}
+/**
+ * A wait in plain language: "a few seconds", "about a minute", "about 3 minutes".
+ *
+ * @param seconds - the wait, in seconds.
+ * @returns the phrase.
+ *
+ * @stability experimental
+ */
+export function describeRetryAfter(seconds) {
+    if (seconds < 45)
+        return 'a few seconds';
+    const minutes = Math.round(seconds / 60);
+    if (minutes <= 1)
+        return 'about a minute';
+    if (minutes < 60)
+        return `about ${minutes} minutes`;
+    const hours = Math.round(minutes / 60);
+    return hours <= 1 ? 'about an hour' : `about ${hours} hours`;
+}
+/**
+ * Normalises whatever a sharing call rejected with into a {@link SharingError}.
+ *
+ * @param error - the rejection (a `PlatformApiError`, a network failure, anything).
+ * @param fallback - the message when the error carries none.
+ * @returns the normalised error.
+ *
+ * @example
+ * ```ts
+ * try { await actions.revoke(id); } catch (err) { setError(toSharingError(err).message); }
+ * ```
+ *
+ * @stability experimental
+ */
+export function toSharingError(error, fallback = 'Something went wrong. Try again.') {
+    if (isSharingError(error))
+        return error;
+    if (isPlatformApiError(error)) {
+        const reason = reasonOf(error.details, error.code);
+        const retryAfterSeconds = error.status === 429 ? (retryAfterOf(error.details) ?? null) : null;
+        let message = error.message || fallback;
+        if (error.status === 429) {
+            message =
+                retryAfterSeconds === null
+                    ? 'Too many attempts. Wait a little, then try again.'
+                    : `Too many attempts. Try again in ${describeRetryAfter(retryAfterSeconds)}.`;
+        }
+        else if (reason === 'VERSION_CONFLICT') {
+            message = 'Someone else changed this since you opened it. Reload to see the latest version, then try again.';
+        }
+        return { message, status: error.status, reason, retryAfterSeconds, details: error.details };
+    }
+    return { message: fallback, status: null, reason: null, retryAfterSeconds: null, details: undefined };
+}
+/**
+ * Whether `value` is already a {@link SharingError} (the shape the hooks' actions reject with).
+ *
+ * @param value - anything.
+ * @returns `true` for a normalised sharing error.
+ *
+ * @stability experimental
+ */
+export function isSharingError(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (typeof candidate.message === 'string' &&
+        'reason' in candidate &&
+        'retryAfterSeconds' in candidate &&
+        (candidate.status === null || typeof candidate.status === 'number'));
+}
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,127 @@
+import type { GranteeKindDescriptor } from '@marinoscar/platform-contract/sharing';
+import type { ComponentType } from 'react';
+/**
+ * What a registered grantee picker receives.
+ *
+ * @stability experimental
+ */
+export interface GranteePickerProps {
+    /** The kind being collected (its label and input type). */
+    descriptor: GranteeKindDescriptor;
+    /** The grantee reference chosen so far (`''` before a choice). */
+    value: string;
+    /** Report the chosen grantee reference (`''` clears it). The API's kind validates it. */
+    onChange: (ref: string) => void;
+    /** The dialog is saving: disable the controls. */
+    disabled?: boolean;
+    /** An error to show next to the control, or `undefined`. */
+    error?: string | undefined;
+}
+/**
+ * A component that collects the grantee of one kind.
+ *
+ * @stability experimental
+ */
+export type GranteePicker = ComponentType<GranteePickerProps>;
+/**
+ * Why a grantee-picker registration was refused.
+ *
+ * @stability experimental
+ */
+export type GranteePickerRegistryErrorCode = 'INVALID_ID' | 'DUPLICATE_ID' | 'FROZEN';
+/**
+ * A refused registration. Switch on `code`, never on the message.
+ *
+ * @stability experimental
+ */
+export declare class GranteePickerRegistryError extends Error {
+    /** Why. */
+    readonly code: GranteePickerRegistryErrorCode;
+    /** The grantee kind id the registration named. */
+    readonly id: string;
+    /**
+     * @param code - why the registration was refused.
+     * @param id - the grantee kind id.
+     * @param message - the human-readable reason.
+     */
+    constructor(code: GranteePickerRegistryErrorCode, id: string, message: string);
+}
+/**
+ * The grantee kind to component map behind {@link registerGranteePicker}. The
+ * app uses the default instance through the module functions; a test may build
+ * its own and pass it to `ShareDialog`'s `granteePickers` prop.
+ *
+ * @stability experimental
+ */
+export declare class GranteePickerRegistry {
+    private readonly entries;
+    private frozen;
+    /**
+     * Registers the picker of one grantee kind.
+     *
+     * @param kind - a grantee kind id (`GRANTEE_KIND_ID_PATTERN`).
+     * @param component - the picker.
+     * @throws GranteePickerRegistryError `INVALID_ID`, `DUPLICATE_ID` or `FROZEN`.
+     */
+    register(kind: string, component: GranteePicker): void;
+    /**
+     * The picker of a grantee kind.
+     *
+     * @param kind - the grantee kind id.
+     * @returns the picker, or `undefined` when none is registered.
+     */
+    get(kind: string): GranteePicker | undefined;
+    /**
+     * The grantee kinds with a picker, in registration order.
+     *
+     * @returns a fresh array.
+     */
+    kinds(): string[];
+    /** Refuses every later registration. Idempotent; reads keep working. */
+    freeze(): void;
+    /**
+     * Whether {@link GranteePickerRegistry.freeze} ran.
+     *
+     * @returns `true` once frozen.
+     */
+    isFrozen(): boolean;
+}
+/**
+ * The app's grantee pickers: the instance the module functions and
+ * `ShareDialog` use by default.
+ *
+ * @stability experimental
+ */
+export declare const granteePickers: GranteePickerRegistry;
+/**
+ * Registers how the share dialog collects the grantee of one kind. Call it at
+ * startup, before {@link freezeGranteePickers}.
+ *
+ * @param kind - the grantee kind id, as registered on the API (`team`).
+ * @param component - receives `{ descriptor, value, onChange, disabled, error }`.
+ * @throws GranteePickerRegistryError `INVALID_ID`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```tsx
+ * registerGranteePicker('team', TeamPicker);
+ * freezeGranteePickers();
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerGranteePicker(kind: string, component: GranteePicker): void;
+/**
+ * Freezes the app's grantee pickers: call it once the app has bootstrapped.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/main.tsx, after every registration
+ * freezeGranteePickers();
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function freezeGranteePickers(): void;
+//# sourceMappingURL=granteePickers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"granteePickers.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/granteePickers.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,UAAU,EAAE,qBAAqB,CAAC;IAClC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEtF;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;gBACS,IAAI,EAAE,8BAA8B,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM9E;AAED;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAatD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C;;;;OAIG;IACH,KAAK,IAAI,MAAM,EAAE;IAIjB,wEAAwE;IACxE,MAAM,IAAI,IAAI;IAId;;;;OAIG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,qBAAmD,CAAC;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAElF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/sharing/headless/granteePickers.js

@@ -0,0 +1,143 @@
+// =============================================================================
+// The grantee-picker registry (PP-14.16): rung 2 of the Extension Contract for
+// the share dialog
+// =============================================================================
+//
+// The API serves the grantee kinds it knows (`GET /api/sharing/grantee-kinds`:
+// `user`, `group`, `link` and any the app registered with `registerGranteeKind`)
+// with a label and an `input` type. `ShareDialog` collects the grantee of a kind
+// whose `input` is `text` with a plain text field. A kind whose grantee needs
+// more (a team search, a calendar, a map) has `input: 'custom'` and the app
+// registers ONE component for it here, at startup; `ShareDialog` renders it in
+// place of the field and sends what it reports as the grantee's `ref`.
+//
+// The core registry semantics, like the link renderers: string ids checked
+// against a pattern, a duplicate id is an error, and after `freeze()` a
+// registration is an error while reads keep working. Errors carry a `code` to
+// switch on, never the message.
+// =============================================================================
+import { GRANTEE_KIND_ID_PATTERN } from '@marinoscar/platform-contract/sharing';
+/**
+ * A refused registration. Switch on `code`, never on the message.
+ *
+ * @stability experimental
+ */
+export class GranteePickerRegistryError extends Error {
+    /** Why. */
+    code;
+    /** The grantee kind id the registration named. */
+    id;
+    /**
+     * @param code - why the registration was refused.
+     * @param id - the grantee kind id.
+     * @param message - the human-readable reason.
+     */
+    constructor(code, id, message) {
+        super(message);
+        this.name = 'GranteePickerRegistryError';
+        this.code = code;
+        this.id = id;
+    }
+}
+/**
+ * The grantee kind to component map behind {@link registerGranteePicker}. The
+ * app uses the default instance through the module functions; a test may build
+ * its own and pass it to `ShareDialog`'s `granteePickers` prop.
+ *
+ * @stability experimental
+ */
+export class GranteePickerRegistry {
+    entries = new Map();
+    frozen = false;
+    /**
+     * Registers the picker of one grantee kind.
+     *
+     * @param kind - a grantee kind id (`GRANTEE_KIND_ID_PATTERN`).
+     * @param component - the picker.
+     * @throws GranteePickerRegistryError `INVALID_ID`, `DUPLICATE_ID` or `FROZEN`.
+     */
+    register(kind, component) {
+        if (this.frozen) {
+            throw new GranteePickerRegistryError('FROZEN', kind, `Grantee pickers are frozen: register "${kind}" at startup, before freezeGranteePickers().`);
+        }
+        if (typeof kind !== 'string' || !GRANTEE_KIND_ID_PATTERN.test(kind)) {
+            throw new GranteePickerRegistryError('INVALID_ID', String(kind), `"${String(kind)}" is not a grantee kind id (lower-case letters, digits and hyphens).`);
+        }
+        if (this.entries.has(kind)) {
+            throw new GranteePickerRegistryError('DUPLICATE_ID', kind, `A grantee picker for "${kind}" is already registered.`);
+        }
+        this.entries.set(kind, component);
+    }
+    /**
+     * The picker of a grantee kind.
+     *
+     * @param kind - the grantee kind id.
+     * @returns the picker, or `undefined` when none is registered.
+     */
+    get(kind) {
+        return this.entries.get(kind);
+    }
+    /**
+     * The grantee kinds with a picker, in registration order.
+     *
+     * @returns a fresh array.
+     */
+    kinds() {
+        return [...this.entries.keys()];
+    }
+    /** Refuses every later registration. Idempotent; reads keep working. */
+    freeze() {
+        this.frozen = true;
+    }
+    /**
+     * Whether {@link GranteePickerRegistry.freeze} ran.
+     *
+     * @returns `true` once frozen.
+     */
+    isFrozen() {
+        return this.frozen;
+    }
+}
+/**
+ * The app's grantee pickers: the instance the module functions and
+ * `ShareDialog` use by default.
+ *
+ * @stability experimental
+ */
+export const granteePickers = new GranteePickerRegistry();
+/**
+ * Registers how the share dialog collects the grantee of one kind. Call it at
+ * startup, before {@link freezeGranteePickers}.
+ *
+ * @param kind - the grantee kind id, as registered on the API (`team`).
+ * @param component - receives `{ descriptor, value, onChange, disabled, error }`.
+ * @throws GranteePickerRegistryError `INVALID_ID`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```tsx
+ * registerGranteePicker('team', TeamPicker);
+ * freezeGranteePickers();
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerGranteePicker(kind, component) {
+    granteePickers.register(kind, component);
+}
+/**
+ * Freezes the app's grantee pickers: call it once the app has bootstrapped.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/main.tsx, after every registration
+ * freezeGranteePickers();
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function freezeGranteePickers() {
+    granteePickers.freeze();
+}
+//# sourceMappingURL=granteePickers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"granteePickers.js","sourceRoot":"","sources":["../../../src/sharing/headless/granteePickers.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,mBAAmB;AACnB,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,uEAAuE;AACvE,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,8EAA8E;AAC9E,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAoChF;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,WAAW;IACF,IAAI,CAAiC;IAC9C,kDAAkD;IACzC,EAAE,CAAS;IAEpB;;;;OAIG;IACH,YAAY,IAAoC,EAAE,EAAU,EAAE,OAAe;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IACf,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACpD,MAAM,GAAG,KAAK,CAAC;IAEvB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAY,EAAE,SAAwB;QAC7C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,0BAA0B,CAAC,QAAQ,EAAE,IAAI,EAAE,yCAAyC,IAAI,8CAA8C,CAAC,CAAC;QACpJ,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,0BAA0B,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QAC3J,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,0BAA0B,CAAC,cAAc,EAAE,IAAI,EAAE,yBAAyB,IAAI,0BAA0B,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,wEAAwE;IACxE,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0B,IAAI,qBAAqB,EAAE,CAAC;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAwB;IAC1E,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB;IAClC,cAAc,CAAC,MAAM,EAAE,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,22 @@
+export type { ResourceRef, SharingError, SharingResource, SharingRoleOption } from './types.js';
+export { describeRetryAfter, isSharingError, toSharingError } from './errors.js';
+export { createSharingClient } from './client.js';
+export type { CreateLinkInput, IssuedLinkGrant, ShareTarget, SharingClient, SharingClientPaths, SharingPageQuery, } from './client.js';
+export { useGroup, useGroupActions, useGroups } from './useGroups.js';
+export type { GroupActions, UseGroupsOptions } from './useGroups.js';
+export { useGroupMembers } from './useGroupMembers.js';
+export { useGroupInvites, useMyGroupInvites } from './useGroupInvites.js';
+export { useGranteeKinds } from './useGranteeKinds.js';
+export { useGroupRoles } from './useGroupRoles.js';
+export { useGrants, useShareActions } from './useGrants.js';
+export type { ShareActions } from './useGrants.js';
+export { useLinkGrants } from './useLinkGrants.js';
+export type { UseLinkGrantsReturn } from './useLinkGrants.js';
+export { useSharedWithMe } from './useSharedWithMe.js';
+export { parseLinkTokenFromHash, usePublicLink } from './usePublicLink.js';
+export type { PublicLinkStatus, UsePublicLinkOptions, UsePublicLinkReturn } from './usePublicLink.js';
+export { LinkRendererRegistry, LinkRendererRegistryError, freezeLinkRenderers, linkRenderers, registerLinkRenderer, } from './linkRenderers.js';
+export type { LinkRenderer, LinkRendererProps, LinkRendererRegistryErrorCode } from './linkRenderers.js';
+export { GranteePickerRegistry, GranteePickerRegistryError, freezeGranteePickers, granteePickers, registerGranteePicker, } from './granteePickers.js';
+export type { GranteePicker, GranteePickerProps, GranteePickerRegistryErrorCode } from './granteePickers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sharing/headless/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtG,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACzG,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/sharing/headless/index.js

@@ -0,0 +1,17 @@
+// `@marinoscar/platform-web/sharing/headless`: the sharing hooks, client and
+// link-renderer registry, with no component (issue #731, PP-7.4). Documented
+// in ../README.md.
+export { describeRetryAfter, isSharingError, toSharingError } from './errors.js';
+export { createSharingClient } from './client.js';
+export { useGroup, useGroupActions, useGroups } from './useGroups.js';
+export { useGroupMembers } from './useGroupMembers.js';
+export { useGroupInvites, useMyGroupInvites } from './useGroupInvites.js';
+export { useGranteeKinds } from './useGranteeKinds.js';
+export { useGroupRoles } from './useGroupRoles.js';
+export { useGrants, useShareActions } from './useGrants.js';
+export { useLinkGrants } from './useLinkGrants.js';
+export { useSharedWithMe } from './useSharedWithMe.js';
+export { parseLinkTokenFromHash, usePublicLink } from './usePublicLink.js';
+export { LinkRendererRegistry, LinkRendererRegistryError, freezeLinkRenderers, linkRenderers, registerLinkRenderer, } from './linkRenderers.js';
+export { GranteePickerRegistry, GranteePickerRegistryError, freezeGranteePickers, granteePickers, registerGranteePicker, } from './granteePickers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sharing/headless/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AAGnB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASlD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}