@stapel/workspaces-react 0.1.0

package/src/i18n/keys.ts

@@ -0,0 +1,83 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+import { workspacesErrorBundleEn } from "./generated/errors.gen.js";
+
+/**
+ * workspaces-react's own translation KEYS (frontend-standard §4.2): headless
+ * components never render literal strings — hosts resolve these via core's i18n
+ * engine (`useT`). Backend error codes flow through the SAME contour: a
+ * `StapelApiError.code` is already a key, so the default bundle below ships
+ * English fallbacks for both the backend error codes (generated) and the
+ * pair's own UI keys. Point core's `loadLocale` at stapel-translate to override
+ * per locale. Add UI keys under the `workspaces.` namespace as you build flows.
+ */
+export const WORKSPACES_I18N_KEYS = {
+  unknownError: "workspaces.error.unknown",
+  // Workspace list (WorkspaceList headless)
+  listLoading: "workspaces.list.loading",
+  listEmpty: "workspaces.list.empty",
+  listCreate: "workspaces.list.create",
+  listCreating: "workspaces.list.creating",
+  // Members (Members headless)
+  membersLoading: "workspaces.members.loading",
+  membersInvite: "workspaces.members.invite",
+  membersInviting: "workspaces.members.inviting",
+  membersUpdateRole: "workspaces.members.update_role",
+  membersRemove: "workspaces.members.remove",
+  // Accept invitation (AcceptInvitation headless)
+  acceptAccept: "workspaces.accept.accept",
+  acceptAccepting: "workspaces.accept.accepting",
+  acceptAccepted: "workspaces.accept.accepted",
+} as const;
+
+export type WorkspacesI18nKey =
+  (typeof WORKSPACES_I18N_KEYS)[keyof typeof WORKSPACES_I18N_KEYS];
+
+/**
+ * English fallback bundle for workspaces-react UI keys + backend error codes.
+ * The generated `workspacesErrorBundleEn` (from stapel-workspaces's error registry,
+ * `pnpm gen:errors`) is spread FIRST so every backend `error.*` key has a
+ * fallback — a `StapelApiError.code` never renders as a raw key. Hand-polished
+ * copy below then OVERRIDES the generated English for the keys users see most.
+ */
+export const workspacesI18nBundleEn: I18nDictionary = {
+  // Backend error codes — generated en fallbacks (coverage by construction).
+  ...workspacesErrorBundleEn,
+
+  // workspaces-react UI
+  "workspaces.error.unknown": "Something went wrong. Please try again.",
+  "workspaces.list.loading": "Loading workspaces…",
+  "workspaces.list.empty": "No workspaces yet.",
+  "workspaces.list.create": "Create workspace",
+  "workspaces.list.creating": "Creating…",
+  "workspaces.members.loading": "Loading members…",
+  "workspaces.members.invite": "Invite",
+  "workspaces.members.inviting": "Inviting…",
+  "workspaces.members.update_role": "Change role",
+  "workspaces.members.remove": "Remove",
+  "workspaces.accept.accept": "Accept invitation",
+  "workspaces.accept.accepting": "Accepting…",
+  "workspaces.accept.accepted": "You've joined the workspace.",
+};
+
+/**
+ * Register workspaces-react's key bundle into a core i18n engine (call once at
+ * startup). Registers under the given locale (default `"en"`); a later
+ * `loadLocale` from stapel-translate can layer localized overrides.
+ *
+ * MERGE-PRIORITY CONVENTION (pair checklist rule; i18n-shipping.md §3 — every
+ * `@stapel/*-react` pair follows it): registration order IS override
+ * priority, later wins per key. Within a locale, layers register bottom-up:
+ *
+ *   1. generated en floor  (`WorkspacesErrorBundleEn` — coverage by construction),
+ *   2. the pair's polish / UI copy (this bundle spreads 1 then overrides),
+ *   3. the pair's locale bundle from the `./i18n/<locale>` subpath
+ *      (e.g. `registerWorkspacesI18nRu` — registers the en floor UNDER the
+ *      locale texts so a missing key degrades to English, never a raw key),
+ *   4. the HOST's own bundle — always registered LAST, so a host overrides any
+ *      pair text without a fork.
+ *
+ * Dynamic overrides (stapel-translate `loadLocale`) layer on top at runtime.
+ */
+export function registerWorkspacesI18n(engine: I18nEngine, locale = "en"): void {
+  engine.registerBundle(locale, workspacesI18nBundleEn);
+}

package/src/i18n/ru.ts

@@ -0,0 +1,53 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+import { workspacesI18nBundleEn } from "./keys.js";
+import { workspacesErrorBundleRu } from "./generated/errors.ru.gen.js";
+
+export { workspacesErrorBundleRu } from "./generated/errors.ru.gen.js";
+
+/**
+ * Russian bundle for workspaces-react — the pair's `ru` locale, shipped as
+ * the `@stapel/workspaces-react/i18n/ru` subpath (i18n-shipping.md §2) so
+ * the locale is opt-in: hosts that don't register it never carry these
+ * strings (the main entry does not import this module — gated by size-limit
+ * + the bundle-purity test).
+ *
+ * Composition mirrors {@link workspacesI18nBundleEn}: the GENERATED backend
+ * error texts (from stapel-workspaces's `translations/errors.ru.json`
+ * catalog, seeded from the curated stapel-translate corpus — `pnpm
+ * gen:errors`) are spread first for coverage by construction; the
+ * hand-written ru UI copy for the pair-owned {@link WORKSPACES_I18N_KEYS}
+ * follows. Override any key by registering a host bundle AFTER this one
+ * (merge-priority convention — see keys.ts).
+ */
+export const workspacesI18nBundleRu: I18nDictionary = {
+  // Backend error codes — generated ru texts (coverage by construction).
+  ...workspacesErrorBundleRu,
+
+  // workspaces-react UI (hand-written ru mirror of the en copy in keys.ts)
+  "workspaces.error.unknown": "Что-то пошло не так. Попробуйте ещё раз.",
+  "workspaces.list.loading": "Загрузка рабочих пространств…",
+  "workspaces.list.empty": "Пока нет рабочих пространств.",
+  "workspaces.list.create": "Создать рабочее пространство",
+  "workspaces.list.creating": "Создание…",
+  "workspaces.members.loading": "Загрузка участников…",
+  "workspaces.members.invite": "Пригласить",
+  "workspaces.members.inviting": "Приглашение…",
+  "workspaces.members.update_role": "Изменить роль",
+  "workspaces.members.remove": "Удалить",
+  "workspaces.accept.accept": "Принять приглашение",
+  "workspaces.accept.accepting": "Принятие…",
+  "workspaces.accept.accepted": "Вы присоединились к рабочему пространству.",
+};
+
+/**
+ * Register the pair's `ru` locale into a core i18n engine (call once at
+ * startup, after {@link registerWorkspacesI18n}). Layers per the
+ * merge-priority convention (i18n-shipping.md §3): the en floor is registered
+ * UNDER the ru texts inside the `ru` locale, so a key the ru bundle ever
+ * misses degrades to its English text — never to a raw key. A host bundle
+ * registered after this call overrides both.
+ */
+export function registerWorkspacesI18nRu(engine: I18nEngine): void {
+  engine.registerBundle("ru", workspacesI18nBundleEn);
+  engine.registerBundle("ru", workspacesI18nBundleRu);
+}

package/src/index.ts

@@ -0,0 +1,113 @@
+/**
+ * `@stapel/workspaces-react` — the headless React flow pair for stapel-workspaces
+ * (frontend-standard §2). Business + state only, zero visual opinion. Built on
+ * `@stapel/core`'s StapelClient (verification-403 interception, token refresh,
+ * i18n, analytics, query layer).
+ *
+ * Scaffolded by `stapel-new-react-lib`. Layers: api → model → flows → headless
+ * → i18n. Generated surfaces (flows registry, error map, manifest, llms.txt)
+ * are produced by the monorepo `gen:*` drivers and stand under drift gates.
+ */
+
+// ── api ──────────────────────────────────────────────────────────────────────
+export { createWorkspacesApi } from "./api/workspacesApi.js";
+export type { WorkspacesApi } from "./api/workspacesApi.js";
+export type { Schemas } from "./api/types.js";
+
+// ── flows ────────────────────────────────────────────────────────────────────
+// The flow-machine primitive lives in `@stapel/core` (one reviewed copy for
+// every pair — frontend-core-architecture §4b). Re-exported for ergonomics.
+export { createFlowMachine, useFlow, isErrorCode } from "@stapel/core";
+export type {
+  FlowMachine,
+  FlowMachineOptions,
+  FlowStateBase,
+  FlowError,
+} from "@stapel/core";
+export { toFlowError } from "./flows/errors.js";
+export { WORKSPACES_FLOWS, flowEndpoints } from "./flows/generated/flows.gen.js";
+export type {
+  WorkspacesFlowId,
+  WorkspacesFlowSpec,
+  FlowEndpoint,
+} from "./flows/generated/flows.gen.js";
+
+// ── model (runtime wiring, query keys, context) ──────────────────────────────
+export { createWorkspacesRuntime } from "./model/runtime.js";
+export type {
+  WorkspacesRuntime,
+  CreateWorkspacesRuntimeOptions,
+} from "./model/runtime.js";
+export {
+  WorkspacesRuntimeContext,
+  useWorkspacesRuntime,
+  useWorkspacesApi,
+  useWorkspacesAnalytics,
+} from "./model/context.js";
+export { workspacesQueryKeys } from "./model/queryKeys.js";
+
+// ── model (read hooks) ───────────────────────────────────────────────────────
+export {
+  useWorkspaces,
+  useWorkspace,
+  useMembers,
+} from "./model/queries.js";
+
+// ── model (write hooks) ──────────────────────────────────────────────────────
+export {
+  useCreateWorkspace,
+  useUpdateWorkspace,
+  useDeleteWorkspace,
+  useInviteMembers,
+  useUpdateMemberRole,
+  useRemoveMember,
+  useAcceptInvitation,
+} from "./model/mutations.js";
+export type { MemberRoleChange } from "./model/mutations.js";
+
+// ── api (wire type aliases) ──────────────────────────────────────────────────
+export type {
+  Workspace as WorkspaceData,
+  WorkspaceList as WorkspaceListData,
+  WorkspaceCreate,
+  WorkspaceUpdate,
+  Member as MemberData,
+  MemberList as MemberListData,
+  MemberInvite,
+  MemberInviteResult,
+  MemberRoleUpdate,
+  Invitation,
+  InvitationAccept,
+  WorkspaceRole,
+  WorkspaceKind,
+} from "./api/types.js";
+
+// ── headless (renderless components) ─────────────────────────────────────────
+export { WorkspacesProvider } from "./headless/WorkspacesProvider.js";
+export { WorkspaceList } from "./headless/WorkspaceList.js";
+export type { WorkspaceListBag } from "./headless/WorkspaceList.js";
+export { Members } from "./headless/Members.js";
+export type { MembersBag } from "./headless/Members.js";
+export { AcceptInvitation } from "./headless/AcceptInvitation.js";
+export type { AcceptInvitationBag } from "./headless/AcceptInvitation.js";
+
+// ── i18n ─────────────────────────────────────────────────────────────────────
+export {
+  WORKSPACES_I18N_KEYS,
+  workspacesI18nBundleEn,
+  registerWorkspacesI18n,
+} from "./i18n/keys.js";
+export type { WorkspacesI18nKey } from "./i18n/keys.js";
+
+// ── errors map (code → status/params/remediation/en; generated) ──────────────
+export {
+  WORKSPACES_ERRORS,
+  WORKSPACES_ERROR_CODES,
+  workspacesErrorBundleEn,
+  explainWorkspacesError,
+} from "./i18n/errorsMap.js";
+export type {
+  WorkspacesErrorCode,
+  WorkspacesErrorSpec,
+  Remediation,
+} from "./i18n/errorsMap.js";

package/src/model/context.tsx

@@ -0,0 +1,29 @@
+import { createContext, useContext } from "react";
+import type { Context } from "react";
+import type { Analytics } from "@stapel/core";
+import type { WorkspacesApi } from "../api/workspacesApi.js";
+import type { WorkspacesRuntime } from "./runtime.js";
+
+/**
+ * The wired WorkspacesRuntime shared through React context by
+ * `<WorkspacesProvider>`. Hooks in `model/` and `headless/` read the singletons
+ * from here.
+ */
+export const WorkspacesRuntimeContext: Context<WorkspacesRuntime | null> =
+  createContext<WorkspacesRuntime | null>(null);
+
+export function useWorkspacesRuntime(): WorkspacesRuntime {
+  const runtime = useContext(WorkspacesRuntimeContext);
+  if (runtime === null) {
+    throw new Error("Workspaces hooks must be used within a <WorkspacesProvider>");
+  }
+  return runtime;
+}
+
+export function useWorkspacesApi(): WorkspacesApi {
+  return useWorkspacesRuntime().api;
+}
+
+export function useWorkspacesAnalytics(): Analytics | null {
+  return useWorkspacesRuntime().analytics;
+}

package/src/model/mutations.ts

@@ -0,0 +1,196 @@
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import type {
+  UseMutationOptions,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import type { StapelApiError } from "@stapel/core";
+import type {
+  Member,
+  MemberInvite,
+  MemberInviteResult,
+  InvitationAccept,
+  Workspace,
+  WorkspaceCreate,
+  WorkspaceRole,
+  WorkspaceUpdate,
+} from "../api/types.js";
+import { useWorkspacesApi } from "./context.js";
+import { workspacesQueryKeys } from "./queryKeys.js";
+
+/**
+ * Write hooks (frontend-standard §2 — "мутации с инвалидацией"). Each mutation
+ * invalidates exactly the server state it can move. Membership and ownership are
+ * server truth (roles gate access in other services via the membership cache),
+ * so NONE of these are optimistic (frontend-core-architecture §2.6: optimistic
+ * is for local-echo UX, never for flows with server truth).
+ *
+ * Options are built as typed `UseMutationOptions` objects (not call-site
+ * generics) so `void` stays in type-reference position, which
+ * `no-invalid-void-type` permits. Hooks that act on one workspace take its id as
+ * a parameter (the mutation variable then carries only the payload).
+ */
+
+/** Create a workspace (owner-seeded) — refreshes the workspace list. */
+export function useCreateWorkspace(): UseMutationResult<
+  Workspace,
+  StapelApiError,
+  WorkspaceCreate
+> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<Workspace, StapelApiError, WorkspaceCreate> =
+    {
+      mutationFn: (body) => api.createWorkspace(body),
+      onSuccess: () => {
+        void queryClient.invalidateQueries({
+          queryKey: workspacesQueryKeys.list(),
+        });
+      },
+    };
+  return useMutation(options);
+}
+
+/**
+ * Partially update a workspace — writes the fresh row into its detail cache and
+ * refreshes the list (name / slug may have changed there too).
+ */
+export function useUpdateWorkspace(
+  workspaceId: string
+): UseMutationResult<Workspace, StapelApiError, WorkspaceUpdate> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<Workspace, StapelApiError, WorkspaceUpdate> =
+    {
+      mutationFn: (patch) => api.updateWorkspace(workspaceId, patch),
+      onSuccess: (updated) => {
+        queryClient.setQueryData(
+          workspacesQueryKeys.detail(workspaceId),
+          updated
+        );
+        void queryClient.invalidateQueries({
+          queryKey: workspacesQueryKeys.list(),
+        });
+      },
+    };
+  return useMutation(options);
+}
+
+/** Soft-delete a workspace (owner only) — drops its detail cache + refreshes the list. */
+export function useDeleteWorkspace(): UseMutationResult<
+  void,
+  StapelApiError,
+  string
+> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<void, StapelApiError, string> = {
+    mutationFn: (workspaceId) => api.deleteWorkspace(workspaceId),
+    onSuccess: (_result, workspaceId) => {
+      queryClient.removeQueries({
+        queryKey: workspacesQueryKeys.detail(workspaceId),
+      });
+      void queryClient.invalidateQueries({
+        queryKey: workspacesQueryKeys.list(),
+      });
+    },
+  };
+  return useMutation(options);
+}
+
+/**
+ * Invite one or more emails to a workspace (admin+). Server truth — no optimism.
+ * A bad role or missing email surfaces as a localizable `StapelApiError`
+ * (`error.400.invalid_role`). Refreshes the member list (pending invites show
+ * there).
+ */
+export function useInviteMembers(
+  workspaceId: string
+): UseMutationResult<MemberInviteResult, StapelApiError, MemberInvite> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<
+    MemberInviteResult,
+    StapelApiError,
+    MemberInvite
+  > = {
+    mutationFn: (body) => api.inviteMembers(workspaceId, body),
+    onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: workspacesQueryKeys.members(workspaceId),
+      });
+    },
+  };
+  return useMutation(options);
+}
+
+/** The variable for {@link useUpdateMemberRole}: which member, which new role. */
+export interface MemberRoleChange {
+  readonly userId: string;
+  readonly role: WorkspaceRole;
+}
+
+/**
+ * Change a member's role (admin+; the backend guards owner grants and the
+ * last-owner invariant, surfacing `error.403.last_owner_cannot_be_removed`).
+ * Refreshes the member list.
+ */
+export function useUpdateMemberRole(
+  workspaceId: string
+): UseMutationResult<Member, StapelApiError, MemberRoleChange> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<Member, StapelApiError, MemberRoleChange> = {
+    mutationFn: ({ userId, role }) =>
+      api.updateMemberRole(workspaceId, userId, { role }),
+    onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: workspacesQueryKeys.members(workspaceId),
+      });
+    },
+  };
+  return useMutation(options);
+}
+
+/**
+ * Remove a member (admin+; the last owner is protected by the backend). The
+ * variable is the member's `userId`. Refreshes the member list.
+ */
+export function useRemoveMember(
+  workspaceId: string
+): UseMutationResult<void, StapelApiError, string> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<void, StapelApiError, string> = {
+    mutationFn: (userId) => api.removeMember(workspaceId, userId),
+    onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: workspacesQueryKeys.members(workspaceId),
+      });
+    },
+  };
+  return useMutation(options);
+}
+
+/**
+ * Accept an invitation by its token — the caller joins the workspace. A dead
+ * token surfaces a localizable `StapelApiError` (`error.400.invitation_expired`
+ * / `error.400.invitation_revoked` / `error.400.invitation_already_used`).
+ * Refreshes the workspace list (the new membership appears there).
+ */
+export function useAcceptInvitation(): UseMutationResult<
+  Member,
+  StapelApiError,
+  InvitationAccept
+> {
+  const api = useWorkspacesApi();
+  const queryClient = useQueryClient();
+  const options: UseMutationOptions<Member, StapelApiError, InvitationAccept> = {
+    mutationFn: (body) => api.acceptInvitation(body),
+    onSuccess: () => {
+      void queryClient.invalidateQueries({
+        queryKey: workspacesQueryKeys.list(),
+      });
+    },
+  };
+  return useMutation(options);
+}

package/src/model/queries.ts

@@ -0,0 +1,51 @@
+import { useQuery } from "@tanstack/react-query";
+import type { UseQueryResult } from "@tanstack/react-query";
+import type { StapelApiError } from "@stapel/core";
+import type { MemberList, Workspace, WorkspaceList } from "../api/types.js";
+import { useWorkspacesApi } from "./context.js";
+import { workspacesQueryKeys } from "./queryKeys.js";
+
+/**
+ * Read hooks over the workspaces API. Staleness follows core's query defaults;
+ * override per call site via a page that needs fresher data. Keys are
+ * namespaced (see `workspacesQueryKeys`).
+ */
+
+/** The caller's workspaces — their accepted memberships (GET /). */
+export function useWorkspaces(): UseQueryResult<WorkspaceList, StapelApiError> {
+  const api = useWorkspacesApi();
+  return useQuery({
+    queryKey: workspacesQueryKeys.list(),
+    queryFn: () => api.listWorkspaces(),
+  });
+}
+
+/**
+ * A single workspace by id (GET /{id}). Disabled until a `workspaceId` is
+ * given, so a detail hook can mount before a selection exists.
+ */
+export function useWorkspace(
+  workspaceId: string | null
+): UseQueryResult<Workspace, StapelApiError> {
+  const api = useWorkspacesApi();
+  return useQuery({
+    queryKey: workspacesQueryKeys.detail(workspaceId ?? ""),
+    queryFn: () => api.getWorkspace(workspaceId as string),
+    enabled: workspaceId !== null && workspaceId !== "",
+  });
+}
+
+/**
+ * A workspace's members (GET /{id}/members). Disabled until a `workspaceId` is
+ * given.
+ */
+export function useMembers(
+  workspaceId: string | null
+): UseQueryResult<MemberList, StapelApiError> {
+  const api = useWorkspacesApi();
+  return useQuery({
+    queryKey: workspacesQueryKeys.members(workspaceId ?? ""),
+    queryFn: () => api.listMembers(workspaceId as string),
+    enabled: workspaceId !== null && workspaceId !== "",
+  });
+}

package/src/model/queryKeys.ts

@@ -0,0 +1,20 @@
+/**
+ * Namespaced TanStack Query keys (frontend-standard §2 — "ключи неймспейснуты").
+ * Everything under the `"workspaces"` root so a host can invalidate the whole
+ * module or match a single resource. Persist scope is per-user via core's query
+ * runtime (`setPersistUser`). Explicit tuple return types satisfy
+ * `--isolatedDeclarations`. One entry per read-operation.
+ */
+const ROOT = "workspaces" as const;
+
+export const workspacesQueryKeys: {
+  readonly all: readonly ["workspaces"];
+  list(): readonly ["workspaces", "list"];
+  detail(workspaceId: string): readonly ["workspaces", "detail", string];
+  members(workspaceId: string): readonly ["workspaces", "members", string];
+} = {
+  all: [ROOT],
+  list: () => [ROOT, "list"],
+  detail: (workspaceId) => [ROOT, "detail", workspaceId],
+  members: (workspaceId) => [ROOT, "members", workspaceId],
+};

package/src/model/runtime.ts

@@ -0,0 +1,46 @@
+import { createStapelClient } from "@stapel/core";
+import type { Analytics, StapelClient } from "@stapel/core";
+import { createWorkspacesApi } from "../api/workspacesApi.js";
+import type { WorkspacesApi } from "../api/workspacesApi.js";
+
+/**
+ * The wired workspaces runtime — builds a {@link StapelClient} and the pair's
+ * API over it. The returned `client` is what the host injects into core's
+ * `StapelConfigProvider` (as the default or the `"workspaces"` module client),
+ * preserving the client-injection fork seam (frontend-standard §7.2). Auth
+ * token/refresh and the verification-403 seam are supplied by the host's auth
+ * runtime on the shared client — this pair does not re-implement them.
+ */
+export interface WorkspacesRuntime {
+  readonly client: StapelClient;
+  readonly api: WorkspacesApi;
+  readonly analytics: Analytics | null;
+}
+
+export interface CreateWorkspacesRuntimeOptions {
+  /** e.g. `/workspaces/api/` or `https://app.example.com/workspaces/api/`. */
+  readonly baseUrl: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly credentials?: RequestCredentials;
+  readonly analytics?: Analytics | null;
+  /** Extra headers merged into every request (e.g. a tenant id). */
+  readonly defaultHeaders?: Record<string, string>;
+}
+
+export function createWorkspacesRuntime(
+  options: CreateWorkspacesRuntimeOptions
+): WorkspacesRuntime {
+  const analytics = options.analytics ?? null;
+  const client = createStapelClient({
+    baseUrl: options.baseUrl,
+    ...(options.fetch !== undefined ? { fetch: options.fetch } : {}),
+    ...(options.credentials !== undefined
+      ? { credentials: options.credentials }
+      : {}),
+    ...(options.defaultHeaders !== undefined
+      ? { defaultHeaders: options.defaultHeaders }
+      : {}),
+  });
+  const api = createWorkspacesApi(client);
+  return { client, api, analytics };
+}

package/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "_comment": "Self-contained on purpose: standalone-buildable per frontend-standard §7. Mirrors the root tsconfig.base.json settings.",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "exactOptionalPropertyTypes": true,
+    "isolatedModules": true,
+    "isolatedDeclarations": true,
+    "verbatimModuleSyntax": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}