@kernhq/module-tracker 0.1.0

package/dist/server/services/config.d.ts

@@ -0,0 +1,130 @@
+import type { Principal } from '@kernhq/contracts';
+import { type Kernel, type Tx } from '@kernhq/kernel';
+import { type WorkflowDefinition } from '@kernhq/workflow';
+import type { z } from 'zod';
+import { type FieldDef, type FieldScheme, HierarchyRules, type StatusInfo, type TypeScheme, type UpsertFieldDef, type UpsertWorkflow, type UpsertWorkflowScheme as UpsertWorkflowSchemeSchema, type UpsertWorkItemType, type Workflow, type WorkflowScheme, type WorkItemType } from '../../contract/models.js';
+import type { AccessService } from './access.js';
+import { type FieldDefRow, type ProjectRow, type WorkflowRow, type WorkItemTypeRow } from './db.js';
+import type { NotifyService } from './notify.js';
+type UpsertWorkflowScheme = z.infer<typeof UpsertWorkflowSchemeSchema>;
+/** Work item types, custom fields, workflows and the schemes that bind them to projects. */
+export declare class ConfigService {
+    private readonly kernel;
+    private readonly access;
+    private readonly notify;
+    constructor(kernel: Kernel, access: AccessService, notify: NotifyService);
+    /** Configuration is cached hard in the client, so every change has to be announced. */
+    private announce;
+    listTypes(tx: Tx, workspaceId: string, opts?: {
+        projectId?: string;
+        includeArchived?: boolean;
+    }): Promise<WorkItemTypeRow[]>;
+    private typeSchemeFor;
+    getType(tx: Tx, workspaceId: string, id: string): Promise<WorkItemTypeRow>;
+    /** The type new issues get when the caller does not name one. */
+    defaultType(tx: Tx, workspaceId: string, projectId: string): Promise<WorkItemTypeRow>;
+    createType(tx: Tx, workspaceId: string, input: UpsertWorkItemType, actorId: string | null): Promise<WorkItemType>;
+    updateType(tx: Tx, workspaceId: string, id: string, patch: Partial<UpsertWorkItemType>): Promise<WorkItemType>;
+    archiveType(tx: Tx, workspaceId: string, id: string, archived: boolean): Promise<WorkItemType>;
+    private assertTypeKeyFree;
+    private clearDefaultType;
+    hierarchyRules(tx: Tx, workspaceId: string): Promise<HierarchyRules>;
+    setHierarchyRules(tx: Tx, workspaceId: string, rules: HierarchyRules): Promise<HierarchyRules>;
+    listTypeSchemes(tx: Tx, workspaceId: string): Promise<TypeScheme[]>;
+    createTypeScheme(tx: Tx, workspaceId: string, input: {
+        name: string;
+        typeIds: string[];
+        defaultTypeId?: string | null;
+    }): Promise<TypeScheme>;
+    updateTypeScheme(tx: Tx, workspaceId: string, id: string, patch: {
+        name?: string;
+        typeIds?: string[];
+        defaultTypeId?: string | null;
+    }): Promise<TypeScheme>;
+    deleteTypeScheme(tx: Tx, workspaceId: string, id: string): Promise<void>;
+    listFieldRows(tx: Tx, workspaceId: string, opts?: {
+        projectId?: string;
+        includeArchived?: boolean;
+    }): Promise<FieldDefRow[]>;
+    listFields(tx: Tx, workspaceId: string, opts?: {
+        projectId?: string;
+        includeArchived?: boolean;
+    }): Promise<FieldDef[]>;
+    /** Fields visible across a set of projects (KQL autocomplete over a multi-project view). */
+    fieldsForProjects(tx: Tx, workspaceId: string, projectIds: string[]): Promise<FieldDef[]>;
+    createField(tx: Tx, workspaceId: string, input: UpsertFieldDef): Promise<FieldDef>;
+    updateField(tx: Tx, workspaceId: string, id: string, patch: Partial<Omit<UpsertFieldDef, 'key' | 'type'>>): Promise<FieldDef>;
+    archiveField(tx: Tx, workspaceId: string, id: string, archived: boolean): Promise<FieldDef>;
+    /** Deleting a field also strips its values from every issue: the key would otherwise be unreachable. */
+    deleteField(tx: Tx, workspaceId: string, id: string): Promise<void>;
+    listFieldSchemes(tx: Tx, workspaceId: string): Promise<FieldScheme[]>;
+    createFieldScheme(tx: Tx, workspaceId: string, input: {
+        name: string;
+        fieldIds: string[];
+    }): Promise<FieldScheme>;
+    updateFieldScheme(tx: Tx, workspaceId: string, id: string, patch: {
+        name?: string;
+        fieldIds?: string[];
+    }): Promise<FieldScheme>;
+    deleteFieldScheme(tx: Tx, workspaceId: string, id: string): Promise<void>;
+    listWorkflows(tx: Tx, workspaceId: string, opts?: {
+        projectId?: string;
+        includeArchived?: boolean;
+    }): Promise<Workflow[]>;
+    getWorkflowRow(tx: Tx, workspaceId: string, id: string): Promise<WorkflowRow>;
+    createWorkflow(tx: Tx, workspaceId: string, input: UpsertWorkflow): Promise<Workflow>;
+    updateWorkflow(tx: Tx, workspaceId: string, id: string, patch: Partial<UpsertWorkflow>): Promise<Workflow>;
+    /** Refuse to drop a status that issues still sit in — they would become unreachable. */
+    private assertStatusesStillUsed;
+    private clearDefaultWorkflow;
+    archiveWorkflow(tx: Tx, workspaceId: string, id: string, archived: boolean): Promise<Workflow>;
+    /** Row → contract shape, for the router. */
+    toContractType(row: WorkItemTypeRow): WorkItemType;
+    toContractWorkflow(row: WorkflowRow): Workflow;
+    /** Structural validation of a definition without saving it. */
+    validate(definition: unknown): {
+        ok: boolean;
+        problems: Array<{
+            path: string;
+            message: string;
+        }>;
+    };
+    workflowTemplates(): Array<{
+        id: string;
+        name: string;
+        definition: WorkflowDefinition;
+    }>;
+    listWorkflowSchemes(tx: Tx, workspaceId: string): Promise<WorkflowScheme[]>;
+    createWorkflowScheme(tx: Tx, workspaceId: string, input: UpsertWorkflowScheme): Promise<WorkflowScheme>;
+    updateWorkflowScheme(tx: Tx, workspaceId: string, id: string, patch: Partial<UpsertWorkflowScheme>): Promise<WorkflowScheme>;
+    deleteWorkflowScheme(tx: Tx, workspaceId: string, id: string): Promise<void>;
+    /**
+     * The workflow an issue of `typeId` follows in `project`:
+     * explicit type workflow → project's workflow scheme → project default → workspace default.
+     */
+    workflowFor(tx: Tx, project: ProjectRow, typeId: string): Promise<{
+        workflowId: string;
+        definition: WorkflowDefinition;
+    }>;
+    /** Every status of every workflow the project can use, deduplicated for board columns and KQL. */
+    statusesForProject(tx: Tx, workspaceId: string, projectId?: string): Promise<StatusInfo[]>;
+    /** Create the workflow and types a brand-new project starts with. */
+    seedProject(tx: Tx, workspaceId: string, projectId: string, template: string): Promise<{
+        workflowId: string;
+        typeIds: string[];
+        defaultTypeId: string;
+    }>;
+    /** Restore a project blueprint saved with `projects.templates.saveFromProject`. */
+    applyProjectTemplateBody(tx: Tx, workspaceId: string, projectId: string, body: Record<string, unknown>): Promise<{
+        workflowId: string;
+        defaultTypeId: string;
+    } | null>;
+    /** Snapshot a project's configuration so another project can be created from it. */
+    snapshotProject(tx: Tx, workspaceId: string, projectId: string): Promise<Record<string, unknown>>;
+    /** Ensure a set of type ids all belong to this workspace (scheme validation). */
+    assertTypesExist(tx: Tx, workspaceId: string, ids: string[]): Promise<void>;
+    /** Permission gate shared by every configuration mutation. */
+    requireWorkspacePermission(principal: Principal, workspaceId: string, permission: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/server/services/config.d.ts.map

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