@pipeline-builder/pipeline-manager 0.0.1

package/dist/templates/token-renew-stack.json

@@ -0,0 +1,122 @@
+{
+  "AWSTemplateFormatVersion": "2010-09-09",
+  "Description": "Pipeline Builder platform-token renewal — a scheduled Lambda that re-mints the platform JWT in Secrets Manager before it expires, so CodeBuild/Lambda credentials never lapse. Lambda code is deployed separately via pipeline-manager infra store-token.",
+  "Parameters": {
+    "PlatformBaseUrl": {
+      "Type": "String",
+      "Description": "Base URL of the platform (e.g. https://app.example.com)"
+    },
+    "PlatformSecretName": {
+      "Type": "String",
+      "Description": "Secrets Manager secret name holding the platform JWT (e.g. pipeline-builder/{orgId}/platform)"
+    },
+    "RenewDays": {
+      "Type": "Number",
+      "Default": 30,
+      "MinValue": 1,
+      "MaxValue": 365,
+      "Description": "Lifetime in days requested for each renewed token"
+    },
+    "ScheduleExpression": {
+      "Type": "String",
+      "Default": "cron(0 0 * * ? *)",
+      "Description": "EventBridge schedule expression for the renewal (default: daily at 00:00 UTC)"
+    },
+    "PipelineManagerVersion": {
+      "Type": "String",
+      "Default": "latest",
+      "Description": "Version of @pipeline-builder/pipeline-manager the handler installs from npm at runtime (pin for reproducible renewals)"
+    },
+    "NameSuffix": {
+      "Type": "String",
+      "Default": "",
+      "Description": "Suffix appended to the renewal stack's resource names so a scoped-token renewal (e.g. '-reporting-ingest') coexists with the platform-token stack instead of clobbering its role/function/rule. Empty for the platform secret."
+    }
+  },
+  "Resources": {
+    "LambdaRole": {
+      "Type": "AWS::IAM::Role",
+      "Properties": {
+        "RoleName": { "Fn::Sub": "pipeline-builder-token-renew${NameSuffix}" },
+        "AssumeRolePolicyDocument": {
+          "Version": "2012-10-17",
+          "Statement": [{
+            "Effect": "Allow",
+            "Principal": { "Service": "lambda.amazonaws.com" },
+            "Action": "sts:AssumeRole"
+          }]
+        },
+        "ManagedPolicyArns": [
+          "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
+        ],
+        "Policies": [{
+          "PolicyName": "token-renew",
+          "PolicyDocument": {
+            "Statement": [{
+              "Effect": "Allow",
+              "Action": [
+                "secretsmanager:GetSecretValue",
+                "secretsmanager:PutSecretValue",
+                "secretsmanager:UpdateSecret",
+                "secretsmanager:DescribeSecret",
+                "secretsmanager:CreateSecret"
+              ],
+              "Resource": { "Fn::Sub": "arn:aws:secretsmanager:${AWS::Region}:${AWS::AccountId}:secret:pipeline-builder/*" }
+            }]
+          }
+        }]
+      }
+    },
+    "TokenRenewHandler": {
+      "Type": "AWS::Lambda::Function",
+      "Properties": {
+        "FunctionName": { "Fn::Sub": "pipeline-builder-token-renew${NameSuffix}" },
+        "Runtime": "nodejs24.x",
+        "Handler": "index.handler",
+        "Code": {
+          "ZipFile": "exports.handler=async()=>{console.log('Placeholder handler — run pipeline-manager infra store-token to deploy real code');return{statusCode:200}}"
+        },
+        "Role": { "Fn::GetAtt": ["LambdaRole", "Arn"] },
+        "Timeout": 300,
+        "MemorySize": 1024,
+        "EphemeralStorage": { "Size": 1024 },
+        "Environment": {
+          "Variables": {
+            "PLATFORM_BASE_URL": { "Ref": "PlatformBaseUrl" },
+            "PLATFORM_SECRET_NAME": { "Ref": "PlatformSecretName" },
+            "RENEW_DAYS": { "Ref": "RenewDays" },
+            "PIPELINE_MANAGER_VERSION": { "Ref": "PipelineManagerVersion" },
+            "NODE_ENV": "production"
+          }
+        }
+      }
+    },
+    "ScheduleRule": {
+      "Type": "AWS::Events::Rule",
+      "Properties": {
+        "Name": { "Fn::Sub": "pipeline-builder-token-renew${NameSuffix}" },
+        "Description": "Scheduled platform-token renewal",
+        "State": "ENABLED",
+        "ScheduleExpression": { "Ref": "ScheduleExpression" },
+        "Targets": [{
+          "Id": "token-renew-lambda",
+          "Arn": { "Fn::GetAtt": ["TokenRenewHandler", "Arn"] }
+        }]
+      }
+    },
+    "InvokePermission": {
+      "Type": "AWS::Lambda::Permission",
+      "Properties": {
+        "FunctionName": { "Ref": "TokenRenewHandler" },
+        "Action": "lambda:InvokeFunction",
+        "Principal": "events.amazonaws.com",
+        "SourceArn": { "Fn::GetAtt": ["ScheduleRule", "Arn"] }
+      }
+    }
+  },
+  "Outputs": {
+    "LambdaFunctionArn": { "Value": { "Fn::GetAtt": ["TokenRenewHandler", "Arn"] } },
+    "ScheduleRuleName": { "Value": { "Ref": "ScheduleRule" } },
+    "ScheduleExpression": { "Value": { "Ref": "ScheduleExpression" } }
+  }
+}

package/dist/types/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Platform API connection settings.
+ */
+export interface ApiConfig {
+    /** Base URL of the platform API (e.g., `https://api.example.com`). */
+    baseUrl: string;
+    /** Default request timeout in milliseconds. */
+    timeout?: number;
+    /** Extended timeout for plugin upload requests (large files). */
+    uploadTimeout?: number;
+    /** URL path for single-pipeline CRUD operations. */
+    pipelineUrl: string;
+    /** URL path for pipeline list/query operations. */
+    pipelineListUrl: string;
+    /** URL path for the golden-path pipeline-template catalog (list/get/instantiate). */
+    pipelineTemplateUrl: string;
+    /** URL path for single-plugin CRUD operations. */
+    pluginUrl: string;
+    /** URL path for plugin list/query operations. */
+    pluginListUrl: string;
+    /** URL path for plugin upload (multipart POST). */
+    pluginUploadUrl: string;
+    /** When `false`, disables TLS certificate verification. */
+    rejectUnauthorized?: boolean;
+}
+/**
+ * Authentication credentials for platform API access.
+ */
+export interface AuthConfig {
+    /** JWT bearer token obtained from the platform. */
+    token: string;
+}
+/**
+ * Complete CLI application configuration combining API and auth settings.
+ */
+export interface Config {
+    /** Platform API connection settings. */
+    api: ApiConfig;
+    /** Authentication credentials. */
+    auth: AuthConfig;
+}
+/**
+ * The narrow slice of {@link Config} the deploy/registry paths read off
+ * `client.getConfig()` — the pipeline endpoint + platform base URL. Named so the
+ * `deploy` and `create --deploy` flows share one shape instead of re-casting it.
+ */
+export interface PlatformDeployConfig {
+    api: {
+        pipelineUrl: string;
+        baseUrl: string;
+    };
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,GAAG,EAAE,SAAS,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C"}

package/dist/types/config.js

@@ -0,0 +1,4 @@
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3R5cGVzL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwrQ0FBK0M7QUFDL0Msc0NBQXNDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQ29weXJpZ2h0IDIwMjYgUGlwZWxpbmUgQnVpbGRlciBDb250cmlidXRvcnNcbi8vIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBBcGFjaGUtMi4wXG5cbi8qKlxuICogUGxhdGZvcm0gQVBJIGNvbm5lY3Rpb24gc2V0dGluZ3MuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQXBpQ29uZmlnIHtcbiAgLyoqIEJhc2UgVVJMIG9mIHRoZSBwbGF0Zm9ybSBBUEkgKGUuZy4sIGBodHRwczovL2FwaS5leGFtcGxlLmNvbWApLiAqL1xuICBiYXNlVXJsOiBzdHJpbmc7XG4gIC8qKiBEZWZhdWx0IHJlcXVlc3QgdGltZW91dCBpbiBtaWxsaXNlY29uZHMuICovXG4gIHRpbWVvdXQ/OiBudW1iZXI7XG4gIC8qKiBFeHRlbmRlZCB0aW1lb3V0IGZvciBwbHVnaW4gdXBsb2FkIHJlcXVlc3RzIChsYXJnZSBmaWxlcykuICovXG4gIHVwbG9hZFRpbWVvdXQ/OiBudW1iZXI7XG4gIC8qKiBVUkwgcGF0aCBmb3Igc2luZ2xlLXBpcGVsaW5lIENSVUQgb3BlcmF0aW9ucy4gKi9cbiAgcGlwZWxpbmVVcmw6IHN0cmluZztcbiAgLyoqIFVSTCBwYXRoIGZvciBwaXBlbGluZSBsaXN0L3F1ZXJ5IG9wZXJhdGlvbnMuICovXG4gIHBpcGVsaW5lTGlzdFVybDogc3RyaW5nO1xuICAvKiogVVJMIHBhdGggZm9yIHRoZSBnb2xkZW4tcGF0aCBwaXBlbGluZS10ZW1wbGF0ZSBjYXRhbG9nIChsaXN0L2dldC9pbnN0YW50aWF0ZSkuICovXG4gIHBpcGVsaW5lVGVtcGxhdGVVcmw6IHN0cmluZztcbiAgLyoqIFVSTCBwYXRoIGZvciBzaW5nbGUtcGx1Z2luIENSVUQgb3BlcmF0aW9ucy4gKi9cbiAgcGx1Z2luVXJsOiBzdHJpbmc7XG4gIC8qKiBVUkwgcGF0aCBmb3IgcGx1Z2luIGxpc3QvcXVlcnkgb3BlcmF0aW9ucy4gKi9cbiAgcGx1Z2luTGlzdFVybDogc3RyaW5nO1xuICAvKiogVVJMIHBhdGggZm9yIHBsdWdpbiB1cGxvYWQgKG11bHRpcGFydCBQT1NUKS4gKi9cbiAgcGx1Z2luVXBsb2FkVXJsOiBzdHJpbmc7XG4gIC8qKiBXaGVuIGBmYWxzZWAsIGRpc2FibGVzIFRMUyBjZXJ0aWZpY2F0ZSB2ZXJpZmljYXRpb24uICovXG4gIHJlamVjdFVuYXV0aG9yaXplZD86IGJvb2xlYW47XG59XG5cbi8qKlxuICogQXV0aGVudGljYXRpb24gY3JlZGVudGlhbHMgZm9yIHBsYXRmb3JtIEFQSSBhY2Nlc3MuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQXV0aENvbmZpZyB7XG4gIC8qKiBKV1QgYmVhcmVyIHRva2VuIG9idGFpbmVkIGZyb20gdGhlIHBsYXRmb3JtLiAqL1xuICB0b2tlbjogc3RyaW5nO1xufVxuXG4vKipcbiAqIENvbXBsZXRlIENMSSBhcHBsaWNhdGlvbiBjb25maWd1cmF0aW9uIGNvbWJpbmluZyBBUEkgYW5kIGF1dGggc2V0dGluZ3MuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29uZmlnIHtcbiAgLyoqIFBsYXRmb3JtIEFQSSBjb25uZWN0aW9uIHNldHRpbmdzLiAqL1xuICBhcGk6IEFwaUNvbmZpZztcbiAgLyoqIEF1dGhlbnRpY2F0aW9uIGNyZWRlbnRpYWxzLiAqL1xuICBhdXRoOiBBdXRoQ29uZmlnO1xufVxuXG4vKipcbiAqIFRoZSBuYXJyb3cgc2xpY2Ugb2Yge0BsaW5rIENvbmZpZ30gdGhlIGRlcGxveS9yZWdpc3RyeSBwYXRocyByZWFkIG9mZlxuICogYGNsaWVudC5nZXRDb25maWcoKWAg4oCUIHRoZSBwaXBlbGluZSBlbmRwb2ludCArIHBsYXRmb3JtIGJhc2UgVVJMLiBOYW1lZCBzbyB0aGVcbiAqIGBkZXBsb3lgIGFuZCBgY3JlYXRlIC0tZGVwbG95YCBmbG93cyBzaGFyZSBvbmUgc2hhcGUgaW5zdGVhZCBvZiByZS1jYXN0aW5nIGl0LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFBsYXRmb3JtRGVwbG95Q29uZmlnIHtcbiAgYXBpOiB7IHBpcGVsaW5lVXJsOiBzdHJpbmc7IGJhc2VVcmw6IHN0cmluZyB9O1xufVxuIl19

package/dist/types/error.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Numeric exit-code constants mapped to error categories.
+ * Used by {@link handleError} to set the process exit code.
+ */
+export declare const ERROR_CODES: {
+    readonly GENERAL: 1;
+    readonly VALIDATION: 2;
+    readonly API_REQUEST: 3;
+    readonly AUTHENTICATION: 4;
+    readonly AUTHORIZATION: 5;
+    readonly NOT_FOUND: 6;
+    readonly NETWORK: 7;
+    readonly CONFIGURATION: 8;
+    readonly FILE_SYSTEM: 9;
+    readonly TIMEOUT: 10;
+};
+/** Union of all valid error code values. */
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * Options controlling how {@link handleError} processes and reports an error.
+ */
+export interface ErrorHandlerOptions {
+    /** When `true`, prints full stack traces and internal details. */
+    debug?: boolean;
+    /** When `true`, calls `process.exit()` with the error code. */
+    exit?: boolean;
+    /** When `true`, logs the error to the console (defaults to `true`). */
+    logToConsole?: boolean;
+    /** Arbitrary key-value context attached to the error output for debugging. */
+    context?: Record<string, unknown>;
+    /** Request/execution correlation ID for log tracing. */
+    correlationId?: string;
+}
+/**
+ * Minimal Axios-compatible error shape used for duck-typing in error handlers.
+ */
+export interface AxiosErrorLike {
+    response?: {
+        status?: number;
+        statusText?: string;
+        data?: unknown;
+    };
+    config?: {
+        url?: string;
+        method?: string;
+        timeout?: number;
+    };
+    request?: unknown;
+    isAxiosError: true;
+}
+/**
+ * Typed API error with status, response, and Axios compatibility flag.
+ * Replaces `as any` casts in api-client.ts error handling.
+ */
+export declare class ApiError extends Error implements AxiosErrorLike {
+    status: number;
+    response: AxiosErrorLike['response'];
+    readonly isAxiosError: true;
+    constructor(message: string, status: number, response: AxiosErrorLike['response']);
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,WAAW;aACtB,OAAO,EAAE,CAAC;aACV,UAAU,EAAE,CAAC;aACb,WAAW,EAAE,CAAC;aACd,cAAc,EAAE,CAAC;aACjB,aAAa,EAAE,CAAC;aAChB,SAAS,EAAE,CAAC;aACZ,OAAO,EAAE,CAAC;aACV,aAAa,EAAE,CAAC;aAChB,WAAW,EAAE,CAAC;aACd,OAAO,EAAE,EAAE;CACH,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAM,YAAW,cAAc;IAKlD,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC;IAL7C,SAAgB,YAAY,OAAiB;IAE7C,YACE,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EAK5C;CACF"}

package/dist/types/error.js

@@ -0,0 +1,35 @@
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Numeric exit-code constants mapped to error categories.
+ * Used by {@link handleError} to set the process exit code.
+ */
+export const ERROR_CODES = {
+    GENERAL: 1,
+    VALIDATION: 2,
+    API_REQUEST: 3,
+    AUTHENTICATION: 4,
+    AUTHORIZATION: 5,
+    NOT_FOUND: 6,
+    NETWORK: 7,
+    CONFIGURATION: 8,
+    FILE_SYSTEM: 9,
+    TIMEOUT: 10,
+};
+/**
+ * Typed API error with status, response, and Axios compatibility flag.
+ * Replaces `as any` casts in api-client.ts error handling.
+ */
+export class ApiError extends Error {
+    status;
+    response;
+    isAxiosError = true;
+    constructor(message, status, response) {
+        super(message);
+        this.status = status;
+        this.response = response;
+        this.name = 'ApiError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvZXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsK0NBQStDO0FBQy9DLHNDQUFzQztBQUV0Qzs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxXQUFXLEdBQUc7SUFDekIsT0FBTyxFQUFFLENBQUM7SUFDVixVQUFVLEVBQUUsQ0FBQztJQUNiLFdBQVcsRUFBRSxDQUFDO0lBQ2QsY0FBYyxFQUFFLENBQUM7SUFDakIsYUFBYSxFQUFFLENBQUM7SUFDaEIsU0FBUyxFQUFFLENBQUM7SUFDWixPQUFPLEVBQUUsQ0FBQztJQUNWLGFBQWEsRUFBRSxDQUFDO0lBQ2hCLFdBQVcsRUFBRSxDQUFDO0lBQ2QsT0FBTyxFQUFFLEVBQUU7Q0FDSCxDQUFDO0FBdUNYOzs7R0FHRztBQUNILE1BQU0sT0FBTyxRQUFTLFNBQVEsS0FBSztJQUt4QixNQUFNO0lBQ04sUUFBUTtJQUxELFlBQVksR0FBRyxJQUFhLENBQUM7SUFFN0MsWUFDRSxPQUFlLEVBQ1IsTUFBYyxFQUNkLFFBQW9DO1FBRTNDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztzQkFIUixNQUFNO3dCQUNOLFFBQVE7UUFHZixJQUFJLENBQUMsSUFBSSxHQUFHLFVBQVUsQ0FBQztRQUN2QixLQUFLLENBQUMsaUJBQWlCLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUNsRCxDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBDb3B5cmlnaHQgMjAyNiBQaXBlbGluZSBCdWlsZGVyIENvbnRyaWJ1dG9yc1xuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcblxuLyoqXG4gKiBOdW1lcmljIGV4aXQtY29kZSBjb25zdGFudHMgbWFwcGVkIHRvIGVycm9yIGNhdGVnb3JpZXMuXG4gKiBVc2VkIGJ5IHtAbGluayBoYW5kbGVFcnJvcn0gdG8gc2V0IHRoZSBwcm9jZXNzIGV4aXQgY29kZS5cbiAqL1xuZXhwb3J0IGNvbnN0IEVSUk9SX0NPREVTID0ge1xuICBHRU5FUkFMOiAxLFxuICBWQUxJREFUSU9OOiAyLFxuICBBUElfUkVRVUVTVDogMyxcbiAgQVVUSEVOVElDQVRJT046IDQsXG4gIEFVVEhPUklaQVRJT046IDUsXG4gIE5PVF9GT1VORDogNixcbiAgTkVUV09SSzogNyxcbiAgQ09ORklHVVJBVElPTjogOCxcbiAgRklMRV9TWVNURU06IDksXG4gIFRJTUVPVVQ6IDEwLFxufSBhcyBjb25zdDtcblxuLyoqIFVuaW9uIG9mIGFsbCB2YWxpZCBlcnJvciBjb2RlIHZhbHVlcy4gKi9cbmV4cG9ydCB0eXBlIEVycm9yQ29kZSA9ICh0eXBlb2YgRVJST1JfQ09ERVMpW2tleW9mIHR5cGVvZiBFUlJPUl9DT0RFU107XG5cbi8qKlxuICogT3B0aW9ucyBjb250cm9sbGluZyBob3cge0BsaW5rIGhhbmRsZUVycm9yfSBwcm9jZXNzZXMgYW5kIHJlcG9ydHMgYW4gZXJyb3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRXJyb3JIYW5kbGVyT3B0aW9ucyB7XG4gIC8qKiBXaGVuIGB0cnVlYCwgcHJpbnRzIGZ1bGwgc3RhY2sgdHJhY2VzIGFuZCBpbnRlcm5hbCBkZXRhaWxzLiAqL1xuICBkZWJ1Zz86IGJvb2xlYW47XG4gIC8qKiBXaGVuIGB0cnVlYCwgY2FsbHMgYHByb2Nlc3MuZXhpdCgpYCB3aXRoIHRoZSBlcnJvciBjb2RlLiAqL1xuICBleGl0PzogYm9vbGVhbjtcbiAgLyoqIFdoZW4gYHRydWVgLCBsb2dzIHRoZSBlcnJvciB0byB0aGUgY29uc29sZSAoZGVmYXVsdHMgdG8gYHRydWVgKS4gKi9cbiAgbG9nVG9Db25zb2xlPzogYm9vbGVhbjtcbiAgLyoqIEFyYml0cmFyeSBrZXktdmFsdWUgY29udGV4dCBhdHRhY2hlZCB0byB0aGUgZXJyb3Igb3V0cHV0IGZvciBkZWJ1Z2dpbmcuICovXG4gIGNvbnRleHQ/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbiAgLyoqIFJlcXVlc3QvZXhlY3V0aW9uIGNvcnJlbGF0aW9uIElEIGZvciBsb2cgdHJhY2luZy4gKi9cbiAgY29ycmVsYXRpb25JZD86IHN0cmluZztcbn1cblxuLyoqXG4gKiBNaW5pbWFsIEF4aW9zLWNvbXBhdGlibGUgZXJyb3Igc2hhcGUgdXNlZCBmb3IgZHVjay10eXBpbmcgaW4gZXJyb3IgaGFuZGxlcnMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQXhpb3NFcnJvckxpa2Uge1xuICByZXNwb25zZT86IHtcbiAgICBzdGF0dXM/OiBudW1iZXI7XG4gICAgc3RhdHVzVGV4dD86IHN0cmluZztcbiAgICBkYXRhPzogdW5rbm93bjtcbiAgfTtcbiAgY29uZmlnPzoge1xuICAgIHVybD86IHN0cmluZztcbiAgICBtZXRob2Q/OiBzdHJpbmc7XG4gICAgdGltZW91dD86IG51bWJlcjtcbiAgfTtcbiAgcmVxdWVzdD86IHVua25vd247XG4gIGlzQXhpb3NFcnJvcjogdHJ1ZTtcbn1cblxuLyoqXG4gKiBUeXBlZCBBUEkgZXJyb3Igd2l0aCBzdGF0dXMsIHJlc3BvbnNlLCBhbmQgQXhpb3MgY29tcGF0aWJpbGl0eSBmbGFnLlxuICogUmVwbGFjZXMgYGFzIGFueWAgY2FzdHMgaW4gYXBpLWNsaWVudC50cyBlcnJvciBoYW5kbGluZy5cbiAqL1xuZXhwb3J0IGNsYXNzIEFwaUVycm9yIGV4dGVuZHMgRXJyb3IgaW1wbGVtZW50cyBBeGlvc0Vycm9yTGlrZSB7XG4gIHB1YmxpYyByZWFkb25seSBpc0F4aW9zRXJyb3IgPSB0cnVlIGFzIGNvbnN0O1xuXG4gIGNvbnN0cnVjdG9yKFxuICAgIG1lc3NhZ2U6IHN0cmluZyxcbiAgICBwdWJsaWMgc3RhdHVzOiBudW1iZXIsXG4gICAgcHVibGljIHJlc3BvbnNlOiBBeGlvc0Vycm9yTGlrZVsncmVzcG9uc2UnXSxcbiAgKSB7XG4gICAgc3VwZXIobWVzc2FnZSk7XG4gICAgdGhpcy5uYW1lID0gJ0FwaUVycm9yJztcbiAgICBFcnJvci5jYXB0dXJlU3RhY2tUcmFjZSh0aGlzLCB0aGlzLmNvbnN0cnVjdG9yKTtcbiAgfVxufVxuIl19

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Main type definitions export
+ */
+export * from './config.js';
+export * from './pipeline.js';
+export * from './pipeline-template.js';
+export * from './plugin.js';
+export * from './error.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,11 @@
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Main type definitions export
+ */
+export * from './config.js';
+export * from './pipeline.js';
+export * from './pipeline-template.js';
+export * from './plugin.js';
+export * from './error.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsK0NBQStDO0FBQy9DLHNDQUFzQztBQUV0Qzs7R0FFRztBQUVILGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxZQUFZLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBDb3B5cmlnaHQgMjAyNiBQaXBlbGluZSBCdWlsZGVyIENvbnRyaWJ1dG9yc1xuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcblxuLyoqXG4gKiBNYWluIHR5cGUgZGVmaW5pdGlvbnMgZXhwb3J0XG4gKi9cblxuZXhwb3J0ICogZnJvbSAnLi9jb25maWcuanMnO1xuZXhwb3J0ICogZnJvbSAnLi9waXBlbGluZS5qcyc7XG5leHBvcnQgKiBmcm9tICcuL3BpcGVsaW5lLXRlbXBsYXRlLmpzJztcbmV4cG9ydCAqIGZyb20gJy4vcGx1Z2luLmpzJztcbmV4cG9ydCAqIGZyb20gJy4vZXJyb3IuanMnO1xuIl19

package/dist/types/pipeline-template.d.ts

@@ -0,0 +1,48 @@
+import { type PipelineProps, type PipelineVisibility } from './pipeline.js';
+/**
+ * One declared template input. `name` is the `vars.<name>` key the template body
+ * references as `{{ pipeline.vars.<name> }}`.
+ */
+export interface TemplateInput {
+    name: string;
+    label?: string;
+    description?: string;
+    type: 'string' | 'number' | 'boolean';
+    required?: boolean;
+    default?: string | number | boolean;
+    options?: string[];
+}
+/**
+ * A golden-path pipeline template — a parameterized starting point whose `props`
+ * carry `{{ pipeline.vars.* }}` placeholders backed by {@link TemplateInput}s.
+ */
+export interface PipelineTemplate {
+    id: string;
+    name: string;
+    description?: string;
+    keywords?: string[];
+    category?: string;
+    visibility?: PipelineVisibility;
+    props: PipelineProps;
+    inputs?: TemplateInput[];
+    isActive?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** Request payload for `POST /api/pipeline-templates/:id/instantiate`. */
+export interface InstantiateTemplateRequest {
+    project: string;
+    organization: string;
+    pipelineName?: string;
+    inputs?: Record<string, string | number | boolean>;
+}
+/**
+ * Instantiate response. `props` is a concrete `BuilderProps` ready to hand to
+ * `pipeline create --file` — the endpoint only renders, it creates nothing.
+ */
+export interface InstantiateTemplateResponse {
+    props: PipelineProps;
+    description?: string;
+    keywords?: string[];
+}
+//# sourceMappingURL=pipeline-template.d.ts.map

package/dist/types/pipeline-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-template.d.ts","sourceRoot":"","sources":["../../src/types/pipeline-template.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0EAA0E;AAC1E,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/pipeline-template.js

@@ -0,0 +1,4 @@
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+import {} from './pipeline.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlwZWxpbmUtdGVtcGxhdGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvcGlwZWxpbmUtdGVtcGxhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsK0NBQStDO0FBQy9DLHNDQUFzQztBQUV0QyxPQUFPLEVBQStDLE1BQU0sZUFBZSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQ29weXJpZ2h0IDIwMjYgUGlwZWxpbmUgQnVpbGRlciBDb250cmlidXRvcnNcbi8vIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBBcGFjaGUtMi4wXG5cbmltcG9ydCB7IHR5cGUgUGlwZWxpbmVQcm9wcywgdHlwZSBQaXBlbGluZVZpc2liaWxpdHkgfSBmcm9tICcuL3BpcGVsaW5lLmpzJztcblxuLyoqXG4gKiBPbmUgZGVjbGFyZWQgdGVtcGxhdGUgaW5wdXQuIGBuYW1lYCBpcyB0aGUgYHZhcnMuPG5hbWU+YCBrZXkgdGhlIHRlbXBsYXRlIGJvZHlcbiAqIHJlZmVyZW5jZXMgYXMgYHt7IHBpcGVsaW5lLnZhcnMuPG5hbWU+IH19YC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUZW1wbGF0ZUlucHV0IHtcbiAgbmFtZTogc3RyaW5nO1xuICBsYWJlbD86IHN0cmluZztcbiAgZGVzY3JpcHRpb24/OiBzdHJpbmc7XG4gIHR5cGU6ICdzdHJpbmcnIHwgJ251bWJlcicgfCAnYm9vbGVhbic7XG4gIHJlcXVpcmVkPzogYm9vbGVhbjtcbiAgZGVmYXVsdD86IHN0cmluZyB8IG51bWJlciB8IGJvb2xlYW47XG4gIG9wdGlvbnM/OiBzdHJpbmdbXTtcbn1cblxuLyoqXG4gKiBBIGdvbGRlbi1wYXRoIHBpcGVsaW5lIHRlbXBsYXRlIOKAlCBhIHBhcmFtZXRlcml6ZWQgc3RhcnRpbmcgcG9pbnQgd2hvc2UgYHByb3BzYFxuICogY2FycnkgYHt7IHBpcGVsaW5lLnZhcnMuKiB9fWAgcGxhY2Vob2xkZXJzIGJhY2tlZCBieSB7QGxpbmsgVGVtcGxhdGVJbnB1dH1zLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFBpcGVsaW5lVGVtcGxhdGUge1xuICBpZDogc3RyaW5nO1xuICBuYW1lOiBzdHJpbmc7XG4gIGRlc2NyaXB0aW9uPzogc3RyaW5nO1xuICBrZXl3b3Jkcz86IHN0cmluZ1tdO1xuICBjYXRlZ29yeT86IHN0cmluZztcbiAgdmlzaWJpbGl0eT86IFBpcGVsaW5lVmlzaWJpbGl0eTtcbiAgcHJvcHM6IFBpcGVsaW5lUHJvcHM7XG4gIGlucHV0cz86IFRlbXBsYXRlSW5wdXRbXTtcbiAgaXNBY3RpdmU/OiBib29sZWFuO1xuICBjcmVhdGVkQXQ/OiBzdHJpbmc7XG4gIHVwZGF0ZWRBdD86IHN0cmluZztcbn1cblxuLyoqIFJlcXVlc3QgcGF5bG9hZCBmb3IgYFBPU1QgL2FwaS9waXBlbGluZS10ZW1wbGF0ZXMvOmlkL2luc3RhbnRpYXRlYC4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSW5zdGFudGlhdGVUZW1wbGF0ZVJlcXVlc3Qge1xuICBwcm9qZWN0OiBzdHJpbmc7XG4gIG9yZ2FuaXphdGlvbjogc3RyaW5nO1xuICBwaXBlbGluZU5hbWU/OiBzdHJpbmc7XG4gIGlucHV0cz86IFJlY29yZDxzdHJpbmcsIHN0cmluZyB8IG51bWJlciB8IGJvb2xlYW4+O1xufVxuXG4vKipcbiAqIEluc3RhbnRpYXRlIHJlc3BvbnNlLiBgcHJvcHNgIGlzIGEgY29uY3JldGUgYEJ1aWxkZXJQcm9wc2AgcmVhZHkgdG8gaGFuZCB0b1xuICogYHBpcGVsaW5lIGNyZWF0ZSAtLWZpbGVgIOKAlCB0aGUgZW5kcG9pbnQgb25seSByZW5kZXJzLCBpdCBjcmVhdGVzIG5vdGhpbmcuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSW5zdGFudGlhdGVUZW1wbGF0ZVJlc3BvbnNlIHtcbiAgcHJvcHM6IFBpcGVsaW5lUHJvcHM7XG4gIGRlc2NyaXB0aW9uPzogc3RyaW5nO1xuICBrZXl3b3Jkcz86IHN0cmluZ1tdO1xufVxuIl19

package/dist/types/pipeline.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Arbitrary key-value pipeline configuration properties
+ * passed through to the CDK builder.
+ */
+export type PipelineProps = Record<string, unknown>;
+/**
+ * Pipeline sharing rung — the platform-wide three-rung ladder.
+ * `private` is author-only, `org` is the whole owning org, `public` reaches the
+ * org's teams (and, from the system org, every org).
+ */
+export type PipelineVisibility = 'private' | 'org' | 'public';
+/**
+ * Core pipeline fields required on every pipeline record.
+ */
+export interface PipelineBase {
+    /**
+     * Unique pipeline identifier
+     */
+    id: string;
+    /**
+     * Project name
+     */
+    project: string;
+    /**
+     * Organization name
+     */
+    organization: string;
+    /**
+     * Tenant identifier (from API response, used for per-org secret resolution)
+     */
+    orgId?: string;
+    /**
+     * Pipeline properties/configuration
+     */
+    props: PipelineProps;
+}
+/**
+ * Optional metadata fields attached to a pipeline record.
+ */
+export interface PipelineMetadata {
+    /**
+     * Human-readable pipeline name
+     */
+    pipelineName?: string;
+    /**
+     * Sharing rung: 'private' | 'org' | 'public'.
+     */
+    visibility?: PipelineVisibility;
+    /**
+     * Whether this is the default pipeline
+     */
+    isDefault?: boolean;
+    /**
+     * Whether the pipeline is active
+     */
+    isActive?: boolean;
+    /**
+     * Pipeline creation timestamp
+     */
+    createdAt?: string;
+    /**
+     * Pipeline last update timestamp
+     */
+    updatedAt?: string;
+    /**
+     * User who created the pipeline
+     */
+    createdBy?: string;
+    /**
+     * User who last updated the pipeline
+     */
+    updatedBy?: string;
+}
+/**
+ * Complete pipeline entity combining core fields and metadata.
+ */
+export interface Pipeline extends PipelineBase, PipelineMetadata {
+}
+/**
+ * Request payload for creating a new pipeline via the platform API.
+ */
+export interface CreatePipelineRequest {
+    /**
+     * Project name
+     */
+    project: string;
+    /**
+     * Organization name
+     */
+    organization: string;
+    /**
+     * Pipeline properties/configuration
+     */
+    props: PipelineProps;
+    /**
+     * Human-readable pipeline name
+     */
+    pipelineName?: string;
+    /**
+     * Access modifier (public or private)
+     * @default 'private'
+     */
+    visibility?: PipelineVisibility;
+    /**
+     * Whether this is the default pipeline
+     * @default false
+     */
+    isDefault?: boolean;
+    /**
+     * Whether the pipeline is active
+     * @default true
+     */
+    isActive?: boolean;
+}
+/**
+ * Response returned by single-pipeline API endpoints (get, create).
+ */
+export interface PipelineResponse {
+    pipeline: Pipeline;
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY,EAAE,gBAAgB;CAAG;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAEhC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB"}

package/dist/types/pipeline.js

@@ -0,0 +1,4 @@
+// Copyright 2026 Pipeline Builder Contributors
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlwZWxpbmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvcGlwZWxpbmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsK0NBQStDO0FBQy9DLHNDQUFzQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIENvcHlyaWdodCAyMDI2IFBpcGVsaW5lIEJ1aWxkZXIgQ29udHJpYnV0b3JzXG4vLyBTUERYLUxpY2Vuc2UtSWRlbnRpZmllcjogQXBhY2hlLTIuMFxuXG4vKipcbiAqIEFyYml0cmFyeSBrZXktdmFsdWUgcGlwZWxpbmUgY29uZmlndXJhdGlvbiBwcm9wZXJ0aWVzXG4gKiBwYXNzZWQgdGhyb3VnaCB0byB0aGUgQ0RLIGJ1aWxkZXIuXG4gKi9cbmV4cG9ydCB0eXBlIFBpcGVsaW5lUHJvcHMgPSBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcblxuLyoqXG4gKiBQaXBlbGluZSBzaGFyaW5nIHJ1bmcg4oCUIHRoZSBwbGF0Zm9ybS13aWRlIHRocmVlLXJ1bmcgbGFkZGVyLlxuICogYHByaXZhdGVgIGlzIGF1dGhvci1vbmx5LCBgb3JnYCBpcyB0aGUgd2hvbGUgb3duaW5nIG9yZywgYHB1YmxpY2AgcmVhY2hlcyB0aGVcbiAqIG9yZydzIHRlYW1zIChhbmQsIGZyb20gdGhlIHN5c3RlbSBvcmcsIGV2ZXJ5IG9yZykuXG4gKi9cbmV4cG9ydCB0eXBlIFBpcGVsaW5lVmlzaWJpbGl0eSA9ICdwcml2YXRlJyB8ICdvcmcnIHwgJ3B1YmxpYyc7XG5cbi8qKlxuICogQ29yZSBwaXBlbGluZSBmaWVsZHMgcmVxdWlyZWQgb24gZXZlcnkgcGlwZWxpbmUgcmVjb3JkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFBpcGVsaW5lQmFzZSB7XG4gIC8qKlxuICAgKiBVbmlxdWUgcGlwZWxpbmUgaWRlbnRpZmllclxuICAgKi9cbiAgaWQ6IHN0cmluZztcblxuICAvKipcbiAgICogUHJvamVjdCBuYW1lXG4gICAqL1xuICBwcm9qZWN0OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIE9yZ2FuaXphdGlvbiBuYW1lXG4gICAqL1xuICBvcmdhbml6YXRpb246IHN0cmluZztcblxuICAvKipcbiAgICogVGVuYW50IGlkZW50aWZpZXIgKGZyb20gQVBJIHJlc3BvbnNlLCB1c2VkIGZvciBwZXItb3JnIHNlY3JldCByZXNvbHV0aW9uKVxuICAgKi9cbiAgb3JnSWQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFBpcGVsaW5lIHByb3BlcnRpZXMvY29uZmlndXJhdGlvblxuICAgKi9cbiAgcHJvcHM6IFBpcGVsaW5lUHJvcHM7XG59XG5cbi8qKlxuICogT3B0aW9uYWwgbWV0YWRhdGEgZmllbGRzIGF0dGFjaGVkIHRvIGEgcGlwZWxpbmUgcmVjb3JkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFBpcGVsaW5lTWV0YWRhdGEge1xuICAvKipcbiAgICogSHVtYW4tcmVhZGFibGUgcGlwZWxpbmUgbmFtZVxuICAgKi9cbiAgcGlwZWxpbmVOYW1lPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBTaGFyaW5nIHJ1bmc6ICdwcml2YXRlJyB8ICdvcmcnIHwgJ3B1YmxpYycuXG4gICAqL1xuICB2aXNpYmlsaXR5PzogUGlwZWxpbmVWaXNpYmlsaXR5O1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRoaXMgaXMgdGhlIGRlZmF1bHQgcGlwZWxpbmVcbiAgICovXG4gIGlzRGVmYXVsdD86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdGhlIHBpcGVsaW5lIGlzIGFjdGl2ZVxuICAgKi9cbiAgaXNBY3RpdmU/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBQaXBlbGluZSBjcmVhdGlvbiB0aW1lc3RhbXBcbiAgICovXG4gIGNyZWF0ZWRBdD86IHN0cmluZztcblxuICAvKipcbiAgICogUGlwZWxpbmUgbGFzdCB1cGRhdGUgdGltZXN0YW1wXG4gICAqL1xuICB1cGRhdGVkQXQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFVzZXIgd2hvIGNyZWF0ZWQgdGhlIHBpcGVsaW5lXG4gICAqL1xuICBjcmVhdGVkQnk/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFVzZXIgd2hvIGxhc3QgdXBkYXRlZCB0aGUgcGlwZWxpbmVcbiAgICovXG4gIHVwZGF0ZWRCeT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBDb21wbGV0ZSBwaXBlbGluZSBlbnRpdHkgY29tYmluaW5nIGNvcmUgZmllbGRzIGFuZCBtZXRhZGF0YS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQaXBlbGluZSBleHRlbmRzIFBpcGVsaW5lQmFzZSwgUGlwZWxpbmVNZXRhZGF0YSB7fVxuXG4vKipcbiAqIFJlcXVlc3QgcGF5bG9hZCBmb3IgY3JlYXRpbmcgYSBuZXcgcGlwZWxpbmUgdmlhIHRoZSBwbGF0Zm9ybSBBUEkuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ3JlYXRlUGlwZWxpbmVSZXF1ZXN0IHtcbiAgLyoqXG4gICAqIFByb2plY3QgbmFtZVxuICAgKi9cbiAgcHJvamVjdDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBPcmdhbml6YXRpb24gbmFtZVxuICAgKi9cbiAgb3JnYW5pemF0aW9uOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFBpcGVsaW5lIHByb3BlcnRpZXMvY29uZmlndXJhdGlvblxuICAgKi9cbiAgcHJvcHM6IFBpcGVsaW5lUHJvcHM7XG5cbiAgLyoqXG4gICAqIEh1bWFuLXJlYWRhYmxlIHBpcGVsaW5lIG5hbWVcbiAgICovXG4gIHBpcGVsaW5lTmFtZT86IHN0cmluZztcblxuICAvKipcbiAgICogQWNjZXNzIG1vZGlmaWVyIChwdWJsaWMgb3IgcHJpdmF0ZSlcbiAgICogQGRlZmF1bHQgJ3ByaXZhdGUnXG4gICAqL1xuICB2aXNpYmlsaXR5PzogUGlwZWxpbmVWaXNpYmlsaXR5O1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRoaXMgaXMgdGhlIGRlZmF1bHQgcGlwZWxpbmVcbiAgICogQGRlZmF1bHQgZmFsc2VcbiAgICovXG4gIGlzRGVmYXVsdD86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdGhlIHBpcGVsaW5lIGlzIGFjdGl2ZVxuICAgKiBAZGVmYXVsdCB0cnVlXG4gICAqL1xuICBpc0FjdGl2ZT86IGJvb2xlYW47XG59XG5cbi8qKlxuICogUmVzcG9uc2UgcmV0dXJuZWQgYnkgc2luZ2xlLXBpcGVsaW5lIEFQSSBlbmRwb2ludHMgKGdldCwgY3JlYXRlKS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQaXBlbGluZVJlc3BvbnNlIHtcbiAgcGlwZWxpbmU6IFBpcGVsaW5lO1xufVxuIl19

package/dist/types/plugin.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Package-level metadata extracted from the plugin archive.
+ */
+export interface PluginMetadata {
+    /**
+     * Plugin name
+     */
+    name: string;
+    /**
+     * Plugin version
+     */
+    version: string;
+    /**
+     * Plugin description
+     */
+    description?: string;
+    /**
+     * Plugin author
+     */
+    author?: string;
+    /**
+     * Plugin license
+     */
+    license?: string;
+    /**
+     * Plugin homepage URL
+     */
+    homepage?: string;
+    /**
+     * Plugin repository URL
+     */
+    repository?: string;
+    /**
+     * Plugin keywords/tags
+     */
+    keywords?: string[];
+    /**
+     * Plugin dependencies
+     */
+    dependencies?: Record<string, string>;
+}
+/**
+ * Runtime configuration for a plugin, including its entry point and schema.
+ */
+export interface PluginConfig {
+    /**
+     * Plugin entry point
+     */
+    main?: string;
+    /**
+     * Plugin configuration schema
+     */
+    schema?: Record<string, unknown>;
+    /**
+     * Plugin default configuration
+     */
+    defaults?: Record<string, unknown>;
+}
+/**
+ * Core plugin fields required on every plugin record.
+ */
+export interface PluginBase {
+    /**
+     * Unique plugin identifier
+     */
+    id: string;
+    /**
+     * Plugin name
+     */
+    name: string;
+    /**
+     * Plugin version
+     */
+    version: string;
+    /**
+     * Organization that owns the plugin
+     */
+    organization: string;
+}
+/**
+ * Complete plugin entity combining core fields with optional detail fields.
+ */
+export interface Plugin extends PluginBase {
+    /**
+     * Plugin description
+     */
+    description?: string;
+    /**
+     * Plugin metadata
+     */
+    metadata?: PluginMetadata;
+    /**
+     * Plugin configuration
+     */
+    config?: PluginConfig;
+    /**
+     * Plugin file URL
+     */
+    fileUrl?: string;
+    /**
+     * Plugin file size in bytes
+     */
+    fileSize?: number;
+    /**
+     * Plugin checksum (SHA256)
+     */
+    checksum?: string;
+    /**
+     * Whether the plugin is active
+     */
+    isActive?: boolean;
+    /**
+     * Whether the plugin is public
+     */
+    isPublic?: boolean;
+    /**
+     * Plugin creation timestamp
+     */
+    createdAt?: string;
+    /**
+     * Plugin last update timestamp
+     */
+    updatedAt?: string;
+    /**
+     * User who uploaded the plugin
+     */
+    uploadedBy?: string;
+}
+/**
+ * Response returned by single-plugin API endpoints (get, upload).
+ */
+export interface PluginResponse {
+    plugin: Plugin;
+}
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB"}