@stapel/workspaces-react 0.1.0

package/dist/model/context.d.ts

@@ -0,0 +1,14 @@
+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 declare const WorkspacesRuntimeContext: Context<WorkspacesRuntime | null>;
+export declare function useWorkspacesRuntime(): WorkspacesRuntime;
+export declare function useWorkspacesApi(): WorkspacesApi;
+export declare function useWorkspacesAnalytics(): Analytics | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/model/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CACxB,CAAC;AAEhD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAMxD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,sBAAsB,IAAI,SAAS,GAAG,IAAI,CAEzD"}

package/dist/model/context.js

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

package/dist/model/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAMlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,aAAa,CAA2B,IAAI,CAAC,CAAC;AAEhD,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,oBAAoB,EAAE,CAAC,SAAS,CAAC;AAC1C,CAAC"}

package/dist/model/mutations.d.ts

@@ -0,0 +1,55 @@
+import type { 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";
+/**
+ * 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 declare function useCreateWorkspace(): UseMutationResult<Workspace, StapelApiError, WorkspaceCreate>;
+/**
+ * Partially update a workspace — writes the fresh row into its detail cache and
+ * refreshes the list (name / slug may have changed there too).
+ */
+export declare function useUpdateWorkspace(workspaceId: string): UseMutationResult<Workspace, StapelApiError, WorkspaceUpdate>;
+/** Soft-delete a workspace (owner only) — drops its detail cache + refreshes the list. */
+export declare function useDeleteWorkspace(): UseMutationResult<void, StapelApiError, string>;
+/**
+ * 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 declare function useInviteMembers(workspaceId: string): UseMutationResult<MemberInviteResult, StapelApiError, MemberInvite>;
+/** 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 declare function useUpdateMemberRole(workspaceId: string): UseMutationResult<Member, StapelApiError, MemberRoleChange>;
+/**
+ * Remove a member (admin+; the last owner is protected by the backend). The
+ * variable is the member's `userId`. Refreshes the member list.
+ */
+export declare function useRemoveMember(workspaceId: string): UseMutationResult<void, StapelApiError, string>;
+/**
+ * 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 declare function useAcceptInvitation(): UseMutationResult<Member, StapelApiError, InvitationAccept>;
+//# sourceMappingURL=mutations.d.ts.map

package/dist/model/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/model/mutations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,aAAa,EACb,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAIzB;;;;;;;;;;;GAWG;AAEH,wEAAwE;AACxE,wBAAgB,kBAAkB,IAAI,iBAAiB,CACrD,SAAS,EACT,cAAc,EACd,eAAe,CAChB,CAaA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,eAAe,CAAC,CAiB/D;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,IAAI,iBAAiB,CACrD,IAAI,EACJ,cAAc,EACd,MAAM,CACP,CAeA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAAC,kBAAkB,EAAE,cAAc,EAAE,YAAY,CAAC,CAgBrE;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAa7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,CAYjD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CACtD,MAAM,EACN,cAAc,EACd,gBAAgB,CACjB,CAYA"}

package/dist/model/mutations.js

@@ -0,0 +1,138 @@
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+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() {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        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) {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        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() {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        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) {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        mutationFn: (body) => api.inviteMembers(workspaceId, body),
+        onSuccess: () => {
+            void queryClient.invalidateQueries({
+                queryKey: workspacesQueryKeys.members(workspaceId),
+            });
+        },
+    };
+    return useMutation(options);
+}
+/**
+ * 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) {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        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) {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        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() {
+    const api = useWorkspacesApi();
+    const queryClient = useQueryClient();
+    const options = {
+        mutationFn: (body) => api.acceptInvitation(body),
+        onSuccess: () => {
+            void queryClient.invalidateQueries({
+                queryKey: workspacesQueryKeys.list(),
+            });
+        },
+    };
+    return useMutation(options);
+}
+//# sourceMappingURL=mutations.js.map

package/dist/model/mutations.js.map

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

package/dist/model/queries.d.ts

@@ -0,0 +1,21 @@
+import type { UseQueryResult } from "@tanstack/react-query";
+import type { StapelApiError } from "@stapel/core";
+import type { MemberList, Workspace, WorkspaceList } from "../api/types.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 declare function useWorkspaces(): UseQueryResult<WorkspaceList, StapelApiError>;
+/**
+ * A single workspace by id (GET /{id}). Disabled until a `workspaceId` is
+ * given, so a detail hook can mount before a selection exists.
+ */
+export declare function useWorkspace(workspaceId: string | null): UseQueryResult<Workspace, StapelApiError>;
+/**
+ * A workspace's members (GET /{id}/members). Disabled until a `workspaceId` is
+ * given.
+ */
+export declare function useMembers(workspaceId: string | null): UseQueryResult<MemberList, StapelApiError>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/model/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/model/queries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI5E;;;;GAIG;AAEH,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAM7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAO3C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,CAO5C"}

package/dist/model/queries.js

@@ -0,0 +1,41 @@
+import { useQuery } from "@tanstack/react-query";
+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() {
+    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) {
+    const api = useWorkspacesApi();
+    return useQuery({
+        queryKey: workspacesQueryKeys.detail(workspaceId ?? ""),
+        queryFn: () => api.getWorkspace(workspaceId),
+        enabled: workspaceId !== null && workspaceId !== "",
+    });
+}
+/**
+ * A workspace's members (GET /{id}/members). Disabled until a `workspaceId` is
+ * given.
+ */
+export function useMembers(workspaceId) {
+    const api = useWorkspacesApi();
+    return useQuery({
+        queryKey: workspacesQueryKeys.members(workspaceId ?? ""),
+        queryFn: () => api.listMembers(workspaceId),
+        enabled: workspaceId !== null && workspaceId !== "",
+    });
+}
+//# sourceMappingURL=queries.js.map

package/dist/model/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/model/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;GAIG;AAEH,oEAAoE;AACpE,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,mBAAmB,CAAC,IAAI,EAAE;QACpC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,WAA0B;IAE1B,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QACvD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,WAAqB,CAAC;QACtD,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,WAA0B;IAE1B,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QACxD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,WAAqB,CAAC;QACrD,OAAO,EAAE,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,EAAE;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/model/queryKeys.d.ts

@@ -0,0 +1,7 @@
+export declare const workspacesQueryKeys: {
+    readonly all: readonly ["workspaces"];
+    list(): readonly ["workspaces", "list"];
+    detail(workspaceId: string): readonly ["workspaces", "detail", string];
+    members(workspaceId: string): readonly ["workspaces", "members", string];
+};
+//# sourceMappingURL=queryKeys.d.ts.map

package/dist/model/queryKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../src/model/queryKeys.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,mBAAmB,EAAE;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,IAAI,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;CAM1E,CAAC"}

package/dist/model/queryKeys.js

@@ -0,0 +1,15 @@
+/**
+ * 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";
+export const workspacesQueryKeys = {
+    all: [ROOT],
+    list: () => [ROOT, "list"],
+    detail: (workspaceId) => [ROOT, "detail", workspaceId],
+    members: (workspaceId) => [ROOT, "members", workspaceId],
+};
+//# sourceMappingURL=queryKeys.js.map

package/dist/model/queryKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.js","sourceRoot":"","sources":["../../src/model/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,IAAI,GAAG,YAAqB,CAAC;AAEnC,MAAM,CAAC,MAAM,mBAAmB,GAK5B;IACF,GAAG,EAAE,CAAC,IAAI,CAAC;IACX,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC;IACtD,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC;CACzD,CAAC"}

package/dist/model/runtime.d.ts

@@ -0,0 +1,26 @@
+import type { Analytics, StapelClient } from "@stapel/core";
+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 declare function createWorkspacesRuntime(options: CreateWorkspacesRuntimeOptions): WorkspacesRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/model/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/model/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,8BAA8B;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,iBAAiB,CAcnB"}

package/dist/model/runtime.js

@@ -0,0 +1,18 @@
+import { createStapelClient } from "@stapel/core";
+import { createWorkspacesApi } from "../api/workspacesApi.js";
+export function createWorkspacesRuntime(options) {
+    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 };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/model/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/model/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AA2B9D,MAAM,UAAU,uBAAuB,CACrC,OAAuC;IAEvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC"}

package/llms.txt

@@ -0,0 +1,95 @@
+# @stapel/workspaces-react 0.1.0
+
+Headless React flow pair for stapel-workspaces (contract >=0.3 <0.4) — business + state, zero visual opinion.
+Built on @stapel/core: typed client + StapelApiError envelope, auth token refresh,
+verification-403 interception, i18n engine, analytics facade, TanStack Query layer.
+
+## The one right way (do this, the rest is a review/lint smell)
+- No raw fetch/axios. The client is injected via <WorkspacesProvider>/StapelConfigProvider;
+  every hook and flow already carries auth, refresh, and the error envelope.
+- Render errors, never try/catch them: a flow's state carries FlowError{code,params};
+  render `t(code, params)` and branch on `explainWorkspacesError(code)` remediation.
+- Server state = the use* hooks (query layer); keys come only from workspacesQueryKeys.
+- User strings = i18n keys (registerWorkspacesI18n); never string literals.
+- Sign-in UI = a headless flow component; copy it (shadcn-style) to restyle.
+
+## Layers
+api (typed client) · model (hooks, session) · flows (machines) · headless · i18n
+
+## Documented flows (flows.json — canonical id, steps, endpoints)
+
+## Operations (typed; use the named op, never a path string)
+Request/response schema names are in manifest.json + the generated types.
+- workspaces_api_create: POST /workspaces/api/
+- workspaces_api_destroy: DELETE /workspaces/api/{workspace_id}
+- workspaces_api_internal_members_retrieve: GET /workspaces/api/internal/{workspace_id}/members/{user_id}
+- workspaces_api_internal_users_personal_create: POST /workspaces/api/internal/users/{user_id}/personal
+- workspaces_api_invitations_accept_create: POST /workspaces/api/invitations/accept
+- workspaces_api_members_destroy: DELETE /workspaces/api/{workspace_id}/members/{user_id}
+- workspaces_api_members_invite_create: POST /workspaces/api/{workspace_id}/members/invite
+- workspaces_api_members_partial_update: PATCH /workspaces/api/{workspace_id}/members/{user_id}
+- workspaces_api_members_retrieve: GET /workspaces/api/{workspace_id}/members
+- workspaces_api_partial_update: PATCH /workspaces/api/{workspace_id}
+- workspaces_api_retrieve: GET /workspaces/api/
+- workspaces_api_retrieve_2: GET /workspaces/api/{workspace_id}
+
+## Query hooks (server state; keys come only from the key factory)
+- useAcceptInvitation (mutation) → acceptInvitation
+- useCreateWorkspace (mutation) → createWorkspace
+- useDeleteWorkspace (mutation) → deleteWorkspace
+- useInviteMembers (mutation) → inviteMembers
+- useMembers (query) → listMembers
+- useRemoveMember (mutation) → removeMember
+- useUpdateMemberRole (mutation) → updateMemberRole
+- useUpdateWorkspace (mutation) → updateWorkspace
+- useWorkspace (query) → getWorkspace
+- useWorkspaces (query) → listWorkspaces
+
+## Errors (render t(code, params); UX from remediation)
+52 keys (full catalog: manifest.json §errors). By remediation: fix_input 24 · retry 12 · contact_support 5 · verify 5 · wait_and_retry 5 · reauthenticate 1.
+Param-bearing keys (interpolation slots matter):
+- error.400.field.blank [400] → fix_input {field}
+- error.400.field.does_not_exist [400] → fix_input {field}
+- error.400.field.invalid [400] → fix_input {field}
+- error.400.field.invalid_choice [400] → fix_input {field}
+- error.400.field.max_length [400] → fix_input {field,max_length}
+- error.400.field.max_value [400] → fix_input {field,max_value}
+- error.400.field.min_length [400] → fix_input {field,min_length}
+- error.400.field.min_value [400] → fix_input {field,min_value}
+- error.400.field.null [400] → fix_input {field}
+- error.400.field.required [400] → fix_input {field}
+- error.400.field.unique [400] → fix_input {field}
+- error.429.rate_limit [429] → wait_and_retry {retry_after_minutes}
+
+## Analytics events (typed; defineEvent → events.json, drift-gated)
+- (no app defineEvent() in this pair — its analytic events are the
+  auto-instrumented flow funnels below)
+
+## Flow funnels (auto-instrumented: flow.<id>.<step> {phase})
+
+```tsx
+// Typed event + tracked() click (the one right way; §3.1).
+const planSelected = defineEvent({
+  name: "pricing.plan.selected",
+  description: "User picked a plan",
+  props: { plan: prop.oneOf(["free", "pro", "team"], "Plan code") },
+});
+const { tracked } = useTracked();
+<Button onClick={tracked(planSelected, { plan }, startCheckout)} />
+// A click that STEPS a flow machine is already instrumented — mark it
+// data-analytics="flow" instead; tracked() on top double-counts (§3.2).
+```
+
+## Demos (defineDemo → manifest.demos; compiled, linted, rendered examples)
+- workspaces.accept → <AcceptInvitation> [default]  demo/AcceptInvitation.demo.tsx
+- workspaces.list → <WorkspaceList> [default]  demo/WorkspaceList.demo.tsx
+- workspaces.members → <Members> [default]  demo/Members.demo.tsx
+- workspaces.provider → <WorkspacesProvider> [default]  demo/Workspaces.demo.tsx
+Each source file is the canonical usage snippet (open the default variant).
+
+## Snippets
+```tsx
+// Error rendering + remediation branch (one pattern for every pair).
+const r = explainWorkspacesError(err.code); // 'wait_and_retry' | 'verify' | ...
+return <Alert action={r}>{t(err.code, err.params)}</Alert>;
+```