@adaptic/lumic-utils 1.0.11 → 1.0.13

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

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+/**
+ * Zod schema for an S3 ListObjectsV2 response.
+ * Validates the core fields used by lumic-utils S3 operations.
+ */
+export declare const s3ListObjectsSchema: z.ZodObject<{
+    Contents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        Key: z.ZodOptional<z.ZodString>;
+        LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+        ETag: z.ZodOptional<z.ZodString>;
+        Size: z.ZodOptional<z.ZodNumber>;
+        StorageClass: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }>, "many">>;
+    KeyCount: z.ZodOptional<z.ZodNumber>;
+    MaxKeys: z.ZodOptional<z.ZodNumber>;
+    Name: z.ZodOptional<z.ZodString>;
+    Prefix: z.ZodOptional<z.ZodString>;
+    IsTruncated: z.ZodOptional<z.ZodBoolean>;
+    NextContinuationToken: z.ZodOptional<z.ZodString>;
+    ContinuationToken: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    Contents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        Key: z.ZodOptional<z.ZodString>;
+        LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+        ETag: z.ZodOptional<z.ZodString>;
+        Size: z.ZodOptional<z.ZodNumber>;
+        StorageClass: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }>, "many">>;
+    KeyCount: z.ZodOptional<z.ZodNumber>;
+    MaxKeys: z.ZodOptional<z.ZodNumber>;
+    Name: z.ZodOptional<z.ZodString>;
+    Prefix: z.ZodOptional<z.ZodString>;
+    IsTruncated: z.ZodOptional<z.ZodBoolean>;
+    NextContinuationToken: z.ZodOptional<z.ZodString>;
+    ContinuationToken: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    Contents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        Key: z.ZodOptional<z.ZodString>;
+        LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+        ETag: z.ZodOptional<z.ZodString>;
+        Size: z.ZodOptional<z.ZodNumber>;
+        StorageClass: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }>, "many">>;
+    KeyCount: z.ZodOptional<z.ZodNumber>;
+    MaxKeys: z.ZodOptional<z.ZodNumber>;
+    Name: z.ZodOptional<z.ZodString>;
+    Prefix: z.ZodOptional<z.ZodString>;
+    IsTruncated: z.ZodOptional<z.ZodBoolean>;
+    NextContinuationToken: z.ZodOptional<z.ZodString>;
+    ContinuationToken: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Zod schema for an S3 GetObject response body metadata.
+ * The actual body is a stream and is not validated here.
+ */
+export declare const s3GetObjectSchema: z.ZodObject<{
+    ContentLength: z.ZodOptional<z.ZodNumber>;
+    ContentType: z.ZodOptional<z.ZodString>;
+    ETag: z.ZodOptional<z.ZodString>;
+    LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+    Body: z.ZodUnknown;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    ContentLength: z.ZodOptional<z.ZodNumber>;
+    ContentType: z.ZodOptional<z.ZodString>;
+    ETag: z.ZodOptional<z.ZodString>;
+    LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+    Body: z.ZodUnknown;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    ContentLength: z.ZodOptional<z.ZodNumber>;
+    ContentType: z.ZodOptional<z.ZodString>;
+    ETag: z.ZodOptional<z.ZodString>;
+    LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+    Body: z.ZodUnknown;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * Zod schema for an AWS Lambda Invoke response.
+ */
+export declare const lambdaInvokeResponseSchema: z.ZodObject<{
+    StatusCode: z.ZodNumber;
+    FunctionError: z.ZodOptional<z.ZodString>;
+    LogResult: z.ZodOptional<z.ZodString>;
+    Payload: z.ZodOptional<z.ZodUnknown>;
+    ExecutedVersion: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    StatusCode: z.ZodNumber;
+    FunctionError: z.ZodOptional<z.ZodString>;
+    LogResult: z.ZodOptional<z.ZodString>;
+    Payload: z.ZodOptional<z.ZodUnknown>;
+    ExecutedVersion: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    StatusCode: z.ZodNumber;
+    FunctionError: z.ZodOptional<z.ZodString>;
+    LogResult: z.ZodOptional<z.ZodString>;
+    Payload: z.ZodOptional<z.ZodUnknown>;
+    ExecutedVersion: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Type inferred from S3 ListObjects schema */
+export type S3ListObjectsResponse = z.infer<typeof s3ListObjectsSchema>;
+/** Type inferred from Lambda Invoke schema */
+export type LambdaInvokeResponse = z.infer<typeof lambdaInvokeResponseSchema>;
+/** Strict validator for S3 ListObjectsV2 responses. Throws on failure. */
+export declare const validateS3ListObjects: (data: unknown) => z.objectInputType<{
+    Contents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        Key: z.ZodOptional<z.ZodString>;
+        LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+        ETag: z.ZodOptional<z.ZodString>;
+        Size: z.ZodOptional<z.ZodNumber>;
+        StorageClass: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }>, "many">>;
+    KeyCount: z.ZodOptional<z.ZodNumber>;
+    MaxKeys: z.ZodOptional<z.ZodNumber>;
+    Name: z.ZodOptional<z.ZodString>;
+    Prefix: z.ZodOptional<z.ZodString>;
+    IsTruncated: z.ZodOptional<z.ZodBoolean>;
+    NextContinuationToken: z.ZodOptional<z.ZodString>;
+    ContinuationToken: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">;
+/** Safe validator for S3 ListObjectsV2 responses. Never throws. */
+export declare const safeValidateS3ListObjects: (data: unknown) => import("./validation-helpers").ValidationResult<z.objectInputType<{
+    Contents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        Key: z.ZodOptional<z.ZodString>;
+        LastModified: z.ZodOptional<z.ZodUnion<[z.ZodDate, z.ZodString]>>;
+        ETag: z.ZodOptional<z.ZodString>;
+        Size: z.ZodOptional<z.ZodNumber>;
+        StorageClass: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }, {
+        Key?: string | undefined;
+        StorageClass?: string | undefined;
+        LastModified?: string | Date | undefined;
+        ETag?: string | undefined;
+        Size?: number | undefined;
+    }>, "many">>;
+    KeyCount: z.ZodOptional<z.ZodNumber>;
+    MaxKeys: z.ZodOptional<z.ZodNumber>;
+    Name: z.ZodOptional<z.ZodString>;
+    Prefix: z.ZodOptional<z.ZodString>;
+    IsTruncated: z.ZodOptional<z.ZodBoolean>;
+    NextContinuationToken: z.ZodOptional<z.ZodString>;
+    ContinuationToken: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Strict validator for Lambda Invoke responses. Throws on failure. */
+export declare const validateLambdaResponse: (data: unknown) => z.objectInputType<{
+    StatusCode: z.ZodNumber;
+    FunctionError: z.ZodOptional<z.ZodString>;
+    LogResult: z.ZodOptional<z.ZodString>;
+    Payload: z.ZodOptional<z.ZodUnknown>;
+    ExecutedVersion: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">;
+/** Safe validator for Lambda Invoke responses. Never throws. */
+export declare const safeValidateLambdaResponse: (data: unknown) => import("./validation-helpers").ValidationResult<z.objectInputType<{
+    StatusCode: z.ZodNumber;
+    FunctionError: z.ZodOptional<z.ZodString>;
+    LogResult: z.ZodOptional<z.ZodString>;
+    Payload: z.ZodOptional<z.ZodUnknown>;
+    ExecutedVersion: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;

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

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/**
+ * Zod schema for a Google Sheets ValueRange response.
+ * This is the standard response when reading cells from a spreadsheet.
+ */
+export declare const googleSheetsValueRangeSchema: z.ZodObject<{
+    range: z.ZodString;
+    majorDimension: z.ZodOptional<z.ZodEnum<["ROWS", "COLUMNS"]>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    range: z.ZodString;
+    majorDimension: z.ZodOptional<z.ZodEnum<["ROWS", "COLUMNS"]>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    range: z.ZodString;
+    majorDimension: z.ZodOptional<z.ZodEnum<["ROWS", "COLUMNS"]>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Type inferred from the ValueRange schema */
+export type GoogleSheetsValueRange = z.infer<typeof googleSheetsValueRangeSchema>;
+/** Strict validator for Google Sheets ValueRange responses. Throws on failure. */
+export declare const validateGoogleSheetsResponse: (data: unknown) => z.objectInputType<{
+    range: z.ZodString;
+    majorDimension: z.ZodOptional<z.ZodEnum<["ROWS", "COLUMNS"]>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">, "many">>;
+}, z.ZodTypeAny, "passthrough">;
+/** Safe validator for Google Sheets ValueRange responses. Never throws. */
+export declare const safeValidateGoogleSheetsResponse: (data: unknown) => import("./validation-helpers").ValidationResult<z.objectInputType<{
+    range: z.ZodString;
+    majorDimension: z.ZodOptional<z.ZodEnum<["ROWS", "COLUMNS"]>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">, "many">>;
+}, z.ZodTypeAny, "passthrough">>;

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

@@ -0,0 +1,17 @@
+/**
+ * API Response Validation Schemas for lumic-utils external service integrations.
+ *
+ * These Zod schemas validate responses from external APIs (OpenAI, Perplexity,
+ * Google Sheets, AWS) to catch breaking changes early and provide type-safe
+ * response handling.
+ *
+ * Usage:
+ *   import { validateOpenAIResponse, validatePerplexityResponse } from './schemas';
+ *   const parsed = validateOpenAIResponse(rawResponse);
+ */
+export { openAIChatCompletionSchema, openAIImageResponseSchema, validateOpenAIChatCompletion, safeValidateOpenAIChatCompletion, } from './openai-schemas';
+export { perplexityResponseSchema, validatePerplexityResponse, safeValidatePerplexityResponse, } from './perplexity-schemas';
+export { googleSheetsValueRangeSchema, validateGoogleSheetsResponse, safeValidateGoogleSheetsResponse, } from './google-sheets-schemas';
+export { s3ListObjectsSchema, s3GetObjectSchema, lambdaInvokeResponseSchema, validateS3ListObjects, safeValidateS3ListObjects, validateLambdaResponse, safeValidateLambdaResponse, } from './aws-schemas';
+export type { ValidationResult } from './validation-helpers';
+export { createValidator, createSafeValidator } from './validation-helpers';