@devramps/sdk-typescript 0.1.0

package/dist/output/step-output.d.ts

@@ -0,0 +1,286 @@
+import z from "zod";
+export declare const ApprovalContextSchema: z.ZodObject<{
+    approved: z.ZodLiteral<true>;
+    approverId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    approved: true;
+    approverId: string;
+}, {
+    approved: true;
+    approverId: string;
+}>;
+export type ApprovalContext = z.infer<typeof ApprovalContextSchema>;
+declare const FailedOutputSchema: z.ZodObject<{
+    status: z.ZodLiteral<"FAILED">;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}>;
+declare const SuccessOutputSchema: z.ZodObject<{
+    status: z.ZodLiteral<"SUCCESS">;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}>;
+export type FailedOutput = z.infer<typeof FailedOutputSchema>;
+export type SuccessOutput = z.infer<typeof SuccessOutputSchema>;
+declare const ApprovalRequiredOutputSchema: z.ZodObject<{
+    status: z.ZodLiteral<"APPROVAL_REQUIRED">;
+    approvalRequest: z.ZodObject<{
+        message: z.ZodString;
+        approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    }, {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "APPROVAL_REQUIRED";
+    approvalRequest: {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    };
+}, {
+    status: "APPROVAL_REQUIRED";
+    approvalRequest: {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    };
+}>;
+export declare const PrepareOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"APPROVAL_REQUIRED">;
+    approvalRequest: z.ZodObject<{
+        message: z.ZodString;
+        approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    }, {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "APPROVAL_REQUIRED";
+    approvalRequest: {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    };
+}, {
+    status: "APPROVAL_REQUIRED";
+    approvalRequest: {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    };
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"FAILED">;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}>]>;
+export type ApprovalRequiredOutput = z.infer<typeof ApprovalRequiredOutputSchema>;
+export type PrepareOutput = z.infer<typeof PrepareOutputSchema>;
+export declare const RunOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"SUCCESS">;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"FAILED">;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}>]>;
+export type RunOutput = z.infer<typeof RunOutputSchema>;
+export declare const TriggerOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"TRIGGERED">;
+    pollingState: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    status: "TRIGGERED";
+    pollingState: Record<string, any>;
+}, {
+    status: "TRIGGERED";
+    pollingState: Record<string, any>;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"FAILED">;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}>]>;
+export type TriggeredOutput<TPollingState = Record<string, unknown>> = {
+    status: "TRIGGERED";
+    pollingState: TPollingState;
+};
+export type TriggerOutput<TPollingState = Record<string, unknown>> = TriggeredOutput<TPollingState> | FailedOutput;
+export declare const PollOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"POLL_AGAIN">;
+    pollingState: z.ZodRecord<z.ZodString, z.ZodAny>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "POLL_AGAIN";
+    pollingState: Record<string, any>;
+    retryAfterMs?: number | undefined;
+}, {
+    status: "POLL_AGAIN";
+    pollingState: Record<string, any>;
+    retryAfterMs?: number | undefined;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"SUCCESS">;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"FAILED">;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}>]>;
+export type PollAgainOutput<TPollingState = Record<string, unknown>> = {
+    status: "POLL_AGAIN";
+    pollingState: TPollingState;
+    retryAfterMs?: number;
+};
+export type PollOutput<TPollingState = Record<string, unknown>> = PollAgainOutput<TPollingState> | SuccessOutput | FailedOutput;
+export declare const StepOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"SUCCESS">;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}, {
+    status: "SUCCESS";
+    data?: Record<string, any> | undefined;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"FAILED">;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    status: "FAILED";
+    errorCode?: string | undefined;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"APPROVAL_REQUIRED">;
+    approvalRequest: z.ZodObject<{
+        message: z.ZodString;
+        approvers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    }, {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: "APPROVAL_REQUIRED";
+    approvalRequest: {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    };
+}, {
+    status: "APPROVAL_REQUIRED";
+    approvalRequest: {
+        message: string;
+        approvers?: string[] | undefined;
+        metadata?: Record<string, any> | undefined;
+    };
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"TRIGGERED">;
+    pollingState: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    status: "TRIGGERED";
+    pollingState: Record<string, any>;
+}, {
+    status: "TRIGGERED";
+    pollingState: Record<string, any>;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"POLL_AGAIN">;
+    pollingState: z.ZodRecord<z.ZodString, z.ZodAny>;
+    retryAfterMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "POLL_AGAIN";
+    pollingState: Record<string, any>;
+    retryAfterMs?: number | undefined;
+}, {
+    status: "POLL_AGAIN";
+    pollingState: Record<string, any>;
+    retryAfterMs?: number | undefined;
+}>]>;
+export type StepOutput = z.infer<typeof StepOutputSchema>;
+export declare const StepOutputs: {
+    success(data?: Record<string, unknown>): SuccessOutput;
+    failed(error: string, errorCode?: string): FailedOutput;
+    approvalRequired(request: {
+        message: string;
+        approvers?: string[];
+        metadata?: Record<string, unknown>;
+    }): ApprovalRequiredOutput;
+    triggered<TPollingState>(pollingState: TPollingState): TriggeredOutput<TPollingState>;
+    pollAgain<TPollingState>(pollingState: TPollingState, retryAfterMs?: number): PollAgainOutput<TPollingState>;
+};
+export {};

package/dist/output/step-output.js

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepOutputs = exports.StepOutputSchema = exports.PollOutputSchema = exports.TriggerOutputSchema = exports.RunOutputSchema = exports.PrepareOutputSchema = exports.ApprovalContextSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+// =============================================================================
+// Approval Context (passed to steps after approval is granted)
+// =============================================================================
+exports.ApprovalContextSchema = zod_1.default.object({
+    approved: zod_1.default.literal(true),
+    approverId: zod_1.default.string(),
+});
+// =============================================================================
+// Shared Output Components
+// =============================================================================
+const FailedOutputSchema = zod_1.default.object({
+    status: zod_1.default.literal("FAILED"),
+    error: zod_1.default.string(),
+    errorCode: zod_1.default.string().optional(),
+});
+const SuccessOutputSchema = zod_1.default.object({
+    status: zod_1.default.literal("SUCCESS"),
+    data: zod_1.default.record(zod_1.default.string(), zod_1.default.any()).optional(),
+});
+// =============================================================================
+// PrepareOutput (for approval flow - used by SimpleStep and PollingStep)
+// =============================================================================
+const ApprovalRequiredOutputSchema = zod_1.default.object({
+    status: zod_1.default.literal("APPROVAL_REQUIRED"),
+    approvalRequest: zod_1.default.object({
+        message: zod_1.default.string(),
+        approvers: zod_1.default.array(zod_1.default.string()).optional(),
+        metadata: zod_1.default.record(zod_1.default.string(), zod_1.default.any()).optional(),
+    }),
+});
+exports.PrepareOutputSchema = zod_1.default.discriminatedUnion("status", [
+    ApprovalRequiredOutputSchema,
+    FailedOutputSchema,
+]);
+// =============================================================================
+// RunOutput (SimpleStep.run)
+// =============================================================================
+exports.RunOutputSchema = zod_1.default.discriminatedUnion("status", [
+    SuccessOutputSchema,
+    FailedOutputSchema,
+]);
+// =============================================================================
+// TriggerOutput (PollingStep.trigger)
+// =============================================================================
+const TriggeredOutputSchema = zod_1.default.object({
+    status: zod_1.default.literal("TRIGGERED"),
+    pollingState: zod_1.default.record(zod_1.default.string(), zod_1.default.any()),
+});
+exports.TriggerOutputSchema = zod_1.default.discriminatedUnion("status", [
+    TriggeredOutputSchema,
+    FailedOutputSchema,
+]);
+// =============================================================================
+// PollOutput (PollingStep.poll)
+// =============================================================================
+const PollAgainOutputSchema = zod_1.default.object({
+    status: zod_1.default.literal("POLL_AGAIN"),
+    pollingState: zod_1.default.record(zod_1.default.string(), zod_1.default.any()),
+    retryAfterMs: zod_1.default.number().optional(),
+});
+exports.PollOutputSchema = zod_1.default.discriminatedUnion("status", [
+    PollAgainOutputSchema,
+    SuccessOutputSchema,
+    FailedOutputSchema,
+]);
+// =============================================================================
+// Combined StepOutput (for registry to write to file)
+// =============================================================================
+exports.StepOutputSchema = zod_1.default.discriminatedUnion("status", [
+    SuccessOutputSchema,
+    FailedOutputSchema,
+    ApprovalRequiredOutputSchema,
+    TriggeredOutputSchema,
+    PollAgainOutputSchema,
+]);
+// =============================================================================
+// Helper Functions
+// =============================================================================
+exports.StepOutputs = {
+    // Success (used by SimpleStep.run and PollingStep.poll)
+    success(data) {
+        return { status: "SUCCESS", data };
+    },
+    // Failed (used by all phases)
+    failed(error, errorCode) {
+        return { status: "FAILED", error, errorCode };
+    },
+    // Approval required (used by prepare phase)
+    approvalRequired(request) {
+        return { status: "APPROVAL_REQUIRED", approvalRequest: request };
+    },
+    // Triggered (used by PollingStep.trigger)
+    triggered(pollingState) {
+        return { status: "TRIGGERED", pollingState };
+    },
+    // Poll again (used by PollingStep.poll)
+    pollAgain(pollingState, retryAfterMs) {
+        return { status: "POLL_AGAIN", pollingState, retryAfterMs };
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1vdXRwdXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvb3V0cHV0L3N0ZXAtb3V0cHV0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLDhDQUFvQjtBQUVwQixnRkFBZ0Y7QUFDaEYsK0RBQStEO0FBQy9ELGdGQUFnRjtBQUVuRSxRQUFBLHFCQUFxQixHQUFHLGFBQUMsQ0FBQyxNQUFNLENBQUM7SUFDNUMsUUFBUSxFQUFFLGFBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDO0lBQ3pCLFVBQVUsRUFBRSxhQUFDLENBQUMsTUFBTSxFQUFFO0NBQ3ZCLENBQUMsQ0FBQztBQUlILGdGQUFnRjtBQUNoRiwyQkFBMkI7QUFDM0IsZ0ZBQWdGO0FBRWhGLE1BQU0sa0JBQWtCLEdBQUcsYUFBQyxDQUFDLE1BQU0sQ0FBQztJQUNsQyxNQUFNLEVBQUUsYUFBQyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUM7SUFDM0IsS0FBSyxFQUFFLGFBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDakIsU0FBUyxFQUFFLGFBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7Q0FDakMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxtQkFBbUIsR0FBRyxhQUFDLENBQUMsTUFBTSxDQUFDO0lBQ25DLE1BQU0sRUFBRSxhQUFDLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQztJQUM1QixJQUFJLEVBQUUsYUFBQyxDQUFDLE1BQU0sQ0FBQyxhQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsYUFBQyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFFO0NBQy9DLENBQUMsQ0FBQztBQUtILGdGQUFnRjtBQUNoRix5RUFBeUU7QUFDekUsZ0ZBQWdGO0FBRWhGLE1BQU0sNEJBQTRCLEdBQUcsYUFBQyxDQUFDLE1BQU0sQ0FBQztJQUM1QyxNQUFNLEVBQUUsYUFBQyxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsQ0FBQztJQUN0QyxlQUFlLEVBQUUs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TyxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUUsWUFBWSxFQUFFLENBQUM7SUFDL0MsQ0FBQztJQUVELHdDQUF3QztJQUN4QyxTQUFTLENBQ1AsWUFBMkIsRUFDM0IsWUFBcUI7UUFFckIsT0FBTyxFQUFFLE1BQU0sRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVksRUFBRSxDQUFDO0lBQzlELENBQUM7Q0FDRixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHogZnJvbSBcInpvZFwiO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gQXBwcm92YWwgQ29udGV4dCAocGFzc2VkIHRvIHN0ZXBzIGFmdGVyIGFwcHJvdmFsIGlzIGdyYW50ZWQpXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgY29uc3QgQXBwcm92YWxDb250ZXh0U2NoZW1hID0gei5vYmplY3Qoe1xuICBhcHByb3ZlZDogei5saXRlcmFsKHRydWUpLFxuICBhcHByb3ZlcklkOiB6LnN0cmluZygpLFxufSk7XG5cbmV4cG9ydCB0eXBlIEFwcHJvdmFsQ29udGV4dCA9IHouaW5mZXI8dHlwZW9mIEFwcHJvdmFsQ29udGV4dFNjaGVtYT47XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBTaGFyZWQgT3V0cHV0IENvbXBvbmVudHNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmNvbnN0IEZhaWxlZE91dHB1dFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgc3RhdHVzOiB6LmxpdGVyYWwoXCJGQUlMRURcIiksXG4gIGVycm9yOiB6LnN0cmluZygpLFxuICBlcnJvckNvZGU6IHouc3RyaW5nKCkub3B0aW9uYWwoKSxcbn0pO1xuXG5jb25zdCBTdWNjZXNzT3V0cHV0U2NoZW1hID0gei5vYmplY3Qoe1xuICBzdGF0dXM6IHoubGl0ZXJhbChcIlNVQ0NFU1NcIiksXG4gIGRhdGE6IHoucmVjb3JkKHouc3RyaW5nKCksIHouYW55KCkpLm9wdGlvbmFsKCksXG59KTtcblxuZXhwb3J0IHR5cGUgRmFpbGVkT3V0cHV0ID0gei5pbmZlcjx0eXBlb2YgRmFpbGVkT3V0cHV0U2NoZW1hPjtcbmV4cG9ydCB0eXBlIFN1Y2Nlc3NPdXRwdXQgPSB6LmluZmVyPHR5cGVvZiBTdWNjZXNzT3V0cHV0U2NoZW1hPjtcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFByZXBhcmVPdXRwdXQgKGZvciBhcHByb3ZhbCBmbG93IC0gdXNlZCBieSBTaW1wbGVTdGVwIGFuZCBQb2xsaW5nU3RlcClcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmNvbnN0IEFwcHJvdmFsUmVxdWlyZWRPdXRwdXRTY2hlbWEgPSB6Lm9iamVjdCh7XG4gIHN0YXR1czogei5saXRlcmFsKFwiQVBQUk9WQUxfUkVRVUlSRURcIiksXG4gIGFwcHJvdmFsUmVxdWVzdDogei5vYmplY3Qoe1xuICAgIG1lc3NhZ2U6IHouc3RyaW5nKCksXG4gICAgYXBwcm92ZXJzOiB6LmFycmF5KHouc3RyaW5nKCkpLm9wdGlvbmFsKCksXG4gICAgbWV0YWRhdGE6IHoucmVjb3JkKHouc3RyaW5nKCksIHouYW55KCkpLm9wdGlvbmFsKCksXG4gIH0pLFxufSk7XG5cbmV4cG9ydCBjb25zdCBQcmVwYXJlT3V0cHV0U2NoZW1hID0gei5kaXNjcmltaW5hdGVkVW5pb24oXCJzdGF0dXNcIiwgW1xuICBBcHByb3ZhbFJlcXVpcmVkT3V0cHV0U2NoZW1hLFxuICBGYWlsZWRPdXRwdXRTY2hlbWEsXG5dKTtcblxuZXhwb3J0IHR5cGUgQXBwcm92YWxSZXF1aXJlZE91dHB1dCA9IHouaW5mZXI8dHlwZW9mIEFwcHJvdmFsUmVxdWlyZWRPdXRwdXRTY2hlbWE+O1xuZXhwb3J0IHR5cGUgUHJlcGFyZU91dHB1dCA9IHouaW5mZXI8dHlwZW9mIFByZXBhcmVPdXRwdXRTY2hlbWE+O1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUnVuT3V0cHV0IChTaW1wbGVTdGVwLnJ1bilcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCBjb25zdCBSdW5PdXRwdXRTY2hlbWEgPSB6LmRpc2NyaW1pbmF0ZWRVbmlvbihcInN0YXR1c1wiLCBbXG4gIFN1Y2Nlc3NPdXRwdXRTY2hlbWEsXG4gIEZhaWxlZE91dHB1dFNjaGVtYSxcbl0pO1xuXG5leHBvcnQgdHlwZSBSdW5PdXRwdXQgPSB6LmluZmVyPHR5cGVvZiBSdW5PdXRwdXRTY2hlbWE+O1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gVHJpZ2dlck91dHB1dCAoUG9sbGluZ1N0ZXAudHJpZ2dlcilcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmNvbnN0IFRyaWdnZXJlZE91dHB1dFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgc3RhdHVzOiB6LmxpdGVyYWwoXCJUUklHR0VSRURcIiksXG4gIHBvbGxpbmdTdGF0ZTogei5yZWNvcmQoei5zdHJpbmcoKSwgei5hbnkoKSksXG59KTtcblxuZXhwb3J0IGNvbnN0IFRyaWdnZXJPdXRwdXRTY2hlbWEgPSB6LmRpc2NyaW1pbmF0ZWRVbmlvbihcInN0YXR1c1wiLCBbXG4gIFRyaWdnZXJlZE91dHB1dFNjaGVtYSxcbiAgRmFpbGVkT3V0cHV0U2NoZW1hLFxuXSk7XG5cbmV4cG9ydCB0eXBlIFRyaWdnZXJlZE91dHB1dDxUUG9sbGluZ1N0YXRlID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4+ID0ge1xuICBzdGF0dXM6IFwiVFJJR0dFUkVEXCI7XG4gIHBvbGxpbmdTdGF0ZTogVFBvbGxpbmdTdGF0ZTtcbn07XG5cbmV4cG9ydCB0eXBlIFRyaWdnZXJPdXRwdXQ8VFBvbGxpbmdTdGF0ZSA9IFJlY29yZDxzdHJpbmcsIHVua25vd24+PiA9XG4gIHwgVHJpZ2dlcmVkT3V0cHV0PFRQb2xsaW5nU3RhdGU+XG4gIHwgRmFpbGVkT3V0cHV0O1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUG9sbE91dHB1dCAoUG9sbGluZ1N0ZXAucG9sbClcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmNvbnN0IFBvbGxBZ2Fpbk91dHB1dFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgc3RhdHVzOiB6LmxpdGVyYWwoXCJQT0xMX0FHQUlOXCIpLFxuICBwb2xsaW5nU3RhdGU6IHoucmVjb3JkKHouc3RyaW5nKCksIHouYW55KCkpLFxuICByZXRyeUFmdGVyTXM6IHoubnVtYmVyKCkub3B0aW9uYWwoKSxcbn0pO1xuXG5leHBvcnQgY29uc3QgUG9sbE91dHB1dFNjaGVtYSA9IHouZGlzY3JpbWluYXRlZFVuaW9uKFwic3RhdHVzXCIsIFtcbiAgUG9sbEFnYWluT3V0cHV0U2NoZW1hLFxuICBTdWNjZXNzT3V0cHV0U2NoZW1hLFxuICBGYWlsZWRPdXRwdXRTY2hlbWEsXG5dKTtcblxuZXhwb3J0IHR5cGUgUG9sbEFnYWluT3V0cHV0PFRQb2xsaW5nU3RhdGUgPSBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPj4gPSB7XG4gIHN0YXR1czogXCJQT0xMX0FHQUlOXCI7XG4gIHBvbGxpbmdTdGF0ZTogVFBvbGxpbmdTdGF0ZTtcbiAgcmV0cnlBZnRlck1zPzogbnVtYmVyO1xufTtcblxuZXhwb3J0IHR5cGUgUG9sbE91dHB1dDxUUG9sbGluZ1N0YXRlID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4+ID1cbiAgfCBQb2xsQWdhaW5PdXRwdXQ8VFBvbGxpbmdTdGF0ZT5cbiAgfCBTdWNjZXNzT3V0cHV0XG4gIHwgRmFpbGVkT3V0cHV0O1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gQ29tYmluZWQgU3RlcE91dHB1dCAoZm9yIHJlZ2lzdHJ5IHRvIHdyaXRlIHRvIGZpbGUpXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgY29uc3QgU3RlcE91dHB1dFNjaGVtYSA9IHouZGlzY3JpbWluYXRlZFVuaW9uKFwic3RhdHVzXCIsIFtcbiAgU3VjY2Vzc091dHB1dFNjaGVtYSxcbiAgRmFpbGVkT3V0cHV0U2NoZW1hLFxuICBBcHByb3ZhbFJlcXVpcmVkT3V0cHV0U2NoZW1hLFxuICBUcmlnZ2VyZWRPdXRwdXRTY2hlbWEsXG4gIFBvbGxBZ2Fpbk91dHB1dFNjaGVtYSxcbl0pO1xuXG5leHBvcnQgdHlwZSBTdGVwT3V0cHV0ID0gei5pbmZlcjx0eXBlb2YgU3RlcE91dHB1dFNjaGVtYT47XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBIZWxwZXIgRnVuY3Rpb25zXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgY29uc3QgU3RlcE91dHB1dHMgPSB7XG4gIC8vIFN1Y2Nlc3MgKHVzZWQgYnkgU2ltcGxlU3RlcC5ydW4gYW5kIFBvbGxpbmdTdGVwLnBvbGwpXG4gIHN1Y2Nlc3MoZGF0YT86IFJlY29yZDxzdHJpbmcsIHVua25vd24+KTogU3VjY2Vzc091dHB1dCB7XG4gICAgcmV0dXJuIHsgc3RhdHVzOiBcIlNVQ0NFU1NcIiwgZGF0YSB9O1xuICB9LFxuXG4gIC8vIEZhaWxlZCAodXNlZCBieSBhbGwgcGhhc2VzKVxuICBmYWlsZWQoZXJyb3I6IHN0cmluZywgZXJyb3JDb2RlPzogc3RyaW5nKTogRmFpbGVkT3V0cHV0IHtcbiAgICByZXR1cm4geyBzdGF0dXM6IFwiRkFJTEVEXCIsIGVycm9yLCBlcnJvckNvZGUgfTtcbiAgfSxcblxuICAvLyBBcHByb3ZhbCByZXF1aXJlZCAodXNlZCBieSBwcmVwYXJlIHBoYXNlKVxuICBhcHByb3ZhbFJlcXVpcmVkKHJlcXVlc3Q6IHtcbiAgICBtZXNzYWdlOiBzdHJpbmc7XG4gICAgYXBwcm92ZXJzPzogc3RyaW5nW107XG4gICAgbWV0YWRhdGE/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbiAgfSk6IEFwcHJvdmFsUmVxdWlyZWRPdXRwdXQge1xuICAgIHJldHVybiB7IHN0YXR1czogXCJBUFBST1ZBTF9SRVFVSVJFRFwiLCBhcHByb3ZhbFJlcXVlc3Q6IHJlcXVlc3QgfTtcbiAgfSxcblxuICAvLyBUcmlnZ2VyZWQgKHVzZWQgYnkgUG9sbGluZ1N0ZXAudHJpZ2dlcilcbiAgdHJpZ2dlcmVkPFRQb2xsaW5nU3RhdGU+KFxuICAgIHBvbGxpbmdTdGF0ZTogVFBvbGxpbmdTdGF0ZVxuICApOiBUcmlnZ2VyZWRPdXRwdXQ8VFBvbGxpbmdTdGF0ZT4ge1xuICAgIHJldHVybiB7IHN0YXR1czogXCJUUklHR0VSRURcIiwgcG9sbGluZ1N0YXRlIH07XG4gIH0sXG5cbiAgLy8gUG9sbCBhZ2FpbiAodXNlZCBieSBQb2xsaW5nU3RlcC5wb2xsKVxuICBwb2xsQWdhaW48VFBvbGxpbmdTdGF0ZT4oXG4gICAgcG9sbGluZ1N0YXRlOiBUUG9sbGluZ1N0YXRlLFxuICAgIHJldHJ5QWZ0ZXJNcz86IG51bWJlclxuICApOiBQb2xsQWdhaW5PdXRwdXQ8VFBvbGxpbmdTdGF0ZT4ge1xuICAgIHJldHVybiB7IHN0YXR1czogXCJQT0xMX0FHQUlOXCIsIHBvbGxpbmdTdGF0ZSwgcmV0cnlBZnRlck1zIH07XG4gIH0sXG59O1xuIl19

package/dist/registry/step-registry.d.ts

@@ -0,0 +1,93 @@
+import z from "zod";
+import type { StepClass } from "../base/base-step";
+export declare const StepRegistryInputSchema: z.ZodDiscriminatedUnion<"job", [z.ZodObject<{
+    job: z.ZodLiteral<"EXECUTE">;
+    type: z.ZodString;
+    params: z.ZodRecord<z.ZodString, z.ZodAny>;
+    approvalContext: z.ZodOptional<z.ZodObject<{
+        approved: z.ZodLiteral<true>;
+        approverId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        approved: true;
+        approverId: string;
+    }, {
+        approved: true;
+        approverId: string;
+    }>>;
+    pollingState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    params: Record<string, any>;
+    type: string;
+    job: "EXECUTE";
+    pollingState?: Record<string, any> | undefined;
+    approvalContext?: {
+        approved: true;
+        approverId: string;
+    } | undefined;
+}, {
+    params: Record<string, any>;
+    type: string;
+    job: "EXECUTE";
+    pollingState?: Record<string, any> | undefined;
+    approvalContext?: {
+        approved: true;
+        approverId: string;
+    } | undefined;
+}>, z.ZodObject<{
+    job: z.ZodLiteral<"SYNTHESIZE-METADATA">;
+}, "strip", z.ZodTypeAny, {
+    job: "SYNTHESIZE-METADATA";
+}, {
+    job: "SYNTHESIZE-METADATA";
+}>]>;
+export type StepRegistryInput = z.infer<typeof StepRegistryInputSchema>;
+export declare class StepRegistry {
+    private steps;
+    private outputPath;
+    private logDir;
+    private executionId;
+    private constructor();
+    /**
+     * Main entrypoint for running steps.
+     * Parses CLI args and either synthesizes metadata or executes a step.
+     *
+     * Usage in user's entrypoint file:
+     * ```
+     * StepRegistry.run([MyStep1, MyStep2, ...]);
+     * ```
+     *
+     * CLI arguments:
+     * - --input: JSON blob with job type and parameters
+     * - --output: Path to write output JSON (default: /tmp/step-output.json)
+     * - --log-dir: Directory for log files (default: /tmp/step-logs)
+     * - --execution-id: Unique ID for this execution (required for logging)
+     */
+    static run(steps: StepClass[]): Promise<void>;
+    private execute;
+    private synthesizeMetadata;
+    private executeStep;
+    private routeExecution;
+    /**
+     * Route SimpleStep execution based on approval state.
+     *
+     * | requiresApproval | approvalContext provided? | Action              |
+     * |------------------|---------------------------|---------------------|
+     * | No               | -                         | Call run(params)    |
+     * | Yes              | No                        | Call prepare(params)|
+     * | Yes              | Yes                       | Call run(params, approval) |
+     */
+    private routeSimpleStep;
+    /**
+     * Route PollingStep execution based on approval and polling state.
+     *
+     * | requiresApproval | approvalContext? | pollingState? | Action                        |
+     * |------------------|------------------|---------------|-------------------------------|
+     * | No               | -                | No            | Call trigger(params)          |
+     * | No               | -                | Yes           | Call poll(params, pollingState)|
+     * | Yes              | No               | No            | Call prepare(params)          |
+     * | Yes              | Yes              | No            | Call trigger(params, approval)|
+     * | Yes              | Yes              | Yes           | Call poll(params, pollingState)|
+     */
+    private routePollingStep;
+    private writeOutput;
+}