@alienplatform/testing 1.4.2 → 1.7.0

package/dist/errors.js

@@ -1,12 +1,12 @@
 import { AlienError, defineError } from "@alienplatform/core";
-import * as z from "zod/v4";
+import * as z$1 from "zod/v4";
 //#region src/errors.ts
 const TestingOperationFailedError = defineError({
 	code: "TESTING_OPERATION_FAILED",
-	context: z.object({
-		operation: z.string(),
-		message: z.string(),
-		details: z.record(z.string(), z.unknown()).optional()
+	context: z$1.object({
+		operation: z$1.string(),
+		message: z$1.string(),
+		details: z$1.record(z$1.string(), z$1.unknown()).optional()
 	}),
 	message: ({ operation, message }) => `Testing operation '${operation}' failed: ${message}`,
 	retryable: false,
@@ -15,9 +15,9 @@ const TestingOperationFailedError = defineError({
 });
 const TestingUnsupportedPlatformError = defineError({
 	code: "TESTING_UNSUPPORTED_PLATFORM",
-	context: z.object({
-		platform: z.string(),
-		operation: z.string()
+	context: z$1.object({
+		platform: z$1.string(),
+		operation: z$1.string()
 	}),
 	message: ({ platform, operation }) => `Unsupported platform '${platform}' for testing operation '${operation}'`,
 	retryable: false,

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import { AlienError, defineError } from \"@alienplatform/core\"\nimport * as z from \"zod/v4\"\n\nexport const TestingOperationFailedError = defineError({\n  code: \"TESTING_OPERATION_FAILED\",\n  context: z.object({\n    operation: z.string(),\n    message: z.string(),\n    details: z.record(z.string(), z.unknown()).optional(),\n  }),\n  message: ({ operation, message }) => `Testing operation '${operation}' failed: ${message}`,\n  retryable: false,\n  internal: false,\n  httpStatusCode: 500,\n})\n\nexport const TestingUnsupportedPlatformError = defineError({\n  code: \"TESTING_UNSUPPORTED_PLATFORM\",\n  context: z.object({\n    platform: z.string(),\n    operation: z.string(),\n  }),\n  message: ({ platform, operation }) =>\n    `Unsupported platform '${platform}' for testing operation '${operation}'`,\n  retryable: false,\n  internal: false,\n  httpStatusCode: 400,\n})\n\nexport async function withTestingContext(\n  error: unknown,\n  operation: string,\n  message: string,\n  details?: Record<string, unknown>,\n): Promise<AlienError<any>> {\n  return (await AlienError.from(error)).withContext(\n    TestingOperationFailedError.create({\n      operation,\n      message,\n      details,\n    }),\n  )\n}\n"],"mappings":";;;AAGA,MAAa,8BAA8B,YAAY;CACrD,MAAM;CACN,SAAS,EAAE,OAAO;EAChB,WAAW,EAAE,OAAO;EACpB,SAAS,EAAE,OAAO;EAClB,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS;CACtD,CAAC;CACD,UAAU,EAAE,WAAW,cAAc,sBAAsB,UAAU,YAAY;CACjF,WAAW;CACX,UAAU;CACV,gBAAgB;AAClB,CAAC;AAED,MAAa,kCAAkC,YAAY;CACzD,MAAM;CACN,SAAS,EAAE,OAAO;EAChB,UAAU,EAAE,OAAO;EACnB,WAAW,EAAE,OAAO;CACtB,CAAC;CACD,UAAU,EAAE,UAAU,gBACpB,yBAAyB,SAAS,2BAA2B,UAAU;CACzE,WAAW;CACX,UAAU;CACV,gBAAgB;AAClB,CAAC;AAED,eAAsB,mBACpB,OACA,WACA,SACA,SAC0B;CAC1B,QAAQ,MAAM,WAAW,KAAK,KAAK,GAAG,YACpC,4BAA4B,OAAO;EACjC;EACA;EACA;CACF,CAAC,CACH;AACF"}
+{"version":3,"file":"errors.js","names":["z"],"sources":["../src/errors.ts"],"sourcesContent":["import { AlienError, defineError } from \"@alienplatform/core\"\nimport * as z from \"zod/v4\"\n\nexport const TestingOperationFailedError = defineError({\n  code: \"TESTING_OPERATION_FAILED\",\n  context: z.object({\n    operation: z.string(),\n    message: z.string(),\n    details: z.record(z.string(), z.unknown()).optional(),\n  }),\n  message: ({ operation, message }) => `Testing operation '${operation}' failed: ${message}`,\n  retryable: false,\n  internal: false,\n  httpStatusCode: 500,\n})\n\nexport const TestingUnsupportedPlatformError = defineError({\n  code: \"TESTING_UNSUPPORTED_PLATFORM\",\n  context: z.object({\n    platform: z.string(),\n    operation: z.string(),\n  }),\n  message: ({ platform, operation }) =>\n    `Unsupported platform '${platform}' for testing operation '${operation}'`,\n  retryable: false,\n  internal: false,\n  httpStatusCode: 400,\n})\n\nexport async function withTestingContext(\n  error: unknown,\n  operation: string,\n  message: string,\n  details?: Record<string, unknown>,\n): Promise<AlienError<any>> {\n  return (await AlienError.from(error)).withContext(\n    TestingOperationFailedError.create({\n      operation,\n      message,\n      details,\n    }),\n  )\n}\n"],"mappings":";;;AAGA,MAAa,8BAA8B,YAAY;CACrD,MAAM;CACN,SAASA,IAAE,OAAO;EAChB,WAAWA,IAAE,OAAO;EACpB,SAASA,IAAE,OAAO;EAClB,SAASA,IAAE,OAAOA,IAAE,OAAO,GAAGA,IAAE,QAAQ,CAAC,EAAE,SAAS;CACtD,CAAC;CACD,UAAU,EAAE,WAAW,cAAc,sBAAsB,UAAU,YAAY;CACjF,WAAW;CACX,UAAU;CACV,gBAAgB;AAClB,CAAC;AAED,MAAa,kCAAkC,YAAY;CACzD,MAAM;CACN,SAASA,IAAE,OAAO;EAChB,UAAUA,IAAE,OAAO;EACnB,WAAWA,IAAE,OAAO;CACtB,CAAC;CACD,UAAU,EAAE,UAAU,gBACpB,yBAAyB,SAAS,2BAA2B,UAAU;CACzE,WAAW;CACX,UAAU;CACV,gBAAgB;AAClB,CAAC;AAED,eAAsB,mBACpB,OACA,WACA,SACA,SAC0B;CAC1B,QAAQ,MAAM,WAAW,KAAK,KAAK,GAAG,YACpC,4BAA4B,OAAO;EACjC;EACA;EACA;CACF,CAAC,CACH;AACF"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as node_child_process0 from "node:child_process";
-import * as _alienplatform_core0 from "@alienplatform/core";
-import { AlienError } from "@alienplatform/core";
-import * as z from "zod/v4";
+import * as z$1 from "zod/v4";
+import { z } from "zod/v4";
+import * as z$2 from "zod";
 
 //#region src/types.d.ts
 
@@ -66,7 +66,8 @@ interface DeploymentInfo {
 interface DeploymentInit {
   id: string;
   name: string;
-  url: string;
+  /** Public URL of the app, when the stack has a resource that exposes one. */
+  url?: string;
   platform: Platform;
   commandsUrl: string;
   appPath: string;
@@ -79,7 +80,8 @@ interface DeploymentInit {
 declare class Deployment {
   readonly id: string;
   readonly name: string;
-  readonly url: string;
+  /** Public URL of the app. Undefined for stacks with no URL-exposing resource (e.g. daemon-only). */
+  readonly url: string | undefined;
   readonly platform: Platform;
   /** Whether the deployment has been destroyed */
   destroyed: boolean;
@@ -121,44 +123,193 @@ declare class Deployment {
  */
 declare function deploy(options: DeployOptions): Promise<Deployment>;
 //#endregion
+//#region ../core/dist/index.d.ts
+
+//#endregion
+//#region src/generated/zod/alien-error-schema.d.ts
+/**
+ * @description Canonical error container that provides a structured way to represent errors\nwith rich metadata including error codes, human-readable messages, context,\nand chaining capabilities for error propagation.\n\nThis struct is designed to be both machine-readable and user-friendly,\nsupporting serialization for API responses and detailed error reporting\nin distributed systems.
+ */
+declare const AlienErrorSchema: z$2.ZodObject<{
+  code: z$2.ZodString;
+  context: z$2.ZodOptional<z$2.ZodAny>;
+  hint: z$2.ZodOptional<z$2.ZodNullable<z$2.ZodString>>;
+  httpStatusCode: z$2.ZodOptional<z$2.ZodNullable<z$2.ZodInt>>;
+  internal: z$2.ZodBoolean;
+  message: z$2.ZodString;
+  retryable: z$2.ZodDefault<z$2.ZodBoolean>;
+  source: z$2.ZodOptional<z$2.ZodAny>;
+}, z$2.core.$strip>;
+type AlienError$1 = z$2.infer<typeof AlienErrorSchema>;
+//#endregion
+//#region src/generated/zod/alien-event-schema.d.ts
+/**
+ * @description Represents all possible events in the Alien system
+ */
+
+//#endregion
+//#region src/error.d.ts
+/**
+ * Base interface that all error type definitions must implement.
+ *
+ * This provides the structure for creating type-safe error definitions
+ * with Zod validation and contextual information.
+ *
+ * @template TContext - Zod schema type for the error context
+ */
+interface AlienErrorMetadata<TContext extends z.ZodTypeAny> {
+  /** Unique error code (e.g., "DATABASE_CONNECTION_FAILED") */
+  code: string;
+  /** Zod schema for type-safe context validation */
+  context: TContext;
+  /** Whether this error can be retried */
+  retryable: boolean;
+  /** Whether this error contains sensitive information */
+  internal: boolean;
+  /** HTTP status code for API responses */
+  httpStatusCode?: number;
+  /** Worker to generate human-readable error message from context */
+  message: (context: z.infer<TContext>) => string;
+}
+/**
+ * Helper function to create type-safe error definitions.
+ *
+ * This function provides a clean API for defining reusable error types
+ * with full TypeScript type safety and Zod validation.
+ *
+ * @template TContext - Zod schema type for the error context
+ * @param metadata - Error metadata including code, schema, and message generator
+ * @returns Object with metadata and a create function for error instances
+ *
+ * @example
+ * ```typescript
+ * const UserNotFound = defineError({
+ *   code: "USER_NOT_FOUND",
+ *   context: z.object({
+ *     userId: z.string(),
+ *     searchMethod: z.string(),
+ *   }),
+ *   message: ({ userId, searchMethod }) =>
+ *     `User '${userId}' not found using method '${searchMethod}'`,
+ *   retryable: false,
+ *   internal: false,
+ *   httpStatusCode: 404,
+ * })
+ *
+ * // Usage
+ * const error = UserNotFound.create({
+ *   userId: "123",
+ *   searchMethod: "database_lookup"
+ * })
+ * ```
+ */
+
+/**
+ * Represents a specific error instance with its context.
+ *
+ * This is created by calling `.create()` on an error definition
+ * and contains the actual context data for a specific error occurrence.
+ *
+ * @template TContext - Zod schema type for the error context
+ */
+interface AlienErrorDefinition<TContext extends z.ZodTypeAny> {
+  metadata: AlienErrorMetadata<TContext>;
+  contextSchema: TContext;
+  context: z.infer<TContext>;
+  /**
+   * Convert this error definition directly to AlienErrorOptions.
+   *
+   * This allows you to get the wire format representation
+   * without creating an AlienError instance first.
+   *
+   * @returns AlienErrorOptions object representing this error
+   */
+  toOptions(): AlienError$1;
+}
+/**
+ * Main AlienError class that provides structured error handling.
+ *
+ * This class extends the standard JavaScript Error with additional features:
+ * - Type-safe context data
+ * - Error chaining and source tracking
+ * - Retryability and internal/external visibility flags
+ * - HTTP status code mapping
+ * - Sanitization for external APIs
+ *
+ * @template TContext - Zod schema type for the error context
+ *
+ * @example Basic Construction
+ * ```typescript
+ * const error = new AlienError(DatabaseError.create({
+ *   host: "localhost",
+ *   port: 5432,
+ *   reason: "Timeout"
+ * }))
+ * ```
+ *
+ * @example Converting JavaScript Errors
+ * ```typescript
+ * try {
+ *   JSON.parse("invalid json")
+ * } catch (jsError) {
+ *   const alienError = AlienError.from(jsError)
+ *   console.log(alienError.code) // "GENERIC_ERROR"
+ * }
+ * ```
+ *
+ * @example Error Chaining
+ * ```typescript
+ * const contextualError = AlienError.from(new Error("Network timeout"))
+ *   .withContext(DatabaseError.create({
+ *     host: "localhost",
+ *     port: 5432,
+ *     reason: "Connection timeout"
+ *   }))
+ *
+ * // Check error chain
+ * console.log(contextualError.hasErrorCode("DATABASE_CONNECTION_FAILED")) // true
+ * console.log(contextualError.toString()) // Shows full error chain
+ * ```
+ */
+//#endregion
 //#region src/errors.d.ts
 declare const TestingOperationFailedError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    operation: z.ZodString;
-    message: z.ZodString;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    operation: z.ZodString;
-    message: z.ZodString;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$strip>;
+  metadata: AlienErrorMetadata<z$1.ZodObject<{
+    operation: z$1.ZodString;
+    message: z$1.ZodString;
+    details: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
+  }, z$1.core.$strip>>;
+  contextSchema: z$1.ZodObject<{
+    operation: z$1.ZodString;
+    message: z$1.ZodString;
+    details: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
+  }, z$1.core.$strip>;
   create: (context: {
     operation: string;
     message: string;
     details?: Record<string, unknown> | undefined;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    operation: z.ZodString;
-    message: z.ZodString;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$strip>>;
+  }) => AlienErrorDefinition<z$1.ZodObject<{
+    operation: z$1.ZodString;
+    message: z$1.ZodString;
+    details: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
+  }, z$1.core.$strip>>;
 };
 declare const TestingUnsupportedPlatformError: {
-  metadata: _alienplatform_core0.AlienErrorMetadata<z.ZodObject<{
-    platform: z.ZodString;
-    operation: z.ZodString;
-  }, z.core.$strip>>;
-  contextSchema: z.ZodObject<{
-    platform: z.ZodString;
-    operation: z.ZodString;
-  }, z.core.$strip>;
+  metadata: AlienErrorMetadata<z$1.ZodObject<{
+    platform: z$1.ZodString;
+    operation: z$1.ZodString;
+  }, z$1.core.$strip>>;
+  contextSchema: z$1.ZodObject<{
+    platform: z$1.ZodString;
+    operation: z$1.ZodString;
+  }, z$1.core.$strip>;
   create: (context: {
     platform: string;
     operation: string;
-  }) => _alienplatform_core0.AlienErrorDefinition<z.ZodObject<{
-    platform: z.ZodString;
-    operation: z.ZodString;
-  }, z.core.$strip>>;
+  }) => AlienErrorDefinition<z$1.ZodObject<{
+    platform: z$1.ZodString;
+    operation: z$1.ZodString;
+  }, z$1.core.$strip>>;
 };
 //#endregion
 export { type DeployOptions, Deployment, type DeploymentInfo, type EnvironmentVariable, type Platform, TestingOperationFailedError, TestingUnsupportedPlatformError, type UpgradeOptions, deploy };