@pax8-cta/core 0.1.0

package/dist/preconditions/schema.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from "zod";
+import type { PreconditionManifest } from "./types.js";
+/**
+ * Zod schemas mirroring `./types.ts`. Used by the manifest loader to
+ * surface specific, actionable error messages (e.g.
+ * "preconditions[2].matcher.displayName is required") instead of TypeScript's
+ * silent "did you check the JSON?" failures.
+ */
+export declare const ComparisonOpSchema: z.ZodEnum<{
+    includes: "includes";
+    equals: "equals";
+    "not-equals": "not-equals";
+    "at-least": "at-least";
+    "subset-of": "subset-of";
+}>;
+export declare const PreconditionRequirementSchema: z.ZodObject<{
+    property: z.ZodString;
+    op: z.ZodEnum<{
+        includes: "includes";
+        equals: "equals";
+        "not-equals": "not-equals";
+        "at-least": "at-least";
+        "subset-of": "subset-of";
+    }>;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const RemediationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"link">;
+    title: z.ZodString;
+    urlTemplate: z.ZodString;
+    manualSteps: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"command">;
+    title: z.ZodString;
+    cmd: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"manual">;
+    title: z.ZodString;
+    steps: z.ZodArray<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export declare const PreconditionSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    resourceType: z.ZodString;
+    matcher: z.ZodRecord<z.ZodString, z.ZodString>;
+    requirements: z.ZodArray<z.ZodObject<{
+        property: z.ZodString;
+        op: z.ZodEnum<{
+            includes: "includes";
+            equals: "equals";
+            "not-equals": "not-equals";
+            "at-least": "at-least";
+            "subset-of": "subset-of";
+        }>;
+        value: z.ZodUnknown;
+    }, z.core.$strip>>;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    remediation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"link">;
+        title: z.ZodString;
+        urlTemplate: z.ZodString;
+        manualSteps: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"command">;
+        title: z.ZodString;
+        cmd: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"manual">;
+        title: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+export declare const PreconditionManifestSchema: z.ZodType<PreconditionManifest>;
+/**
+ * Thrown when a manifest exists on disk but fails schema validation.
+ * Carries the path so callers can include it in the user-facing message.
+ */
+export declare class PreconditionManifestValidationError extends Error {
+    readonly path: string;
+    readonly issues: z.ZodIssue[];
+    constructor(path: string, issues: z.ZodIssue[]);
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/preconditions/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/preconditions/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB;;;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;iBAMxC,CAAC;AAsBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;2BAI5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ7B,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAIlC,CAAC;AAEtC;;;GAGG;AACH,qBAAa,mCAAoC,SAAQ,KAAK;aAE1C,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBADpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAWvC"}

package/dist/preconditions/schema.js

@@ -0,0 +1,93 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from "zod";
+/**
+ * Zod schemas mirroring `./types.ts`. Used by the manifest loader to
+ * surface specific, actionable error messages (e.g.
+ * "preconditions[2].matcher.displayName is required") instead of TypeScript's
+ * silent "did you check the JSON?" failures.
+ */
+export const ComparisonOpSchema = z.enum([
+    "equals",
+    "not-equals",
+    "at-least",
+    "includes",
+    "subset-of",
+]);
+export const PreconditionRequirementSchema = z.object({
+    property: z.string().min(1, "property is required"),
+    op: ComparisonOpSchema,
+    // `unknown` here is intentional — Zod has no first-class "any JSON" type
+    // and the YAML loader hands us anything from primitives to nested objects.
+    value: z.unknown(),
+});
+const RemediationLinkSchema = z.object({
+    kind: z.literal("link"),
+    title: z.string().min(1),
+    urlTemplate: z.string().min(1, "urlTemplate is required for link remediation"),
+    manualSteps: z.array(z.string()).default([]),
+});
+const RemediationCommandSchema = z.object({
+    kind: z.literal("command"),
+    title: z.string().min(1),
+    cmd: z.string().min(1, "cmd is required for command remediation"),
+    description: z.string().min(1),
+});
+const RemediationManualSchema = z.object({
+    kind: z.literal("manual"),
+    title: z.string().min(1),
+    steps: z.array(z.string()).min(1, "manual remediation requires at least one step"),
+});
+export const RemediationSchema = z.discriminatedUnion("kind", [
+    RemediationLinkSchema,
+    RemediationCommandSchema,
+    RemediationManualSchema,
+]);
+export const PreconditionSchema = z.object({
+    id: z.string().min(1, "id is required"),
+    description: z.string().min(1, "description is required"),
+    resourceType: z.string().min(1, "resourceType is required"),
+    matcher: z.record(z.string(), z.string()),
+    requirements: z.array(PreconditionRequirementSchema).min(1, "at least one requirement required"),
+    severity: z.enum(["error", "warning"]),
+    remediation: RemediationSchema,
+});
+export const PreconditionManifestSchema = z.object({
+    solution: z.string().min(1, "solution is required"),
+    version: z.string().min(1, "version is required"),
+    preconditions: z.array(PreconditionSchema),
+});
+/**
+ * Thrown when a manifest exists on disk but fails schema validation.
+ * Carries the path so callers can include it in the user-facing message.
+ */
+export class PreconditionManifestValidationError extends Error {
+    path;
+    issues;
+    constructor(path, issues) {
+        const formatted = issues
+            .map((issue) => {
+            const where = issue.path.length === 0 ? "<root>" : issue.path.join(".");
+            return `  - ${where}: ${issue.message}`;
+        })
+            .join("\n");
+        super(`Invalid precondition manifest at ${path}:\n${formatted}`);
+        this.path = path;
+        this.issues = issues;
+        this.name = "PreconditionManifestValidationError";
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/preconditions/schema.js.map

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

package/dist/preconditions/types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Preflight (precondition) types — Phase 1.
+ *
+ * The preflight feature surfaces tenant-config requirements that must be
+ * satisfied before a solution can deploy. Phase 1 reads these from a sibling
+ * YAML manifest and matches them against synthetic per-tenant state on
+ * `DEMO_TENANTS`. Phase 2 will replace the synthetic resolver with real
+ * Microsoft Graph TCM calls; the diff engine and types stay the same.
+ */
+/**
+ * Comparison operators supported in a precondition requirement.
+ *
+ *  - `equals` / `not-equals` — strict deep equality.
+ *  - `at-least` — booleans (true >= true|false), numbers (>= required), arrays
+ *    (current ⊇ required, i.e. current is a superset of required).
+ *  - `includes` — current is an array containing the required value.
+ *  - `subset-of` — current is an array, every element appears in required.
+ */
+export type ComparisonOp = "equals" | "not-equals" | "at-least" | "includes" | "subset-of";
+/**
+ * A single property check on a matched resource.
+ * `property` is a dot-path within the resource's `currentProperties`.
+ */
+export interface PreconditionRequirement {
+    property: string;
+    op: ComparisonOp;
+    value: unknown;
+}
+/**
+ * Structured remediation. Three kinds, mutually exclusive:
+ *  - `link` — open a deep link to fix in a portal.
+ *  - `command` — runnable CLI command the user can fire from pax8-cta.
+ *  - `manual` — list of instructions when no automation exists.
+ *
+ * `urlTemplate` and any string in `manualSteps` / `cmd` may include `{tenantId}`
+ * `{tenantName}` `{resourceId}` `{resourceDisplayName}` placeholders, which the
+ * CLI substitutes at render time.
+ */
+export type Remediation = {
+    kind: "link";
+    title: string;
+    urlTemplate: string;
+    manualSteps: string[];
+} | {
+    kind: "command";
+    title: string;
+    cmd: string;
+    description: string;
+} | {
+    kind: "manual";
+    title: string;
+    steps: string[];
+};
+/**
+ * One precondition. A resource must match `matcher` (e.g. by `displayName`)
+ * and then every entry in `requirements` must hold.
+ */
+export interface Precondition {
+    id: string;
+    description: string;
+    resourceType: string;
+    matcher: Record<string, string>;
+    requirements: PreconditionRequirement[];
+    /** `error` blocks deploy; `warning` is informational. */
+    severity: "error" | "warning";
+    remediation: Remediation;
+}
+/**
+ * The on-disk manifest format. Lives next to the solution `.zip` as
+ * `<solution>.preconditions.yaml`.
+ */
+export interface PreconditionManifest {
+    solution: string;
+    version: string;
+    preconditions: Precondition[];
+}
+/**
+ * One materialized "this requirement failed" record. Built by the diff
+ * engine; rendered by the CLI; flattened into the analyze envelope under
+ * `preconditions.failures`.
+ */
+export interface PreconditionFailure {
+    tenantId: string;
+    tenantName: string;
+    preconditionId: string;
+    description: string;
+    resourceType: string;
+    resourceDisplayName: string;
+    /**
+     * Resource id pulled from `currentProperties.id` when the resolver returned
+     * a state object with one. Empty string when unknown (e.g. the resource
+     * was missing from this tenant). Used to fill `{resourceId}` placeholders
+     * in remediation templates.
+     */
+    resourceId: string;
+    failedProperty: string;
+    currentValue: unknown;
+    requiredValue: unknown;
+    comparisonOp: ComparisonOp;
+    severity: "error" | "warning";
+    remediation: Remediation;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/preconditions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/preconditions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,yDAAyD;IACzD,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;CAC1B"}

package/dist/preconditions/types.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/preconditions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/preconditions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/queue/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from "./memory-queue.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/queue/index.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from "./memory-queue.js";
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/queue/memory-queue.d.ts

@@ -0,0 +1,86 @@
+export type JobStatus = "pending" | "active" | "completed" | "failed";
+export interface MemoryJob<T = unknown, R = unknown> {
+    id: string;
+    name: string;
+    data: T;
+    status: JobStatus;
+    progress: number;
+    result?: R;
+    error?: string;
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    attempts: number;
+    maxAttempts: number;
+}
+export type JobProcessor<T, R> = (job: MemoryJob<T, R>) => Promise<R>;
+export interface MemoryQueueOptions {
+    concurrency?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+export declare class MemoryQueue<T = unknown, R = unknown> {
+    readonly name: string;
+    private jobs;
+    private queue;
+    private processing;
+    private processor?;
+    private concurrency;
+    private maxRetries;
+    private retryDelay;
+    private isRunning;
+    private eventListeners;
+    constructor(name: string, options?: MemoryQueueOptions);
+    /**
+     * Add a job to the queue
+     */
+    add(name: string, data: T): Promise<MemoryJob<T, R>>;
+    /**
+     * Add multiple jobs at once
+     */
+    addBulk(jobs: {
+        name: string;
+        data: T;
+    }[]): Promise<MemoryJob<T, R>[]>;
+    /**
+     * Set the job processor
+     */
+    process(processor: JobProcessor<T, R>): void;
+    /**
+     * Get a job by ID
+     */
+    getJob(id: string): MemoryJob<T, R> | undefined;
+    /**
+     * Get all jobs with optional status filter
+     */
+    getJobs(status?: JobStatus): MemoryJob<T, R>[];
+    /**
+     * Get queue counts
+     */
+    getCounts(): {
+        pending: number;
+        active: number;
+        completed: number;
+        failed: number;
+    };
+    /**
+     * Update job progress
+     */
+    updateProgress(jobId: string, progress: number): void;
+    /**
+     * Listen to queue events
+     */
+    on(event: "waiting" | "active" | "completed" | "failed" | "progress", listener: (job: MemoryJob<T, R>, result?: R, error?: Error) => void): void;
+    private emit;
+    /**
+     * Stop processing
+     */
+    close(): void;
+    /**
+     * Clear all jobs
+     */
+    clear(): void;
+    private processNext;
+}
+export declare function getMemoryQueue<T = unknown, R = unknown>(name?: string, options?: MemoryQueueOptions): MemoryQueue<T, R>;
+//# sourceMappingURL=memory-queue.d.ts.map

package/dist/queue/memory-queue.d.ts.map

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