@adaptic/lumic-utils 1.0.11 → 1.0.13

package/dist/types/schemas/perplexity-schemas.d.ts

@@ -0,0 +1,338 @@
+import { z } from 'zod';
+/**
+ * Zod schema for a complete Perplexity API response.
+ * Validates the core fields that lumic-utils depends on.
+ * Uses .passthrough() to allow additional fields from newer API versions.
+ */
+export declare const perplexityResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    model: z.ZodString;
+    object: z.ZodString;
+    created: z.ZodNumber;
+    choices: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "model_length"]>>;
+        message: z.ZodObject<{
+            role: z.ZodEnum<["assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            role: "assistant";
+        }, {
+            content: string;
+            role: "assistant";
+        }>;
+        delta: z.ZodOptional<z.ZodObject<{
+            role: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }>, "many">;
+    usage: z.ZodOptional<z.ZodObject<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    model: z.ZodString;
+    object: z.ZodString;
+    created: z.ZodNumber;
+    choices: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "model_length"]>>;
+        message: z.ZodObject<{
+            role: z.ZodEnum<["assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            role: "assistant";
+        }, {
+            content: string;
+            role: "assistant";
+        }>;
+        delta: z.ZodOptional<z.ZodObject<{
+            role: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }>, "many">;
+    usage: z.ZodOptional<z.ZodObject<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    model: z.ZodString;
+    object: z.ZodString;
+    created: z.ZodNumber;
+    choices: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "model_length"]>>;
+        message: z.ZodObject<{
+            role: z.ZodEnum<["assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            role: "assistant";
+        }, {
+            content: string;
+            role: "assistant";
+        }>;
+        delta: z.ZodOptional<z.ZodObject<{
+            role: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }>, "many">;
+    usage: z.ZodOptional<z.ZodObject<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Type inferred from the Perplexity response schema */
+export type PerplexityResponse = z.infer<typeof perplexityResponseSchema>;
+/** Strict validator for Perplexity API responses. Throws on failure. */
+export declare const validatePerplexityResponse: (data: unknown) => z.objectInputType<{
+    id: z.ZodString;
+    model: z.ZodString;
+    object: z.ZodString;
+    created: z.ZodNumber;
+    choices: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "model_length"]>>;
+        message: z.ZodObject<{
+            role: z.ZodEnum<["assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            role: "assistant";
+        }, {
+            content: string;
+            role: "assistant";
+        }>;
+        delta: z.ZodOptional<z.ZodObject<{
+            role: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }>, "many">;
+    usage: z.ZodOptional<z.ZodObject<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">;
+/** Safe validator for Perplexity API responses. Never throws. */
+export declare const safeValidatePerplexityResponse: (data: unknown) => import("./validation-helpers").ValidationResult<z.objectInputType<{
+    id: z.ZodString;
+    model: z.ZodString;
+    object: z.ZodString;
+    created: z.ZodNumber;
+    choices: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "model_length"]>>;
+        message: z.ZodObject<{
+            role: z.ZodEnum<["assistant"]>;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            role: "assistant";
+        }, {
+            content: string;
+            role: "assistant";
+        }>;
+        delta: z.ZodOptional<z.ZodObject<{
+            role: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }, {
+            content?: string | undefined;
+            role?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }, {
+        message: {
+            content: string;
+            role: "assistant";
+        };
+        index: number;
+        finish_reason: "length" | "stop" | "model_length" | null;
+        delta?: {
+            content?: string | undefined;
+            role?: string | undefined;
+        } | undefined;
+    }>, "many">;
+    usage: z.ZodOptional<z.ZodObject<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        prompt_tokens: z.ZodNumber;
+        completion_tokens: z.ZodNumber;
+        total_tokens: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;

package/dist/types/schemas/validation-helpers.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/**
+ * Result of a safe validation attempt.
+ * On success, contains the parsed data. On failure, contains the error details.
+ */
+export interface ValidationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    issues?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Creates a strict validator function for a Zod schema.
+ * Throws on validation failure with a descriptive error message.
+ *
+ * @param schema - The Zod schema to validate against
+ * @param serviceName - Human-readable service name for error messages
+ * @returns A validator function that parses and returns typed data
+ */
+export declare function createValidator<T>(schema: z.ZodType<T>, serviceName: string): (data: unknown) => T;
+/**
+ * Creates a safe validator function for a Zod schema.
+ * Never throws; returns a ValidationResult with success/failure information.
+ * On failure, logs a warning but does not throw.
+ *
+ * @param schema - The Zod schema to validate against
+ * @param serviceName - Human-readable service name for log messages
+ * @returns A safe validator function that returns a ValidationResult
+ */
+export declare function createSafeValidator<T>(schema: z.ZodType<T>, serviceName: string): (data: unknown) => ValidationResult<T>;

package/dist/types/types/aws-types.d.ts

@@ -29,7 +29,7 @@ export interface SaveToS3Response {
 }
 export interface LoadFromS3Response {
     success: boolean;
-    content?: any;
+    content?: unknown;
     error?: string;
 }
 export interface CheckBucketResponse {

package/dist/types/types/google-types.d.ts

@@ -10,15 +10,17 @@ export interface GoogleSheetRange {
     startCell: GoogleSheetCell;
     endCell: GoogleSheetCell;
 }
+/** Represents a primitive value that can be stored in a Google Sheet cell */
+export type GoogleSheetCellValue = string | number | boolean | null;
 export interface GoogleSheetResponse {
     success: boolean;
     error?: string;
-    data?: any;
+    data?: unknown;
 }
 export interface GoogleSheetAddRowResponse extends GoogleSheetResponse {
     data?: {
         rowNumber: number;
-        values: any[];
+        values: GoogleSheetCellValue[];
     };
 }
 export interface GoogleSheetAddSheetResponse extends GoogleSheetResponse {
@@ -29,7 +31,7 @@ export interface GoogleSheetAddSheetResponse extends GoogleSheetResponse {
 }
 export interface GoogleSheetCellResponse extends GoogleSheetResponse {
     data?: {
-        value: any;
+        value: GoogleSheetCellValue;
     };
 }
 export interface GoogleSheetWriteArrayResponse extends GoogleSheetResponse {

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

@@ -20,7 +20,7 @@ export interface PerplexityResponse {
 export type InvocationType = 'RequestResponse' | 'Event' | 'DryRun';
 export interface LambdaResponse {
     statusCode: number;
-    [key: string]: any;
+    [key: string]: unknown;
 }
 export interface SlackApiResponse {
     ok: boolean;