@veltrixsecops/app-sdk 1.0.0

package/dist/index-CKeIf4Jx.d.ts

@@ -0,0 +1,239 @@
+interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+interface ValidationWarning {
+    field: string;
+    message: string;
+    code: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+interface DeployResult {
+    success: boolean;
+    message: string;
+    artifacts?: Record<string, unknown>;
+    rollbackData?: unknown;
+}
+interface RollbackResult {
+    success: boolean;
+    message: string;
+}
+interface HealthCheck {
+    name: string;
+    passed: boolean;
+    message: string;
+    latencyMs?: number;
+}
+interface HealthCheckResult {
+    healthy: boolean;
+    score: number;
+    checks: HealthCheck[];
+}
+interface DriftDiff {
+    field: string;
+    expected: unknown;
+    actual: unknown;
+    severity: 'info' | 'warning' | 'critical';
+}
+interface DriftResult {
+    hasDrift: boolean;
+    diffs: DriftDiff[];
+}
+interface ComponentConfigStatus {
+    componentId: string;
+    hostname: string;
+    deployed: boolean;
+    version?: string;
+    lastDeployedAt?: string;
+    healthy?: boolean;
+    healthScore?: number;
+}
+interface ConfigStatus {
+    deployed: boolean;
+    version: string;
+    lastDeployedAt: string;
+    componentStatuses: ComponentConfigStatus[];
+}
+interface CanvasSectionSnapshot {
+    name: string;
+    fields: Record<string, unknown>;
+}
+interface CanvasSnapshot {
+    id: string;
+    canvasId: string;
+    version: number;
+    name: string;
+    toolType: string;
+    entityType: string;
+    sections: CanvasSectionSnapshot[];
+    snapshot: Record<string, unknown>;
+}
+type DeploymentStrategy = 'DIRECT' | 'CANARY' | 'BLUE_GREEN' | 'ROLLING';
+interface EnvironmentRef {
+    id: string;
+    name: string;
+}
+interface UserRef {
+    id: string;
+    email: string;
+    name: string | null;
+}
+interface ComponentRef {
+    id: string;
+    hostname: string;
+    port: string;
+    type: string[];
+    toolId: string;
+}
+interface CredentialRef {
+    id: string;
+    name: string;
+    username: string;
+    password: string;
+    apiToken: string | null;
+    certificate: string | null;
+}
+interface ConnectivityRef {
+    id: string;
+    status: string;
+    sshCommand: string | null;
+    httpsUrl: string | null;
+    tailscaleDeviceIP: string | null;
+}
+/** Provider-aware connectivity passed to handlers when a ConnectivityProvider is configured */
+interface ConnectivityProviderRef {
+    id: string;
+    providerType: string;
+    name: string;
+    status: string;
+    config: Record<string, unknown>;
+}
+/** Summary of a deployment record, returned by PlatformDataApi */
+interface DeploymentSummary {
+    id: string;
+    canvasId: string;
+    status: string;
+    healthScore: number | null;
+    startedAt: string;
+    completedAt: string | null;
+    environment: EnvironmentRef;
+}
+/**
+ * Tenant-scoped, read-only access to platform data, provided on every
+ * handler context as `ctx.platform`. Apps must use this instead of
+ * querying the platform database directly — it is the only supported
+ * way to read platform records from an app.
+ */
+interface PlatformDataApi {
+    /** Latest deployment for a canvas, optionally filtered by status (e.g. 'SUCCEEDED'). */
+    getLatestDeployment(canvasId: string, opts?: {
+        status?: string;
+    }): Promise<DeploymentSummary | null>;
+    /** Components for the current customer, optionally filtered by component types. */
+    listComponents(filter?: {
+        types?: string[];
+    }): Promise<ComponentRef[]>;
+}
+interface PipelineContext {
+    appId: string;
+    customerId: string;
+    configTypeId: string;
+    canvas: CanvasSnapshot;
+    environment: EnvironmentRef;
+    user: UserRef;
+    settings: Record<string, unknown>;
+    platform: PlatformDataApi;
+}
+interface DeployContext extends PipelineContext {
+    component: ComponentRef;
+    credential: CredentialRef | null;
+    connectivity: ConnectivityRef | null;
+    connectivityProvider: ConnectivityProviderRef | null;
+    previousConfig: CanvasSnapshot | null;
+    strategy: DeploymentStrategy;
+    canaryPercent?: number;
+}
+interface RollbackContext extends PipelineContext {
+    component: ComponentRef;
+    credential: CredentialRef | null;
+    connectivity: ConnectivityRef | null;
+    connectivityProvider: ConnectivityProviderRef | null;
+    rollbackData: unknown;
+    targetVersion: CanvasSnapshot;
+}
+interface HealthCheckContext extends PipelineContext {
+    component: ComponentRef;
+    credential: CredentialRef | null;
+    connectivity: ConnectivityRef | null;
+    connectivityProvider: ConnectivityProviderRef | null;
+}
+interface DriftContext extends PipelineContext {
+    component: ComponentRef;
+    credential: CredentialRef | null;
+    connectivity: ConnectivityRef | null;
+    connectivityProvider: ConnectivityProviderRef | null;
+    deployedConfig: CanvasSnapshot;
+}
+type ValidateHandler = (ctx: PipelineContext) => Promise<ValidationResult>;
+type DeployHandler = (ctx: DeployContext) => Promise<DeployResult>;
+type RollbackHandler = (ctx: RollbackContext) => Promise<RollbackResult>;
+type HealthCheckHandler = (ctx: HealthCheckContext) => Promise<HealthCheckResult>;
+type DriftDetectHandler = (ctx: DriftContext) => Promise<DriftResult>;
+type GetStatusHandler = (ctx: PipelineContext) => Promise<ConfigStatus>;
+
+/**
+ * Define a validation handler for a configuration type.
+ *
+ * @example
+ * ```ts
+ * import { defineValidator } from '@veltrixsecops/app-sdk/pipeline'
+ *
+ * export default defineValidator(async (ctx) => {
+ *   const errors = []
+ *   const name = ctx.canvas.sections[0]?.fields['name']
+ *   if (!name) {
+ *     errors.push({ field: 'name', message: 'Name is required', code: 'REQUIRED' })
+ *   }
+ *   return { valid: errors.length === 0, errors, warnings: [] }
+ * })
+ * ```
+ */
+declare function defineValidator(handler: (ctx: PipelineContext) => Promise<ValidationResult>): (ctx: PipelineContext) => Promise<ValidationResult>;
+
+/**
+ * Define a deploy handler for a configuration type.
+ *
+ * @example
+ * ```ts
+ * import { defineDeployer } from '@veltrixsecops/app-sdk/pipeline'
+ *
+ * export default defineDeployer(async (ctx) => {
+ *   const { component, credential, connectivity, canvas } = ctx
+ *   // Push configuration to the tool
+ *   return { success: true, message: 'Deployed', rollbackData: previousState }
+ * })
+ * ```
+ */
+declare function defineDeployer(handler: (ctx: DeployContext) => Promise<DeployResult>): (ctx: DeployContext) => Promise<DeployResult>;
+
+/**
+ * Define a rollback handler for a configuration type.
+ */
+declare function defineRollbackHandler(handler: (ctx: RollbackContext) => Promise<RollbackResult>): (ctx: RollbackContext) => Promise<RollbackResult>;
+
+/**
+ * Define a health check handler for a configuration type.
+ */
+declare function defineHealthChecker(handler: (ctx: HealthCheckContext) => Promise<HealthCheckResult>): (ctx: HealthCheckContext) => Promise<HealthCheckResult>;
+
+/**
+ * Define a drift detection handler for a configuration type.
+ */
+declare function defineDriftDetector(handler: (ctx: DriftContext) => Promise<DriftResult>): (ctx: DriftContext) => Promise<DriftResult>;
+
+export { defineHealthChecker as A, defineRollbackHandler as B, type CanvasSectionSnapshot as C, type DeployContext as D, type EnvironmentRef as E, defineValidator as F, type GetStatusHandler as G, type HealthCheck as H, type PipelineContext as P, type RollbackContext as R, type UserRef as U, type ValidateHandler as V, type CanvasSnapshot as a, type ComponentConfigStatus as b, type ComponentRef as c, type ConfigStatus as d, type ConnectivityProviderRef as e, type ConnectivityRef as f, type CredentialRef as g, type DeployHandler as h, type DeployResult as i, type DeploymentStrategy as j, type DeploymentSummary as k, type DriftContext as l, type DriftDetectHandler as m, type DriftDiff as n, type DriftResult as o, type HealthCheckContext as p, type HealthCheckHandler as q, type HealthCheckResult as r, type PlatformDataApi as s, type RollbackHandler as t, type RollbackResult as u, type ValidationError as v, type ValidationResult as w, type ValidationWarning as x, defineDeployer as y, defineDriftDetector as z };

package/dist/index.cjs

@@ -0,0 +1,106 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AppContext: () => AppContext,
+  defineDeployer: () => defineDeployer,
+  defineDriftDetector: () => defineDriftDetector,
+  defineHealthChecker: () => defineHealthChecker,
+  defineRollbackHandler: () => defineRollbackHandler,
+  defineValidator: () => defineValidator,
+  useAppContext: () => useAppContext,
+  usePipelineStatus: () => usePipelineStatus
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/pipeline/define-validator.ts
+function defineValidator(handler) {
+  return handler;
+}
+
+// src/pipeline/define-deployer.ts
+function defineDeployer(handler) {
+  return handler;
+}
+
+// src/pipeline/define-rollback-handler.ts
+function defineRollbackHandler(handler) {
+  return handler;
+}
+
+// src/pipeline/define-health-checker.ts
+function defineHealthChecker(handler) {
+  return handler;
+}
+
+// src/pipeline/define-drift-detector.ts
+function defineDriftDetector(handler) {
+  return handler;
+}
+
+// src/hooks/use-app-context.ts
+var import_react = require("react");
+var AppContext = (0, import_react.createContext)(null);
+function useAppContext() {
+  const ctx = (0, import_react.useContext)(AppContext);
+  if (!ctx) {
+    throw new Error("useAppContext must be used within an AppContextProvider");
+  }
+  return ctx;
+}
+
+// src/hooks/use-pipeline-status.ts
+var import_react2 = require("react");
+function usePipelineStatus(appId) {
+  const [data, setData] = (0, import_react2.useState)(null);
+  const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const refresh = (0, import_react2.useCallback)(async () => {
+    try {
+      setIsLoading(true);
+      const response = await fetch(`/api/pipeline/summary?appId=${appId}`);
+      if (!response.ok) throw new Error(`Failed to fetch pipeline status`);
+      const result = await response.json();
+      setData(result);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [appId]);
+  (0, import_react2.useEffect)(() => {
+    refresh();
+  }, [refresh]);
+  return { data, isLoading, error, refresh };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AppContext,
+  defineDeployer,
+  defineDriftDetector,
+  defineHealthChecker,
+  defineRollbackHandler,
+  defineValidator,
+  useAppContext,
+  usePipelineStatus
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/pipeline/define-validator.ts","../src/pipeline/define-deployer.ts","../src/pipeline/define-rollback-handler.ts","../src/pipeline/define-health-checker.ts","../src/pipeline/define-drift-detector.ts","../src/hooks/use-app-context.ts","../src/hooks/use-pipeline-status.ts"],"sourcesContent":["// ========================================================================\n// @veltrixsecops/app-sdk\n//\n// The official SDK for building Veltrix Security-as-Code apps.\n// Import pipeline helpers, hooks, and types to build your app.\n//\n// Usage:\n//   import { defineValidator, defineDeployer } from '@veltrixsecops/app-sdk/pipeline'\n//   import { useAppContext, usePipelineStatus } from '@veltrixsecops/app-sdk/hooks'\n//   import type { PipelineContext, DeployContext } from '@veltrixsecops/app-sdk'\n// ========================================================================\n\n// Pipeline handler helpers\nexport {\n  defineValidator,\n  defineDeployer,\n  defineRollbackHandler,\n  defineHealthChecker,\n  defineDriftDetector,\n} from './pipeline'\n\n// React hooks\nexport {\n  useAppContext,\n  AppContext,\n  usePipelineStatus,\n} from './hooks'\n\n// Pipeline types\nexport type {\n  PipelineContext,\n  DeployContext,\n  RollbackContext,\n  HealthCheckContext,\n  DriftContext,\n  ValidationResult,\n  ValidationError,\n  ValidationWarning,\n  DeployResult,\n  RollbackResult,\n  HealthCheckResult,\n  HealthCheck,\n  DriftResult,\n  DriftDiff,\n  ConfigStatus,\n  ComponentConfigStatus,\n  CanvasSnapshot,\n  CanvasSectionSnapshot,\n  DeploymentStrategy,\n  EnvironmentRef,\n  UserRef,\n  ComponentRef,\n  CredentialRef,\n  ConnectivityRef,\n  ConnectivityProviderRef,\n  PlatformDataApi,\n  DeploymentSummary,\n  ValidateHandler,\n  DeployHandler,\n  RollbackHandler,\n  HealthCheckHandler,\n  DriftDetectHandler,\n  GetStatusHandler,\n} from './types/pipeline'\n\n// Platform types\nexport type {\n  Component,\n  Credential,\n  Connectivity,\n  Tag,\n  User,\n  Customer,\n  PlatformDatabaseClient,\n  AppHookContext,\n  AppRouteContext,\n} from './types/platform'\n\n// Manifest types\nexport type {\n  AppManifest,\n  AppConfigurationTypeManifest,\n  AppPermissionDeclaration,\n  AppPageDeclaration,\n  AppSettingDeclaration,\n  AppSource,\n  AppStatusType,\n  AppInstallationStatus,\n  AppListItem,\n  AppDetail,\n  AppInstallationDetail,\n} from './types/manifest'\n\n// Hooks types\nexport type { AppContextValue, PipelineStatusData } from './hooks'\n","import type { PipelineContext, ValidationResult } from '../types/pipeline'\n\n/**\n * Define a validation handler for a configuration type.\n *\n * @example\n * ```ts\n * import { defineValidator } from '@veltrixsecops/app-sdk/pipeline'\n *\n * export default defineValidator(async (ctx) => {\n *   const errors = []\n *   const name = ctx.canvas.sections[0]?.fields['name']\n *   if (!name) {\n *     errors.push({ field: 'name', message: 'Name is required', code: 'REQUIRED' })\n *   }\n *   return { valid: errors.length === 0, errors, warnings: [] }\n * })\n * ```\n */\nexport function defineValidator(\n  handler: (ctx: PipelineContext) => Promise<ValidationResult>,\n): (ctx: PipelineContext) => Promise<ValidationResult> {\n  return handler\n}\n","import type { DeployContext, DeployResult } from '../types/pipeline'\n\n/**\n * Define a deploy handler for a configuration type.\n *\n * @example\n * ```ts\n * import { defineDeployer } from '@veltrixsecops/app-sdk/pipeline'\n *\n * export default defineDeployer(async (ctx) => {\n *   const { component, credential, connectivity, canvas } = ctx\n *   // Push configuration to the tool\n *   return { success: true, message: 'Deployed', rollbackData: previousState }\n * })\n * ```\n */\nexport function defineDeployer(\n  handler: (ctx: DeployContext) => Promise<DeployResult>,\n): (ctx: DeployContext) => Promise<DeployResult> {\n  return handler\n}\n","import type { RollbackContext, RollbackResult } from '../types/pipeline'\r\n\r\n/**\r\n * Define a rollback handler for a configuration type.\r\n */\r\nexport function defineRollbackHandler(\r\n  handler: (ctx: RollbackContext) => Promise<RollbackResult>,\r\n): (ctx: RollbackContext) => Promise<RollbackResult> {\r\n  return handler\r\n}\r\n","import type { HealthCheckContext, HealthCheckResult } from '../types/pipeline'\r\n\r\n/**\r\n * Define a health check handler for a configuration type.\r\n */\r\nexport function defineHealthChecker(\r\n  handler: (ctx: HealthCheckContext) => Promise<HealthCheckResult>,\r\n): (ctx: HealthCheckContext) => Promise<HealthCheckResult> {\r\n  return handler\r\n}\r\n","import type { DriftContext, DriftResult } from '../types/pipeline'\r\n\r\n/**\r\n * Define a drift detection handler for a configuration type.\r\n */\r\nexport function defineDriftDetector(\r\n  handler: (ctx: DriftContext) => Promise<DriftResult>,\r\n): (ctx: DriftContext) => Promise<DriftResult> {\r\n  return handler\r\n}\r\n","// ========================================================================\n// React hooks for app developers\n// These provide access to platform data and pipeline state\n// ========================================================================\n\nimport { createContext, useContext } from 'react'\nimport type { Component, Credential, Tag, User, Customer } from '../types/platform'\n\nexport interface AppContextValue {\n  appId: string\n  customerId: string\n  user: User | null\n  customer: Customer | null\n\n  // Platform data accessors\n  getComponents: () => Promise<Component[]>\n  getCredentials: () => Promise<Credential[]>\n  getTags: () => Promise<Tag[]>\n\n  // App settings\n  settings: Record<string, unknown>\n}\n\nexport const AppContext = createContext<AppContextValue | null>(null)\n\n/**\n * Access the app context in any app component.\n *\n * @example\n * ```tsx\n * import { useAppContext } from '@veltrixsecops/app-sdk/hooks'\n *\n * function MyComponent() {\n *   const { appId, settings, getComponents } = useAppContext()\n *   // ...\n * }\n * ```\n */\nexport function useAppContext(): AppContextValue {\n  const ctx = useContext(AppContext)\n  if (!ctx) {\n    throw new Error('useAppContext must be used within an AppContextProvider')\n  }\n  return ctx\n}\n","import { useState, useEffect, useCallback } from 'react'\n\nexport interface PipelineStatusData {\n  pendingApprovals: number\n  activeDeployments: number\n  failedDeployments: number\n  unresolvedDrifts: number\n  recentDeployments: Array<{\n    id: string\n    canvasName: string\n    environment: string\n    status: string\n    startedAt: string\n    completedAt?: string\n  }>\n}\n\n/**\n * Hook to access pipeline status for the current app/customer.\n *\n * @example\n * ```tsx\n * import { usePipelineStatus } from '@veltrixsecops/app-sdk/hooks'\n *\n * function Dashboard() {\n *   const { data, isLoading } = usePipelineStatus('my-app')\n *   if (isLoading) return <Spinner />\n *   return <div>{data.activeDeployments} active deployments</div>\n * }\n * ```\n */\nexport function usePipelineStatus(appId: string) {\n  const [data, setData] = useState<PipelineStatusData | null>(null)\n  const [isLoading, setIsLoading] = useState(true)\n  const [error, setError] = useState<Error | null>(null)\n\n  const refresh = useCallback(async () => {\n    try {\n      setIsLoading(true)\n      const response = await fetch(`/api/pipeline/summary?appId=${appId}`)\n      if (!response.ok) throw new Error(`Failed to fetch pipeline status`)\n      const result = await response.json()\n      setData(result)\n      setError(null)\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error('Unknown error'))\n    } finally {\n      setIsLoading(false)\n    }\n  }, [appId])\n\n  useEffect(() => {\n    refresh()\n  }, [refresh])\n\n  return { data, isLoading, error, refresh }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmBO,SAAS,gBACd,SACqD;AACrD,SAAO;AACT;;;ACPO,SAAS,eACd,SAC+C;AAC/C,SAAO;AACT;;;ACfO,SAAS,sBACd,SACmD;AACnD,SAAO;AACT;;;ACJO,SAAS,oBACd,SACyD;AACzD,SAAO;AACT;;;ACJO,SAAS,oBACd,SAC6C;AAC7C,SAAO;AACT;;;ACJA,mBAA0C;AAkBnC,IAAM,iBAAa,4BAAsC,IAAI;AAe7D,SAAS,gBAAiC;AAC/C,QAAM,UAAM,yBAAW,UAAU;AACjC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AACA,SAAO;AACT;;;AC5CA,IAAAA,gBAAiD;AA+B1C,SAAS,kBAAkB,OAAe;AAC/C,QAAM,CAAC,MAAM,OAAO,QAAI,wBAAoC,IAAI;AAChE,QAAM,CAAC,WAAW,YAAY,QAAI,wBAAS,IAAI;AAC/C,QAAM,CAAC,OAAO,QAAQ,QAAI,wBAAuB,IAAI;AAErD,QAAM,cAAU,2BAAY,YAAY;AACtC,QAAI;AACF,mBAAa,IAAI;AACjB,YAAM,WAAW,MAAM,MAAM,+BAA+B,KAAK,EAAE;AACnE,UAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,iCAAiC;AACnE,YAAM,SAAS,MAAM,SAAS,KAAK;AACnC,cAAQ,MAAM;AACd,eAAS,IAAI;AAAA,IACf,SAAS,KAAK;AACZ,eAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,eAAe,CAAC;AAAA,IAClE,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,KAAK,CAAC;AAEV,+BAAU,MAAM;AACd,YAAQ;AAAA,EACV,GAAG,CAAC,OAAO,CAAC;AAEZ,SAAO,EAAE,MAAM,WAAW,OAAO,QAAQ;AAC3C;","names":["import_react"]}

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+export { C as CanvasSectionSnapshot, a as CanvasSnapshot, b as ComponentConfigStatus, c as ComponentRef, d as ConfigStatus, e as ConnectivityProviderRef, f as ConnectivityRef, g as CredentialRef, D as DeployContext, h as DeployHandler, i as DeployResult, j as DeploymentStrategy, k as DeploymentSummary, l as DriftContext, m as DriftDetectHandler, n as DriftDiff, o as DriftResult, E as EnvironmentRef, G as GetStatusHandler, H as HealthCheck, p as HealthCheckContext, q as HealthCheckHandler, r as HealthCheckResult, P as PipelineContext, s as PlatformDataApi, R as RollbackContext, t as RollbackHandler, u as RollbackResult, U as UserRef, V as ValidateHandler, v as ValidationError, w as ValidationResult, x as ValidationWarning, y as defineDeployer, z as defineDriftDetector, A as defineHealthChecker, B as defineRollbackHandler, F as defineValidator } from './index-CKeIf4Jx.cjs';
+export { A as AppConfigurationTypeManifest, a as AppContext, b as AppContextValue, c as AppDetail, d as AppHookContext, e as AppInstallationDetail, f as AppInstallationStatus, g as AppListItem, h as AppManifest, i as AppPageDeclaration, j as AppPermissionDeclaration, k as AppRouteContext, l as AppSettingDeclaration, m as AppSource, n as AppStatusType, C as Component, o as Connectivity, p as Credential, q as Customer, P as PipelineStatusData, r as PlatformDatabaseClient, T as Tag, U as User, u as useAppContext, s as usePipelineStatus } from './index-BI8f_mBw.cjs';
+import 'react';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { C as CanvasSectionSnapshot, a as CanvasSnapshot, b as ComponentConfigStatus, c as ComponentRef, d as ConfigStatus, e as ConnectivityProviderRef, f as ConnectivityRef, g as CredentialRef, D as DeployContext, h as DeployHandler, i as DeployResult, j as DeploymentStrategy, k as DeploymentSummary, l as DriftContext, m as DriftDetectHandler, n as DriftDiff, o as DriftResult, E as EnvironmentRef, G as GetStatusHandler, H as HealthCheck, p as HealthCheckContext, q as HealthCheckHandler, r as HealthCheckResult, P as PipelineContext, s as PlatformDataApi, R as RollbackContext, t as RollbackHandler, u as RollbackResult, U as UserRef, V as ValidateHandler, v as ValidationError, w as ValidationResult, x as ValidationWarning, y as defineDeployer, z as defineDriftDetector, A as defineHealthChecker, B as defineRollbackHandler, F as defineValidator } from './index-CKeIf4Jx.js';
+export { A as AppConfigurationTypeManifest, a as AppContext, b as AppContextValue, c as AppDetail, d as AppHookContext, e as AppInstallationDetail, f as AppInstallationStatus, g as AppListItem, h as AppManifest, i as AppPageDeclaration, j as AppPermissionDeclaration, k as AppRouteContext, l as AppSettingDeclaration, m as AppSource, n as AppStatusType, C as Component, o as Connectivity, p as Credential, q as Customer, P as PipelineStatusData, r as PlatformDatabaseClient, T as Tag, U as User, u as useAppContext, s as usePipelineStatus } from './index-BI8f_mBw.js';
+import 'react';

package/dist/index.js

@@ -0,0 +1,23 @@
+import {
+  defineDeployer,
+  defineDriftDetector,
+  defineHealthChecker,
+  defineRollbackHandler,
+  defineValidator
+} from "./chunk-PJCHU6ZZ.js";
+import {
+  AppContext,
+  useAppContext,
+  usePipelineStatus
+} from "./chunk-TSEIWO6T.js";
+export {
+  AppContext,
+  defineDeployer,
+  defineDriftDetector,
+  defineHealthChecker,
+  defineRollbackHandler,
+  defineValidator,
+  useAppContext,
+  usePipelineStatus
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/pipeline/index.cjs

@@ -0,0 +1,63 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pipeline/index.ts
+var pipeline_exports = {};
+__export(pipeline_exports, {
+  defineDeployer: () => defineDeployer,
+  defineDriftDetector: () => defineDriftDetector,
+  defineHealthChecker: () => defineHealthChecker,
+  defineRollbackHandler: () => defineRollbackHandler,
+  defineValidator: () => defineValidator
+});
+module.exports = __toCommonJS(pipeline_exports);
+
+// src/pipeline/define-validator.ts
+function defineValidator(handler) {
+  return handler;
+}
+
+// src/pipeline/define-deployer.ts
+function defineDeployer(handler) {
+  return handler;
+}
+
+// src/pipeline/define-rollback-handler.ts
+function defineRollbackHandler(handler) {
+  return handler;
+}
+
+// src/pipeline/define-health-checker.ts
+function defineHealthChecker(handler) {
+  return handler;
+}
+
+// src/pipeline/define-drift-detector.ts
+function defineDriftDetector(handler) {
+  return handler;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineDeployer,
+  defineDriftDetector,
+  defineHealthChecker,
+  defineRollbackHandler,
+  defineValidator
+});
+//# sourceMappingURL=index.cjs.map

package/dist/pipeline/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pipeline/index.ts","../../src/pipeline/define-validator.ts","../../src/pipeline/define-deployer.ts","../../src/pipeline/define-rollback-handler.ts","../../src/pipeline/define-health-checker.ts","../../src/pipeline/define-drift-detector.ts"],"sourcesContent":["export { defineValidator } from './define-validator'\r\nexport { defineDeployer } from './define-deployer'\r\nexport { defineRollbackHandler } from './define-rollback-handler'\r\nexport { defineHealthChecker } from './define-health-checker'\r\nexport { defineDriftDetector } from './define-drift-detector'\r\n","import type { PipelineContext, ValidationResult } from '../types/pipeline'\n\n/**\n * Define a validation handler for a configuration type.\n *\n * @example\n * ```ts\n * import { defineValidator } from '@veltrixsecops/app-sdk/pipeline'\n *\n * export default defineValidator(async (ctx) => {\n *   const errors = []\n *   const name = ctx.canvas.sections[0]?.fields['name']\n *   if (!name) {\n *     errors.push({ field: 'name', message: 'Name is required', code: 'REQUIRED' })\n *   }\n *   return { valid: errors.length === 0, errors, warnings: [] }\n * })\n * ```\n */\nexport function defineValidator(\n  handler: (ctx: PipelineContext) => Promise<ValidationResult>,\n): (ctx: PipelineContext) => Promise<ValidationResult> {\n  return handler\n}\n","import type { DeployContext, DeployResult } from '../types/pipeline'\n\n/**\n * Define a deploy handler for a configuration type.\n *\n * @example\n * ```ts\n * import { defineDeployer } from '@veltrixsecops/app-sdk/pipeline'\n *\n * export default defineDeployer(async (ctx) => {\n *   const { component, credential, connectivity, canvas } = ctx\n *   // Push configuration to the tool\n *   return { success: true, message: 'Deployed', rollbackData: previousState }\n * })\n * ```\n */\nexport function defineDeployer(\n  handler: (ctx: DeployContext) => Promise<DeployResult>,\n): (ctx: DeployContext) => Promise<DeployResult> {\n  return handler\n}\n","import type { RollbackContext, RollbackResult } from '../types/pipeline'\r\n\r\n/**\r\n * Define a rollback handler for a configuration type.\r\n */\r\nexport function defineRollbackHandler(\r\n  handler: (ctx: RollbackContext) => Promise<RollbackResult>,\r\n): (ctx: RollbackContext) => Promise<RollbackResult> {\r\n  return handler\r\n}\r\n","import type { HealthCheckContext, HealthCheckResult } from '../types/pipeline'\r\n\r\n/**\r\n * Define a health check handler for a configuration type.\r\n */\r\nexport function defineHealthChecker(\r\n  handler: (ctx: HealthCheckContext) => Promise<HealthCheckResult>,\r\n): (ctx: HealthCheckContext) => Promise<HealthCheckResult> {\r\n  return handler\r\n}\r\n","import type { DriftContext, DriftResult } from '../types/pipeline'\r\n\r\n/**\r\n * Define a drift detection handler for a configuration type.\r\n */\r\nexport function defineDriftDetector(\r\n  handler: (ctx: DriftContext) => Promise<DriftResult>,\r\n): (ctx: DriftContext) => Promise<DriftResult> {\r\n  return handler\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmBO,SAAS,gBACd,SACqD;AACrD,SAAO;AACT;;;ACPO,SAAS,eACd,SAC+C;AAC/C,SAAO;AACT;;;ACfO,SAAS,sBACd,SACmD;AACnD,SAAO;AACT;;;ACJO,SAAS,oBACd,SACyD;AACzD,SAAO;AACT;;;ACJO,SAAS,oBACd,SAC6C;AAC7C,SAAO;AACT;","names":[]}

package/dist/pipeline/index.d.cts

@@ -0,0 +1 @@
+export { y as defineDeployer, z as defineDriftDetector, A as defineHealthChecker, B as defineRollbackHandler, F as defineValidator } from '../index-CKeIf4Jx.cjs';

package/dist/pipeline/index.d.ts

@@ -0,0 +1 @@
+export { y as defineDeployer, z as defineDriftDetector, A as defineHealthChecker, B as defineRollbackHandler, F as defineValidator } from '../index-CKeIf4Jx.js';

package/dist/pipeline/index.js

@@ -0,0 +1,15 @@
+import {
+  defineDeployer,
+  defineDriftDetector,
+  defineHealthChecker,
+  defineRollbackHandler,
+  defineValidator
+} from "../chunk-PJCHU6ZZ.js";
+export {
+  defineDeployer,
+  defineDriftDetector,
+  defineHealthChecker,
+  defineRollbackHandler,
+  defineValidator
+};
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@veltrixsecops/app-sdk",
+  "version": "1.0.0",
+  "description": "Official SDK for building Veltrix Security-as-Code apps — typed pipeline handler contracts, lifecycle hook types, manifest types, and React hooks.",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./pipeline": {
+      "import": {
+        "types": "./dist/pipeline/index.d.ts",
+        "default": "./dist/pipeline/index.js"
+      },
+      "require": {
+        "types": "./dist/pipeline/index.d.cts",
+        "default": "./dist/pipeline/index.cjs"
+      }
+    },
+    "./hooks": {
+      "import": {
+        "types": "./dist/hooks/index.d.ts",
+        "default": "./dist/hooks/index.js"
+      },
+      "require": {
+        "types": "./dist/hooks/index.d.cts",
+        "default": "./dist/hooks/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "veltrix",
+    "security-as-code",
+    "secops",
+    "app-sdk",
+    "pipeline",
+    "plugin"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/captivatortechnologies/Veltrix/tree/main/app-sdk",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/captivatortechnologies/Veltrix.git",
+    "directory": "app-sdk"
+  }
+}