@timeax/digital-service-engine 0.3.2 → 0.3.3

package/dist/react/index.d.cts

@@ -1042,12 +1042,6 @@ type BackendResult<T> = {
     error: BackendError;
 };
 type Result<T> = Promise<BackendResult<T>>;
-interface Actor {
-    readonly id: string;
-    readonly name?: string;
-    readonly roles?: readonly string[];
-    readonly meta?: Readonly<Record<string, unknown>>;
-}
 interface Author {
     readonly id: string;
     readonly name: string;
@@ -1072,12 +1066,26 @@ interface MergeResult {
     readonly conflicts?: number;
     readonly message?: string;
 }
+type WorkspaceLoadContext = Readonly<{
+    workspaceId: string;
+    actorId?: string;
+    branchId?: string;
+    since?: string | number;
+}>;
+type WorkspaceActorLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+}>;
+type WorkspaceBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    branchId: string;
+}>;
+type WorkspaceActorBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+    branchId: string;
+}>;
 type ServicesInput = readonly DgpServiceCapability[] | DgpServiceMap;
 interface ServicesBackend {
-    get(workspaceId: string): Result<ServicesInput>;
-    refresh(workspaceId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<ServicesInput>;
+    get(ctx: WorkspaceLoadContext): Result<ServicesInput>;
+    refresh(ctx: WorkspaceLoadContext): Result<ServicesInput>;
 }
 interface BranchParticipant {
     readonly id: string;
@@ -1094,10 +1102,8 @@ interface BranchParticipant {
     readonly updatedAt?: string;
 }
 interface BranchAccessBackend {
-    listParticipants(workspaceId: string, branchId: string): Result<readonly BranchParticipant[]>;
-    refreshParticipants(workspaceId: string, branchId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<readonly BranchParticipant[]>;
+    listParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
+    refreshParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
 }
 interface ServiceSnapshot {
     readonly schema_version: string;
@@ -1211,12 +1217,13 @@ interface FieldTemplate {
 }
 /** Narrow list/search input */
 interface TemplatesListParams {
-    readonly workspaceId: string;
-    readonly branchId?: string;
+    readonly workspaceId: WorkspaceLoadContext["workspaceId"];
+    readonly actorId?: WorkspaceLoadContext["actorId"];
+    readonly branchId?: WorkspaceLoadContext["branchId"];
     readonly q?: string;
     readonly tags?: readonly string[];
     readonly category?: string;
-    readonly since?: string | number;
+    readonly since?: WorkspaceLoadContext["since"];
 }
 interface TemplateCreateInput {
     readonly key?: string;
@@ -1264,23 +1271,23 @@ interface TemplatesBackend {
     refresh(params: Omit<TemplatesListParams, "q" | "tags" | "category">): Result<readonly FieldTemplate[]>;
 }
 interface AuthorsBackend {
-    list(workspaceId: string): Result<readonly Author[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
     get(authorId: string): Result<Author | null>;
-    refresh(workspaceId: string): Result<readonly Author[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
 }
 interface PermissionsBackend {
-    get(workspaceId: string, actor: Actor): Result<PermissionsMap>;
-    refresh(workspaceId: string, actor: Actor): Result<PermissionsMap>;
+    get(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
+    refresh(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
 }
 interface BranchesBackend {
-    list(workspaceId: string): Result<readonly Branch[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
     create(workspaceId: string, name: string, opts?: Readonly<{
         fromId?: string;
     }>): Result<Branch>;
     setMain(workspaceId: string, branchId: string): Result<Branch>;
     merge(workspaceId: string, sourceId: string, targetId: string): Result<MergeResult>;
     delete(workspaceId: string, branchId: string): Result<void>;
-    refresh(workspaceId: string): Result<readonly Branch[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
 }
 interface WorkspaceInfo {
     readonly id: string;
@@ -1295,10 +1302,7 @@ interface WorkspaceInfo {
  * This is intentionally transport-agnostic and minimal so other layers (e.g. canvas/comments)
  * can reuse it without redefining identity types.
  */
-interface BackendScope {
-    readonly workspaceId: string;
-    readonly actorId: string;
-    readonly branchId: string;
+interface BackendScope extends WorkspaceActorBranchLoadContext {
 }
 /**
  * Generic canvas comments backend contract.
@@ -1349,7 +1353,7 @@ interface CommentsBackend<ThreadDTO = unknown, MessageDTO = unknown, AnchorDTO =
  * - If branchId is provided -> branch-scoped policies
  * - If branchId is omitted  -> workspace-scoped policies
  */
-interface PolicyScope extends BackendScope {
+interface PolicyScope extends WorkspaceActorLoadContext {
 }
 interface PoliciesLoadResult {
     /** the raw JSON the host stored (authoring format) */

package/dist/react/index.d.ts

@@ -1042,12 +1042,6 @@ type BackendResult<T> = {
     error: BackendError;
 };
 type Result<T> = Promise<BackendResult<T>>;
-interface Actor {
-    readonly id: string;
-    readonly name?: string;
-    readonly roles?: readonly string[];
-    readonly meta?: Readonly<Record<string, unknown>>;
-}
 interface Author {
     readonly id: string;
     readonly name: string;
@@ -1072,12 +1066,26 @@ interface MergeResult {
     readonly conflicts?: number;
     readonly message?: string;
 }
+type WorkspaceLoadContext = Readonly<{
+    workspaceId: string;
+    actorId?: string;
+    branchId?: string;
+    since?: string | number;
+}>;
+type WorkspaceActorLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+}>;
+type WorkspaceBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    branchId: string;
+}>;
+type WorkspaceActorBranchLoadContext = WorkspaceLoadContext & Readonly<{
+    actorId: string;
+    branchId: string;
+}>;
 type ServicesInput = readonly DgpServiceCapability[] | DgpServiceMap;
 interface ServicesBackend {
-    get(workspaceId: string): Result<ServicesInput>;
-    refresh(workspaceId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<ServicesInput>;
+    get(ctx: WorkspaceLoadContext): Result<ServicesInput>;
+    refresh(ctx: WorkspaceLoadContext): Result<ServicesInput>;
 }
 interface BranchParticipant {
     readonly id: string;
@@ -1094,10 +1102,8 @@ interface BranchParticipant {
     readonly updatedAt?: string;
 }
 interface BranchAccessBackend {
-    listParticipants(workspaceId: string, branchId: string): Result<readonly BranchParticipant[]>;
-    refreshParticipants(workspaceId: string, branchId: string, params?: Readonly<{
-        since?: number | string;
-    }>): Result<readonly BranchParticipant[]>;
+    listParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
+    refreshParticipants(ctx: WorkspaceBranchLoadContext): Result<readonly BranchParticipant[]>;
 }
 interface ServiceSnapshot {
     readonly schema_version: string;
@@ -1211,12 +1217,13 @@ interface FieldTemplate {
 }
 /** Narrow list/search input */
 interface TemplatesListParams {
-    readonly workspaceId: string;
-    readonly branchId?: string;
+    readonly workspaceId: WorkspaceLoadContext["workspaceId"];
+    readonly actorId?: WorkspaceLoadContext["actorId"];
+    readonly branchId?: WorkspaceLoadContext["branchId"];
     readonly q?: string;
     readonly tags?: readonly string[];
     readonly category?: string;
-    readonly since?: string | number;
+    readonly since?: WorkspaceLoadContext["since"];
 }
 interface TemplateCreateInput {
     readonly key?: string;
@@ -1264,23 +1271,23 @@ interface TemplatesBackend {
     refresh(params: Omit<TemplatesListParams, "q" | "tags" | "category">): Result<readonly FieldTemplate[]>;
 }
 interface AuthorsBackend {
-    list(workspaceId: string): Result<readonly Author[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
     get(authorId: string): Result<Author | null>;
-    refresh(workspaceId: string): Result<readonly Author[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Author[]>;
 }
 interface PermissionsBackend {
-    get(workspaceId: string, actor: Actor): Result<PermissionsMap>;
-    refresh(workspaceId: string, actor: Actor): Result<PermissionsMap>;
+    get(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
+    refresh(ctx: WorkspaceActorLoadContext): Result<PermissionsMap>;
 }
 interface BranchesBackend {
-    list(workspaceId: string): Result<readonly Branch[]>;
+    list(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
     create(workspaceId: string, name: string, opts?: Readonly<{
         fromId?: string;
     }>): Result<Branch>;
     setMain(workspaceId: string, branchId: string): Result<Branch>;
     merge(workspaceId: string, sourceId: string, targetId: string): Result<MergeResult>;
     delete(workspaceId: string, branchId: string): Result<void>;
-    refresh(workspaceId: string): Result<readonly Branch[]>;
+    refresh(ctx: WorkspaceLoadContext): Result<readonly Branch[]>;
 }
 interface WorkspaceInfo {
     readonly id: string;
@@ -1295,10 +1302,7 @@ interface WorkspaceInfo {
  * This is intentionally transport-agnostic and minimal so other layers (e.g. canvas/comments)
  * can reuse it without redefining identity types.
  */
-interface BackendScope {
-    readonly workspaceId: string;
-    readonly actorId: string;
-    readonly branchId: string;
+interface BackendScope extends WorkspaceActorBranchLoadContext {
 }
 /**
  * Generic canvas comments backend contract.
@@ -1349,7 +1353,7 @@ interface CommentsBackend<ThreadDTO = unknown, MessageDTO = unknown, AnchorDTO =
  * - If branchId is provided -> branch-scoped policies
  * - If branchId is omitted  -> workspace-scoped policies
  */
-interface PolicyScope extends BackendScope {
+interface PolicyScope extends WorkspaceActorLoadContext {
 }
 interface PoliciesLoadResult {
     /** the raw JSON the host stored (authoring format) */