@eaera-com/cms-sdk 0.1.61

package/dist/services/people/perms/ct.types.d.ts

@@ -0,0 +1,140 @@
+import { ContentItem } from '../../content/content.type';
+/** `catalog_revision` — bundle CT. ONE row = ONE atomic revision of the
+ *  whole access catalog. DS1: published-immutable + atomic publish+supersede.
+ *  ✅ */
+export interface PeopleCatalogRevisionData {
+    revisionLabel: string;
+    forkedFrom?: string | null;
+    roles: Array<{
+        key: string;
+        displayName?: string;
+        permissions: string[];
+        scopeRefs: string[];
+    }>;
+    permissions: Array<{
+        key: string;
+        description?: string;
+        seedDomain?: string;
+        configurable?: boolean;
+    }>;
+    scopeRules: Array<{
+        key: string;
+        level: 'own' | 'team' | 'department' | 'all';
+        orgMapping?: unknown;
+    }>;
+    fieldAccessPolicies: Array<{
+        fieldGroup: 'identity' | 'contact' | 'employment' | 'contract' | 'finance-salary' | 'time-attendance';
+        view: {
+            roleKeys: string[];
+            maskLevel: 'hidden' | 'partial' | 'full';
+            scopeRefs: string[];
+        };
+        approveLevel: 'L1' | 'L2' | 'L3' | 'L4';
+        l4Floor: boolean;
+    }>;
+    changelog?: string;
+    validationResult?: {
+        valid?: boolean;
+        errors?: unknown[];
+        checkedAt?: string;
+    };
+    state: 'draft' | 'published' | 'superseded' | 'discarded';
+}
+export type PeopleCatalogRevision = ContentItem<PeopleCatalogRevisionData>;
+/** `scope_exception` — subject-scoped (much higher change cadence than the
+ *  bundle). Created by the factory only (`grant_exception`) — see api_references
+ *  §3.4 + data-design §3.7b: `POST /content` for scope_exception starts a row
+ *  in `draft` with no activation API; the factory is the only admin path.
+ *  ✅ */
+export interface PeopleScopeExceptionData {
+    subjectRef: string;
+    employmentRef?: string | null;
+    effect: 'grant' | 'deny';
+    scopeKey: string;
+    window: {
+        effectiveFrom: string;
+        effectiveTo: string;
+    };
+    justification?: string;
+    origin: 'admin' | 'system';
+    errorCode?: string | null;
+    state: 'draft' | 'active' | 'expired' | 'revoked';
+}
+export type PeopleScopeException = ContentItem<PeopleScopeExceptionData>;
+/** Manual-override marker — manual removal beats birthright (D2). */
+export interface PeopleManualOverride {
+    blockedRuleKey?: string;
+    ruleVersionAtOverride?: number;
+    clearedBy?: string;
+}
+/** `role_assignment` row payload (registry §3.21). */
+export interface PeopleRoleAssignmentData {
+    subjectRef: string;
+    roleKey: string;
+    /** Employment content ref (eaera-hr CT) — identity triple element. */
+    accessContextRef: string;
+    assignmentType: 'manual' | 'birthright' | 'requested' | 'emergency';
+    purpose?: 'standard' | 'acting';
+    effectiveFrom?: string;
+    effectiveTo?: string | null;
+    justification?: string;
+    /** Emergency only. */
+    ticketRef?: string;
+    /** Birthright provenance. */
+    originRuleRef?: string;
+    originRuleVersion?: number;
+    manualOverride?: PeopleManualOverride | null;
+    /** Event dedupe — NO_OP audit PEOPLE_IDEM_DUPLICATE. */
+    idempotencyKey?: string;
+    sodWarnings?: unknown[];
+    /** Lifecycle timestamps (engine-written). */
+    activatedAt?: string;
+    revokedAt?: string | null;
+    amendedAt?: string | null;
+    revokeReason?: string | null;
+    state: 'prepared' | 'active' | 'inactive' | 'revoked' | 'archived';
+}
+export type PeopleRoleAssignment = ContentItem<PeopleRoleAssignmentData>;
+/** `assignment_rule` row payload (registry §3.22). */
+export interface PeopleAssignmentRuleData {
+    ruleKey: string;
+    version?: number;
+    match?: {
+        positions?: string[];
+        orgUnits?: string[];
+        legalEntities?: string[];
+    };
+    actions?: Array<{
+        effect: 'grant' | 'remove';
+        roleKey: string;
+    }>;
+    lastValidated?: string;
+    evaluationStats?: {
+        assignmentsGenerated?: number;
+        lastRunAt?: string;
+    };
+    state: 'draft' | 'published' | 'superseded' | 'discarded';
+}
+export type PeopleAssignmentRule = ContentItem<PeopleAssignmentRuleData>;
+/** One structured review item inside a campaign (no own workflow). */
+export interface PeopleReviewCampaignItem {
+    managerRef: string;
+    memberRef: string;
+    assignmentRefs: string[];
+    decision?: 'keep' | 'revoke' | null;
+    reason?: string | null;
+    reviewedAt?: string | null;
+    reviewedBy?: string | null;
+    status: 'pending' | 'done' | 'escalated';
+}
+/** `access_review_campaign` row payload (registry §3.23). */
+export interface PeopleAccessReviewCampaignData {
+    cycleConfig?: Record<string, unknown>;
+    deadlineAt: string;
+    items?: PeopleReviewCampaignItem[];
+    escalatedTo?: string;
+    completionReport?: Record<string, unknown> | null;
+    state: 'draft' | 'active' | 'completed' | 'cancelled';
+}
+export type PeopleAccessReviewCampaign = ContentItem<PeopleAccessReviewCampaignData>;
+//# sourceMappingURL=ct.types.d.ts.map

package/dist/services/people/perms/ct.types.d.ts.map

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

package/dist/services/people/perms/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Perms domain — barrel.
+ *
+ * Re-exports the public surface for FEAT-007 (catalog + scope exceptions)
+ * and FEAT-008 (role assignments + rules + review campaigns).
+ *
+ * Also re-exports the projection read types (`access.audit` Q-A/Q-B) for
+ * a single import path per domain.
+ */
+export type { PeopleCatalogRevisionData, PeopleCatalogRevision, PeopleScopeExceptionData, PeopleScopeException, PeopleRoleAssignment, PeopleRoleAssignmentData, PeopleManualOverride, PeopleAssignmentRule, PeopleAssignmentRuleData, PeopleAccessReviewCampaign, PeopleAccessReviewCampaignData, PeopleReviewCampaignItem, } from './ct.types';
+export type { PeopleValidateRevisionOutput, PeopleForkDraftParams, PeopleSeedMergeParams, PeopleSeedMergeOutput, PeoplePublishRevisionOutput, PeopleGrantExceptionParams, PeopleGrantExceptionOutput, PeopleAmendExceptionWindowParams, PeopleGrantParams, PeopleGrantOutput, PeopleRevokeParams, PeopleAmendWindowParams, PeopleValidateRuleOutput, PeoplePublishRuleOutput, PeopleRecordDecisionParams, PeopleRecordDecisionOutput, PeopleGenerateParams, PeopleGenerateOutput, PeopleRemindOutput, PeopleEscalateReviewOutput, PeopleCompleteOutput, PermsActions, } from './actions';
+export { buildPermsActions } from './actions';
+export type { PeopleAccessAuditQuery, PeopleAccessAuditResult, PeopleAccessAuditItem, PeopleAccessAuditItemQa, PeopleAccessAuditItemQb, } from './projections';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/people/perms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/people/perms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,gCAAgC,EAChC,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,eAAe,CAAC"}

package/dist/services/people/perms/projections.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Perms domain — projection read: `GET /api/v1/people/access/audit`.
+ *
+ * Composes catalog_revision + scope_exception × engine grant rows (live
+ * engine `user_roles` joined with `effective_permissions`) into a single
+ * Q-A/Q-B answer — see api_references §6.1.
+ *
+ * Performance target: <2s @ 10K users (FR-007e). Field→FAP group mapping is
+ * caller-provided (OQ-5 — see data-design §3.7a).
+ */
+export interface PeopleAccessAuditQuery {
+    mode: 'who-has-permission' | 'who-can-see-field';
+    /** Q-A (permission key) | Q-B (field key) — required for the chosen mode. */
+    target?: string;
+    field?: string;
+    record?: string;
+    /** Optional filters, live since FEAT-008 shipped (api_references §6.1). */
+    assignmentType?: string;
+    purpose?: string;
+}
+export interface PeopleAccessAuditItemBase {
+    subject: string;
+}
+/** Q-A item: subjects + roles + scopeRefs + assignmentType/purpose. */
+export interface PeopleAccessAuditItemQa extends PeopleAccessAuditItemBase {
+    roles: string[];
+    scopeRefs: string[];
+    /** Live FEAT-008 provenance (registry §3.21 — read from the
+     *  `user_roles.metadata` block `grant_reflect` writes); `null` for
+     *  engine-native grants the pack never touched. */
+    assignmentType: 'manual' | 'birthright' | 'requested' | 'emergency' | null;
+    purpose: 'standard' | 'acting' | null;
+}
+/** Q-B item: permission ∩ data-scope ∩ FAP fieldGroup AND with blockedBy. */
+export interface PeopleAccessAuditItemQb extends PeopleAccessAuditItemBase {
+    allowed: boolean;
+    blockedBy: 'permission' | 'scope' | 'fap';
+    maskLevel?: 'hidden' | 'partial' | 'full';
+}
+export type PeopleAccessAuditItem = PeopleAccessAuditItemQa | PeopleAccessAuditItemQb;
+export interface PeopleAccessAuditResult {
+    mode: PeopleAccessAuditQuery['mode'];
+    count: number;
+    items: PeopleAccessAuditItem[];
+    durationMs: number;
+}
+//# sourceMappingURL=projections.d.ts.map

package/dist/services/people/perms/projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.d.ts","sourceRoot":"","sources":["../../../../src/services/people/perms/projections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IACjD,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,uBAAwB,SAAQ,yBAAyB;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;uDAEmD;IACnD,cAAc,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC;IAC3E,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;CACvC;AAED,6EAA6E;AAC7E,MAAM,WAAW,uBAAwB,SAAQ,yBAAyB;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CAC3C;AAED,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,GAAG,uBAAuB,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/services/people/process/actions.d.ts

@@ -0,0 +1,154 @@
+import { ActionResponse } from '../../content/content.type';
+import { PeopleActionOpts } from '../shared.types';
+import { InvokeDeps } from '../_invoke';
+import { PeopleProcessDefinition, PeopleRequestTypeDefinition } from './ct.types';
+/** `edit_request_type` — draft/validated only; replaces `definition` and
+ *  re-stamps the canonical hash (validated → draft). */
+export interface PeopleEditRequestTypeParams {
+    definition: PeopleRequestTypeDefinition;
+}
+/** `safe_test_request_type` — sandbox scenario through the pure S1–S14
+ *  chain with simulated capabilities; no production mutation, no git effect,
+ *  no row state change. */
+export interface PeopleSafeTestRequestTypeParams {
+    scenario?: Record<string, unknown>;
+}
+/** `edit_policy` — human face takes title/body; machine face takes `artifact`. */
+export interface PeopleEditPolicyParams {
+    kind?: 'document' | 'process-composition' | 'cross-domain-automation' | 'settings-guardrails' | (string & {});
+    policyKey?: string;
+    /** Human face (`kind: document`). */
+    title?: string;
+    body?: Record<string, unknown>;
+    audience?: string;
+    scope?: string;
+    /** Machine face — the authored artifact tree (rides the row, drift D-5). */
+    artifact?: Record<string, unknown>;
+}
+/** `publish_policy` — `confirmImpact: true` required when consumers hold the
+ *  old version (impact warning). */
+export interface PeoplePublishPolicyParams {
+    confirmImpact?: boolean;
+}
+/** `archive_policy` — `purge: true` on a referenced version ⇒
+ *  `PEOPLE_POLICY_VERSION_REFERENCED`. */
+export interface PeopleArchivePolicyParams {
+    purge?: boolean;
+}
+/** `toggle_policy` — machine face only: artifact-level `enabled` OR one
+ *  composition entry override. Structural fields ⇒ `PEOPLE_POLICY_TOGGLE_INVALID`. */
+export interface PeopleTogglePolicyParams {
+    enabled: boolean;
+    entryKey?: string;
+}
+/** `toggle_glue_rule` — optional operator reason (incident bookkeeping). */
+export interface PeopleToggleGlueRuleParams {
+    reason?: string;
+}
+/** `runtime_request.create` — 7-step creation; snapshot pin at creation;
+ *  idempotent by `idempotencyKey` (RC-10 — pass a FRESH key per user submit). */
+export interface PeopleRuntimeRequestCreateParams {
+    input: unknown;
+    subjectRef: string;
+    requesterRef?: string;
+    idempotencyKey?: string;
+}
+/** `edit_process` — draft rows only (published immutable, DC-06); replaces
+ *  the authored tree and re-stamps the canonical hash. */
+export interface PeopleEditProcessParams {
+    definition: PeopleProcessDefinition;
+    repoRef?: string;
+    artifactPath?: string;
+}
+/** `publish_process` — `confirmImpact: true` required when instances still
+ *  pin the previous version (RT-21 impact warning). */
+export interface PeoplePublishProcessParams {
+    confirmImpact?: boolean;
+    repoRef?: string;
+}
+/** `supersede_process` — same impact belt as publish. */
+export interface PeopleSupersedeProcessParams {
+    confirmImpact?: boolean;
+    reason?: string;
+}
+/** `decommission_process` — tombstone after supersede (DC-05). */
+export interface PeopleDecommissionProcessParams {
+    reason?: string;
+}
+/** `create_process` FACTORY — draft instance under the one-active-per-
+ *  (type, subject) guard; deferrals recordable only BEFORE start (US2). */
+export interface PeopleCreateProcessParams {
+    typeKey: string;
+    subjectRef: string;
+    deferDecisions?: Record<string, boolean>;
+}
+/** `cancel_process` — US6 controlled cancel; everything produced LISTED. */
+export interface PeopleCancelProcessParams {
+    reason?: string;
+}
+export interface ProcessActions {
+    /** FEAT-010 — request_type authoring: edit → validate → safe-test → publish. */
+    readonly reqType: {
+        edit(uuid: string, params: PeopleEditRequestTypeParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        validate(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        safeTest(uuid: string, params?: PeopleSafeTestRequestTypeParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        publish(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        supersede(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        decommission(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        verify(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+    /** FEAT-010 — registered capability catalogue (9-field contract guard). */
+    readonly capability: {
+        publish(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        supersede(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+    /** FEAT-011 — policy registry handle (two faces, one artifact, one version). */
+    readonly policy: {
+        edit(uuid: string, params: PeopleEditPolicyParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        validate(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        publish(uuid: string, params?: PeoplePublishPolicyParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        supersede(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        archive(uuid: string, params?: PeopleArchivePolicyParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        restore(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        toggle(uuid: string, params: PeopleTogglePolicyParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        verify(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+    /** FEAT-011 — glue_rule handle: the ONLY instant operational toggle (DC-06). */
+    readonly glueRule: {
+        toggle(uuid: string, params?: PeopleToggleGlueRuleParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        verify(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+    /** FEAT-010 runtime on GENERATED per-flow CTs — needs the FEAT-015
+     *  registration path before row-scoped invocation works end-to-end. */
+    readonly runtimeRequest: {
+        /** Factory via the meta-CT alias: `POST
+         *  /content/types/request_type/actions/runtime_request.create`. */
+        create(typeKey: string, params: PeopleRuntimeRequestCreateParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        /** Row action with a DYNAMIC key authored in the definition — runs the
+         *  canonical S1–S14 chain (RT-01..07 ⇒ `PEOPLE_REQ_*`). */
+        invokeAction(uuid: string, actionKey: string, params?: Record<string, unknown>, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+    /** FEAT-014 — process_type definition lane (US1): edit → validate →
+     *  publish → supersede/decommission, plus the verify badge (US10). */
+    readonly processType: {
+        edit(uuid: string, params: PeopleEditProcessParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        validate(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        publish(uuid: string, params?: PeoplePublishProcessParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        supersede(uuid: string, params?: PeopleSupersedeProcessParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        decommission(uuid: string, params?: PeopleDecommissionProcessParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        verify(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+    /** FEAT-014 — process_instance lifecycle (US2/US4/US6): create (factory)
+     *  → start → cancel; retry/retry-spawn are the human-only recovery pair. */
+    readonly processInstance: {
+        /** FACTORY `create_process` on the process_instance CT. */
+        create(params: PeopleCreateProcessParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        start(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        cancel(uuid: string, params?: PeopleCancelProcessParams, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        retry(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+        /** Degraded recovery — only the missing spawn part (PC-06). */
+        retrySpawn(uuid: string, opts?: PeopleActionOpts): Promise<ActionResponse>;
+    };
+}
+export declare function buildProcessActions(deps: InvokeDeps): ProcessActions;
+//# sourceMappingURL=actions.d.ts.map

package/dist/services/people/process/actions.d.ts.map

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