@syntax-syllogism/warden-core 0.2.0 → 0.3.1

package/lib/spec/parse.js.map

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

package/lib/useCase.d.ts

@@ -0,0 +1,45 @@
+import type { Connection } from '@salesforce/core';
+import { z } from 'zod';
+export type ProgressEvent = {
+    phase: string;
+    done?: number;
+    total?: number;
+    message?: string;
+};
+export type UseCaseContext = {
+    onProgress?: (event: ProgressEvent) => void;
+    signal?: AbortSignal;
+};
+export type UiHint = {
+    kind: 'file' | 'string' | 'boolean' | 'enum';
+    label: string;
+    summary?: string;
+    placeholder?: string;
+    fileFilter?: 'json' | 'csv' | 'json-or-csv';
+    exclusiveGroup?: string;
+    dependsOn?: string;
+};
+export type CommandId = 'provision' | 'access' | 'diff' | 'freeze' | 'unfreeze' | 'strip' | 'snapshot' | 'restore';
+export type CommandDescriptor<O> = {
+    id: CommandId;
+    title: string;
+    group: 'User Lifecycle';
+    destructive: boolean;
+    optionsSchema: z.ZodType<O>;
+};
+export type ReadUseCase<O, R> = {
+    kind: 'read';
+    descriptor: CommandDescriptor<O>;
+    run(conn: Connection, options: O, ctx?: UseCaseContext): Promise<R>;
+};
+export type WriteUseCase<O, P, R> = {
+    kind: 'write';
+    descriptor: CommandDescriptor<O>;
+    plan(conn: Connection, options: O, ctx?: UseCaseContext): Promise<P>;
+    apply(conn: Connection, plan: P, ctx?: UseCaseContext): Promise<R>;
+};
+export type UseCase<O, R> = ReadUseCase<O, R> | WriteUseCase<O, unknown, R>;
+export declare const uiHints: <O>(schema: z.ZodType<O>) => Record<string, UiHint>;
+export declare const checkCancelled: (ctx?: UseCaseContext) => void;
+export declare const startProgress: (ctx?: UseCaseContext, phase?: string) => void;
+export declare const endProgress: (ctx?: UseCaseContext, phase?: string) => void;

package/lib/useCase.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { WardenError } from './errors.js';
+export const uiHints = (schema) => {
+    if (!(schema instanceof z.ZodObject))
+        return {};
+    return Object.fromEntries(Object.entries(schema.shape).flatMap(([key, field]) => {
+        let current = field;
+        let meta;
+        while (current != null) {
+            const candidate = current;
+            meta = candidate.meta?.();
+            if (meta?.ui ?? !candidate.unwrap)
+                break;
+            current = candidate.unwrap();
+        }
+        return meta?.ui ? [[key, meta.ui]] : [];
+    }));
+};
+export const checkCancelled = (ctx) => {
+    if (ctx?.signal?.aborted)
+        throw new WardenError('cancelled', 'Operation cancelled.');
+};
+export const startProgress = (ctx, phase = 'start') => {
+    checkCancelled(ctx);
+    ctx?.onProgress?.({ phase });
+};
+export const endProgress = (ctx, phase = 'complete') => {
+    checkCancelled(ctx);
+    ctx?.onProgress?.({ phase });
+};
+//# sourceMappingURL=useCase.js.map

package/lib/useCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCase.js","sourceRoot":"","sources":["../src/useCase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiD1C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAI,MAAoB,EAA0B,EAAE;IACzE,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpD,IAAI,OAAO,GAAY,KAAK,CAAC;QAC7B,IAAI,IAAiC,CAAC;QACtC,OAAO,OAAO,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,OAAmE,CAAC;YACtF,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1B,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;gBAAE,MAAM;YACzC,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAoB,EAAQ,EAAE;IAC3D,IAAI,GAAG,EAAE,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;AACvF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAoB,EAAE,KAAK,GAAG,OAAO,EAAQ,EAAE;IAC3E,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAoB,EAAE,KAAK,GAAG,UAAU,EAAQ,EAAE;IAC5E,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC"}

package/lib/useCases.d.ts

@@ -0,0 +1,152 @@
+import type { UserAccessResult } from './access/types.js';
+import type { LifecycleResult, LifecycleUserResult, TargetError, LabelBundle } from './lifecycle/types.js';
+import { type UserSnapshotFile } from './lifecycle/snapshotState.js';
+import { type StripTargetState } from './lifecycle/stripPlan.js';
+import { type ProvisionOptions, type FreezeOptions, type UnfreezeOptions, type StripOptions, type DiffOptions, type AccessOptions, type SnapshotOptions, type RestoreOptions } from './commandOptions.js';
+import { type CommandDescriptor, type ReadUseCase, type WriteUseCase } from './useCase.js';
+import type { ProvisionResult } from './provisioning/provisionUserUseCase.js';
+import { type UserPlan, type OrderedUserResult } from './provisioning/userPlan.js';
+import type { ResolvedRefs } from './provisioning/assignmentPlan.js';
+import { type UserLicenseUsage } from './provisioning/licenseUsage.js';
+type FreezeUpdate = {
+    resultIndex: number;
+    row: {
+        Id: string;
+        IsFrozen: boolean;
+    };
+    actionKey: string;
+};
+export type FreezePlan = {
+    direction: 'freeze' | 'unfreeze';
+    users: LifecycleUserResult[];
+    updates: FreezeUpdate[];
+    warnings: string[];
+};
+export declare const freeze: WriteUseCase<FreezeOptions, FreezePlan, LifecycleResult>;
+export declare const unfreeze: WriteUseCase<UnfreezeOptions, FreezePlan, LifecycleResult>;
+export type StripPlan = {
+    states: StripTargetState[];
+    errors: TargetError[];
+    preview: LifecycleResult;
+    warnings: string[];
+};
+export declare const strip: WriteUseCase<StripOptions, StripPlan, LifecycleResult>;
+export declare const diff: ReadUseCase<DiffOptions, Awaited<ReturnType<typeof import('./lifecycle/userDiff.js').executePersonaDiff>> | Array<import('./lifecycle/conformance.js').UserConformanceVerdict>>;
+export declare const access: ReadUseCase<AccessOptions, UserAccessResult>;
+export declare const snapshot: ReadUseCase<SnapshotOptions, UserSnapshotFile>;
+export type ProvisionPlan = {
+    plans: UserPlan[];
+    refs: SerializedRefs;
+    validationResults: OrderedUserResult[];
+    licenses: UserLicenseUsage[];
+    preview: ProvisionResult;
+    warnings: string[];
+};
+type SerializedRefs = Omit<ResolvedRefs, 'profilesByRef' | 'rolesByRef' | 'permissionSetIdsByRef' | 'permissionSetGroupIdsByRef' | 'publicGroupIdsByRef' | 'queueIdsByRef'> & {
+    profilesByRef: Record<string, string>;
+    rolesByRef: Record<string, string>;
+    permissionSetIdsByRef: Record<string, string>;
+    permissionSetGroupIdsByRef: Record<string, string>;
+    publicGroupIdsByRef: Record<string, string>;
+    queueIdsByRef: Record<string, string>;
+};
+export declare const provision: WriteUseCase<ProvisionOptions, ProvisionPlan, ProvisionResult>;
+type RestoreUserPlan = {
+    userId: string;
+    result: LifecycleUserResult;
+    preview: LifecycleUserResult;
+    userUpdate?: {
+        Id: string;
+        IsActive: true;
+    };
+    loginUpdates: Array<{
+        Id: string;
+        IsFrozen: false;
+    }>;
+    permissionSetAdds: string[];
+    permissionSetGroupAdds: string[];
+    publicGroupAdds: string[];
+    queueAdds: string[];
+    licenseAdds: string[];
+    permissionSetItems: LabelBundle[];
+    permissionSetGroupItems: LabelBundle[];
+    publicGroupItems: LabelBundle[];
+    queueItems: LabelBundle[];
+    licenseItems: LabelBundle[];
+};
+export type RestorePlan = {
+    users: RestoreUserPlan[];
+    errors: LifecycleUserResult[];
+    warnings: string[];
+    preview: LifecycleResult;
+};
+export declare const restore: WriteUseCase<RestoreOptions, RestorePlan, LifecycleResult>;
+export declare const commandDescriptors: readonly [CommandDescriptor<{
+    fuzzyUsername: boolean;
+    usersPath?: string | undefined;
+    usersDoc?: Record<string, unknown> | undefined;
+    personasPath?: string | undefined;
+    personasDoc?: Record<string, unknown> | undefined;
+    relatedPath?: string | undefined;
+    relatedDoc?: Record<string, unknown> | undefined;
+    externalId?: string | undefined;
+    inputFormat?: string | undefined;
+    csvListDelimiter?: string | undefined;
+}>, CommandDescriptor<{
+    type: string;
+    target?: string | undefined;
+    user?: string | undefined;
+    sobject?: string | undefined;
+}>, CommandDescriptor<{
+    mode: string;
+    verify: boolean;
+    user?: string | undefined;
+    against?: string | undefined;
+    usersPath?: string | undefined;
+    usersDoc?: Record<string, unknown> | undefined;
+    personasPath?: string | undefined;
+    personasDoc?: Record<string, unknown> | undefined;
+    externalId?: string | undefined;
+    inputFormat?: string | undefined;
+    csvListDelimiter?: string | undefined;
+}>, CommandDescriptor<{
+    user?: string | undefined;
+    usersPath?: string | undefined;
+    usersDoc?: Record<string, unknown> | undefined;
+    externalId?: string | undefined;
+    inputFormat?: string | undefined;
+    csvListDelimiter?: string | undefined;
+}>, CommandDescriptor<{
+    user?: string | undefined;
+    usersPath?: string | undefined;
+    usersDoc?: Record<string, unknown> | undefined;
+    externalId?: string | undefined;
+    inputFormat?: string | undefined;
+    csvListDelimiter?: string | undefined;
+}>, CommandDescriptor<{
+    noFreeze: boolean;
+    noDeactivate: boolean;
+    keepPermsets: boolean;
+    keepPermsetGroups: boolean;
+    keepPublicGroups: boolean;
+    keepQueues: boolean;
+    keepLicenses: boolean;
+    user?: string | undefined;
+    usersPath?: string | undefined;
+    usersDoc?: Record<string, unknown> | undefined;
+    externalId?: string | undefined;
+    inputFormat?: string | undefined;
+    csvListDelimiter?: string | undefined;
+}>, CommandDescriptor<{
+    org?: string | undefined;
+    user?: string | undefined;
+    usersPath?: string | undefined;
+    usersDoc?: Record<string, unknown> | undefined;
+    externalId?: string | undefined;
+    inputFormat?: string | undefined;
+    csvListDelimiter?: string | undefined;
+}>, CommandDescriptor<{
+    snapshotPath?: string | undefined;
+    snapshotDoc?: Record<string, unknown> | undefined;
+}>];
+export type { ProvisionOptions, FreezeOptions, UnfreezeOptions, StripOptions, DiffOptions, AccessOptions, SnapshotOptions, RestoreOptions, };