@artinet/sdk 0.6.0-preview.3 → 0.6.1

package/dist/transport/trpc/a2a/routes/tasks/route.d.ts

@@ -49,7 +49,7 @@ export declare const taskRouter: import("@trpc/server").TRPCBuiltRouter<{
             id: string;
             contextId: string;
             status: {
-                state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "working" | "submitted" | "input-required" | "auth-required";
+                state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
                 message?: {
                     role: "user" | "agent";
                     parts: ({
@@ -155,7 +155,7 @@ export declare const taskRouter: import("@trpc/server").TRPCBuiltRouter<{
             contextId: string;
             kind: "status-update";
             status: {
-                state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "working" | "submitted" | "input-required" | "auth-required";
+                state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
                 message?: {
                     role: "user" | "agent";
                     parts: ({
@@ -242,7 +242,7 @@ export declare const taskRouter: import("@trpc/server").TRPCBuiltRouter<{
             id: string;
             contextId: string;
             status: {
-                state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "working" | "submitted" | "input-required" | "auth-required";
+                state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
                 message?: {
                     role: "user" | "agent";
                     parts: ({
@@ -355,7 +355,7 @@ export declare const taskRouter: import("@trpc/server").TRPCBuiltRouter<{
             id: string;
             contextId: string;
             status: {
-                state: "failed" | "unknown" | "completed" | "canceled" | "rejected" | "working" | "submitted" | "input-required" | "auth-required";
+                state: "unknown" | "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "rejected" | "auth-required";
                 message?: {
                     role: "user" | "agent";
                     parts: ({

package/dist/transport/trpc/a2a/routes/tasks/route.js

@@ -5,8 +5,8 @@
 import { z } from "zod/v4";
 import { router, A2AProcedure } from "../../trpc.js";
 import { A2A } from "../../../../../types/index.js";
-import { INVALID_REQUEST, PUSH_NOTIFICATION_NOT_SUPPORTED, } from "../../../../../utils/common/errors.js";
-import { zAsyncIterable } from "../../../../../utils/common/zAsyncIterable.js";
+import { INVALID_REQUEST, PUSH_NOTIFICATION_NOT_SUPPORTED, } from "../../../../../utils/errors.js";
+import { zAsyncIterable } from "../../../../../utils/zAsyncIterable.js";
 const pushNotificationConfigRouter = router({
     set: A2AProcedure.input(A2A.TaskPushNotificationConfigSchema)
         .output(A2A.TaskPushNotificationConfigSchema)
@@ -20,7 +20,7 @@ const pushNotificationConfigRouter = router({
         console.warn("task/pushNotificationConfig/get", input);
         throw PUSH_NOTIFICATION_NOT_SUPPORTED("Push notifications not supported");
     }),
-    list: A2AProcedure.input(A2A.ListTaskPushNotificationConfigsParamsSchema)
+    list: A2AProcedure.input(A2A.ListTaskPushNotificationConfigParamsSchema)
         .output(A2A.ListTaskPushNotificationConfigResultSchema)
         .query(async ({ input }) => {
         console.warn("task/pushNotificationConfig/list", input);

package/dist/types/a2a/a2a.d.ts

@@ -2,7 +2,7 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { AgentCard, Message, Task, AgentExtension, TaskQueryParams, TaskIdParams, MessageSendParams, SendMessageSuccessResult } from "@artinet/types/a2a";
+import { AgentCard, Message, Task, AgentExtension, TaskQueryParams, TaskIdParams, MessageSendParams, SendMessageSuccessResult, PushNotificationConfig } from "@artinet/types/a2a";
 import { core } from "../core/index.js";
 import { z } from "zod/v4";
 export type AgentCardParams = (Partial<AgentCard> & Required<Pick<AgentCard, "name">>) | string;
@@ -46,14 +46,14 @@ export declare const UpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     contextId: z.ZodString;
     status: z.ZodObject<{
         state: z.ZodEnum<{
-            failed: "failed";
             unknown: "unknown";
+            submitted: "submitted";
+            working: "working";
+            "input-required": "input-required";
             completed: "completed";
             canceled: "canceled";
+            failed: "failed";
             rejected: "rejected";
-            working: "working";
-            submitted: "submitted";
-            "input-required": "input-required";
             "auth-required": "auth-required";
         }>;
         message: z.ZodOptional<z.ZodObject<{
@@ -168,14 +168,14 @@ export declare const UpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"status-update">;
     status: z.ZodObject<{
         state: z.ZodEnum<{
-            failed: "failed";
             unknown: "unknown";
+            submitted: "submitted";
+            working: "working";
+            "input-required": "input-required";
             completed: "completed";
             canceled: "canceled";
+            failed: "failed";
             rejected: "rejected";
-            working: "working";
-            submitted: "submitted";
-            "input-required": "input-required";
             "auth-required": "auth-required";
         }>;
         message: z.ZodOptional<z.ZodObject<{
@@ -272,13 +272,13 @@ export interface Context extends BaseContext {
     readonly messages: MessageConsumerProxy;
     extensions?: AgentExtension[];
     references?: Task[];
+    userId?: string;
     getTask: () => Promise<Task>;
 }
 export type ContextParams = Omit<BaseContext, "publisher" | "isCancelled" | "getState" | "abortSignal"> & Omit<Partial<Context>, "userMessage" | "taskId"> & {
     messenger: MessageConsumerProxy;
     task: Task;
     overrides?: Partial<Omit<EventConsumer, "contextId">>;
-    abortSignal?: AbortSignal;
 };
 export interface Contexts extends core.Contexts<Context> {
     create: (params: ContextParams) => Promise<Context>;
@@ -294,20 +294,38 @@ export interface Cancellations extends Omit<core.Manager<void>, "get"> {
 }
 export interface Connections extends Omit<core.Manager<void>, "get"> {
 }
-export interface ServiceOptions {
-    abortSignal?: AbortSignal;
+export interface Notifier {
+    notify: (task: Task, update: Update, context?: Context) => Promise<void>;
+    register: (taskId: string, config: PushNotificationConfig) => Promise<void>;
+}
+export type ServiceOptions = Pick<ContextParams, "userId" | "extensions"> & {
+    task?: Task;
+    signal?: AbortSignal;
+    notifier?: Notifier;
+};
+export interface Handles {
+    getTask: (input: TaskQueryParams, context: Context) => Promise<Task>;
+    cancelTask: (input: TaskIdParams, context: Context) => Promise<Task>;
+    sendMessage: (message: MessageSendParams, context: Context) => Promise<SendMessageSuccessResult>;
+    /**
+     * @deprecated Use sendMessageStream instead
+     */
+    streamMessage: (message: MessageSendParams, context: Context) => AsyncGenerator<Update>;
+    sendMessageStream: (message: MessageSendParams, context: Context) => AsyncGenerator<Update>;
+    resubscribe: (input: TaskIdParams, context: Context) => AsyncGenerator<Update>;
 }
 export interface RequestHandler {
-    getTask: (input: TaskQueryParams, context?: Context, options?: ServiceOptions) => Promise<Task>;
-    cancelTask: (input: TaskIdParams, context?: Context, options?: ServiceOptions) => Promise<Task>;
-    sendMessage: (message: MessageSendParams, context?: Context, options?: ServiceOptions) => Promise<SendMessageSuccessResult>;
-    streamMessage: (message: MessageSendParams, context?: Context, options?: ServiceOptions) => AsyncGenerator<Update>;
-    resubscribe: (input: TaskIdParams, context?: Context, options?: ServiceOptions) => AsyncGenerator<Update>;
+    getTask: (input: TaskQueryParams, options?: ServiceOptions) => Promise<Task>;
+    cancelTask: (input: TaskIdParams, options?: ServiceOptions) => Promise<Task>;
+    sendMessage: (message: MessageSendParams, options?: ServiceOptions) => Promise<SendMessageSuccessResult>;
+    /**
+     * @deprecated Use sendMessageStream instead
+     */
+    streamMessage: (message: MessageSendParams, options?: ServiceOptions) => AsyncGenerator<Update>;
+    sendMessageStream: (message: MessageSendParams, options?: ServiceOptions) => AsyncGenerator<Update>;
+    resubscribe: (input: TaskIdParams, options?: ServiceOptions) => AsyncGenerator<Update>;
     getAgentCard: () => Promise<AgentCard>;
 }
-export interface ExtendedHandler extends RequestHandler {
-    getAuthenticatedExtendedCard: () => Promise<AgentCard>;
-}
 export interface Stream {
     readonly contextId: string;
     isAlive: boolean;

package/dist/types/a2a/a2a.js

@@ -2,7 +2,6 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-//lets stay really granular with the imports
 import { TaskArtifactUpdateEventSchema, MessageSchema, TaskSchema, TaskStatusUpdateEventSchema, } from "@artinet/types/a2a";
 import { z } from "zod/v4";
 export const UpdateSchema = z.discriminatedUnion("kind", [

package/dist/types/core/core.d.ts

@@ -1,4 +1,5 @@
-import { EventEmitter } from "events";
+import { EventEmitter } from "eventemitter3";
+import { IStore } from "../storage.js";
 export interface Service<Params extends object = object, Result extends unknown = void> {
     execute: (params: Params) => Promise<Result>;
     stop: () => Promise<void>;
@@ -11,9 +12,10 @@ export interface Context<State extends object = object> {
     readonly publisher?: Publisher;
     readonly getState: (args?: string) => Promise<State | undefined>;
     metadata?: Record<string, unknown>;
+    /**hooks allow consumers to modify context on the fly*/
     readonly hooks?: Record<string, (...args: unknown[]) => Promise<unknown>>;
 }
-export interface Manager<T = object> {
+export interface Manager<T = object> extends IStore<T> {
     get: (id: string) => Promise<T | undefined>;
     set: (id: string, data?: T) => Promise<void>;
     delete: (id: string) => Promise<void>;

package/dist/types/index.d.ts

@@ -1,7 +1,6 @@
 export * from "./a2a/index.js";
 export * from "./core/index.js";
 export * from "./mcp/index.js";
-export * from "./client.js";
 export * from "./protocol.js";
 export * from "./storage.js";
 export * from "./utils/index.js";

package/dist/types/index.js

@@ -1,7 +1,6 @@
 export * from "./a2a/index.js";
 export * from "./core/index.js";
 export * from "./mcp/index.js";
-export * from "./client.js";
 export * from "./protocol.js";
 export * from "./storage.js";
 export * from "./utils/index.js";

package/dist/types/storage.d.ts

@@ -1,18 +1,6 @@
 /**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Interface for a store of data.
- * @deprecated Use IStore instead
- * @template T - The type of data to store
- */
-export interface Store<T> {
-    set(data: T, id?: string): Promise<void>;
-    get(id: string): Promise<T | undefined>;
-}
-/**
- * Interface for a store of data.
+ * @note prefer implementing `Manager` instead of `IStore` as it provides a more robust interface.
+ *  Interface for a store of data.
  * @template T - The type of data to store
  */
 export interface IStore<T> {

package/dist/types/storage.js

@@ -1,5 +1 @@
-/**
- * Copyright 2025 The Artinet Project
- * SPDX-License-Identifier: Apache-2.0
- */
 export {};

package/dist/utils/{common/constants.d.ts → constants.d.ts}

@@ -2,5 +2,5 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { A2A } from "../../types/index.js";
+import { A2A } from "../types/index.js";
 export declare const FINAL_STATES: A2A.TaskState[];

package/dist/{browser/utils/common → utils}/constants.js

@@ -2,7 +2,7 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { A2A } from "../../types/index.js";
+import { A2A } from "../types/index.js";
 export const FINAL_STATES = [
     A2A.TaskState.completed,
     A2A.TaskState.failed,

package/dist/utils/{common/errors.d.ts → errors.d.ts}

@@ -2,77 +2,58 @@
  * Copyright 2025 The Artinet Project
  * SPDX-License-Identifier: Apache-2.0
  */
-import { A2A, MCP } from "../../types/index.js";
+import { A2A, MCP } from "../types/index.js";
 /**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
 export declare class SystemError<T extends MCP.JSONRPCErrorResponse> extends Error {
-    message: string;
     code: T["error"]["code"];
-    data: T["error"]["data"];
-    constructor(message: string, code: T["error"]["code"], data: T["error"]["data"]);
+    data?: T["error"]["data"];
+    taskId?: string;
+    message: string;
+    constructor(message: string, code: T["error"]["code"], data?: T["error"]["data"], taskId?: string);
 }
 /**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
- * @since 0.6.0
- */
-export declare const PARSE_ERROR: <T extends A2A.JSONParseError>(data: T["error"]["data"]) => SystemError<T>;
-/**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
- * @since 0.6.0
- */
-export declare const INVALID_REQUEST: <T extends A2A.InvalidRequestError>(data: T["error"]["data"]) => SystemError<T>;
-/**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
- * @since 0.6.0
- */
-export declare const METHOD_NOT_FOUND: <T extends A2A.MethodNotFoundError>(data: T["error"]["data"]) => SystemError<T>;
-/**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const INVALID_PARAMS: <T extends A2A.InvalidParamsError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const PARSE_ERROR: <T extends A2A.JSONParseError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const INTERNAL_ERROR: <T extends A2A.InternalError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const INVALID_REQUEST: <T extends A2A.InvalidRequestError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
- * @since 0.6.0
- */
-export declare const TASK_NOT_FOUND: <T extends A2A.TaskNotFoundError>(data: T["error"]["data"]) => SystemError<T>;
-/**
- * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const TASK_NOT_CANCELABLE: <T extends A2A.TaskNotCancelableError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const METHOD_NOT_FOUND: <T extends A2A.MethodNotFoundError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
+export declare const INVALID_PARAMS: <T extends A2A.InvalidParamsError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
+export declare const INTERNAL_ERROR: <T extends A2A.InternalError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
+export declare const TASK_NOT_FOUND: <T extends A2A.TaskNotFoundError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
+export declare const TASK_NOT_CANCELABLE: <T extends A2A.TaskNotCancelableError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
  * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const PUSH_NOTIFICATION_NOT_SUPPORTED: <T extends A2A.A2AError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const PUSH_NOTIFICATION_NOT_SUPPORTED: <T extends A2A.PushNotificationNotSupportedError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
  * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED: <T extends A2A.AuthenticatedExtendedCardNotConfiguredError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED: <T extends A2A.AuthenticatedExtendedCardNotConfiguredError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
  * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const UNSUPPORTED_OPERATION: <T extends A2A.A2AError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const UNSUPPORTED_OPERATION: <T extends A2A.A2AError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
  * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const CONTENT_TYPE_NOT_SUPPORTED: <T extends A2A.ContentTypeNotSupportedError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const CONTENT_TYPE_NOT_SUPPORTED: <T extends A2A.ContentTypeNotSupportedError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
  * @deprecated Use errors from the `@a2a-js/sdk` package instead
  * @since 0.6.0
  */
-export declare const INVALID_AGENT_RESPONSE: <T extends A2A.InvalidAgentResponseError>(data: T["error"]["data"]) => SystemError<T>;
+export declare const INVALID_AGENT_RESPONSE: <T extends A2A.InvalidAgentResponseError>(data: T["error"]["data"], taskId?: string) => SystemError<T>;
 /**
  * @deprecated Use {@link describe.update.failed} instead
  * @since 0.6.0

package/dist/utils/errors.js

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { A2A } from "../types/index.js";
+import * as describe from "../create/describe.js";
+/**
+ * @since 0.6.0
+ */
+export class SystemError extends Error {
+    code;
+    data;
+    taskId;
+    message;
+    constructor(message, code, data, taskId) {
+        super(message);
+        // this.name = "RpcError";
+        this.code = code;
+        this.data = data;
+        this.taskId = taskId;
+        this.message = message;
+    }
+}
+/**
+ * @since 0.6.0
+ */
+export const PARSE_ERROR = (data, taskId) => new SystemError("Invalid JSON payload", A2A.ErrorCodeParseError, data, taskId);
+/**
+ * @since 0.6.0
+ */
+export const INVALID_REQUEST = (data, taskId) => new SystemError("Request payload validation error", A2A.ErrorCodeInvalidRequest, data, taskId);
+/**
+ * @since 0.6.0
+ */
+export const METHOD_NOT_FOUND = (data, taskId) => new SystemError("Method not found", A2A.ErrorCodeMethodNotFound, data, taskId);
+export const INVALID_PARAMS = (data, taskId) => new SystemError("Invalid parameters", A2A.ErrorCodeInvalidParams, data, taskId);
+export const INTERNAL_ERROR = (data, taskId) => new SystemError("Internal error", A2A.ErrorCodeInternalError, data, taskId);
+export const TASK_NOT_FOUND = (data, taskId) => new SystemError("Task not found", A2A.ErrorCodeTaskNotFound, data, taskId);
+export const TASK_NOT_CANCELABLE = (data, taskId) => new SystemError("Task cannot be canceled", A2A.ErrorCodeTaskNotCancelable, data, taskId);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const PUSH_NOTIFICATION_NOT_SUPPORTED = (data, taskId) => new SystemError("Push Notifications is not supported", A2A.ErrorCodePushNotificationNotSupported, data, taskId);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const AUTHENTICATED_EXTENDED_CARD_NOT_CONFIGURED = (data, taskId) => new SystemError("Authenticated Extended Card is not configured", A2A.ErrorCodeAuthenticatedExtendedCardNotConfigured, data, taskId);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const UNSUPPORTED_OPERATION = (data, taskId) => new SystemError("This operation is not supported", A2A.ErrorCodeUnsupportedOperation, data, taskId);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const CONTENT_TYPE_NOT_SUPPORTED = (data, taskId) => new SystemError("Content type not supported", A2A.ErrorCodeContentTypeNotSupported, data, taskId);
+/**
+ * @deprecated Use errors from the `@a2a-js/sdk` package instead
+ * @since 0.6.0
+ */
+export const INVALID_AGENT_RESPONSE = (data, taskId) => new SystemError("Invalid agent response", A2A.ErrorCodeInvalidAgentResponse, data, taskId);
+/**
+ * @deprecated Use {@link describe.update.failed} instead
+ * @since 0.6.0
+ */
+export const FAILED_UPDATE = (taskId, contextId, messageId = "failed-update", errMessage) => {
+    return describe.update.failed({
+        taskId,
+        contextId,
+        final: true,
+        message: describe.message({
+            role: "agent",
+            messageId,
+            parts: [{ kind: "text", text: errMessage }],
+        }),
+    });
+};

package/dist/utils/index.d.ts

@@ -1,10 +1,6 @@
-/**
- * @deprecated Many of these utils will be removed in the next major release.
- * @fileoverview Provides a collection of utility functions for the Artinet SDK.
- */
-export * from "./common/constants.js";
-export * from "./common/errors.js";
-export * from "./common/schema-validation.js";
-export * from "./common/utils.js";
-export * from "./common/parse.js";
-export * from "./storage/file.js";
+/**Only export browser compatible utils */
+export * from "./constants.js";
+export * from "./errors.js";
+export * from "./parse.js";
+export * from "./schema-validation.js";
+export * from "./utils.js";

package/dist/utils/index.js

@@ -1,10 +1,6 @@
-/**
- * @deprecated Many of these utils will be removed in the next major release.
- * @fileoverview Provides a collection of utility functions for the Artinet SDK.
- */
-export * from "./common/constants.js";
-export * from "./common/errors.js";
-export * from "./common/schema-validation.js";
-export * from "./common/utils.js";
-export * from "./common/parse.js";
-export * from "./storage/file.js";
+/**Only export browser compatible utils */
+export * from "./constants.js";
+export * from "./errors.js";
+export * from "./parse.js";
+export * from "./schema-validation.js";
+export * from "./utils.js";

package/dist/utils/parse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod/v4";
+export declare function safeParse<T = any>(json: string): T;
+export declare function safeParseSchema<T extends z.ZodSchema>(json: string, schema: T): Promise<z.output<T>>;

package/dist/utils/parse.js

@@ -0,0 +1,17 @@
+import { validateSchema } from "./schema-validation.js";
+import { logger } from "../config/index.js";
+export function safeParse(json) {
+    if (!json || json === "{}" || json === "[]" || json === "") {
+        return {};
+    }
+    try {
+        return JSON.parse(json);
+    }
+    catch (error) {
+        logger.warn("safeParse error:", error, json);
+        return {};
+    }
+}
+export async function safeParseSchema(json, schema) {
+    return await validateSchema(schema, safeParse(json));
+}

package/dist/utils/schema-validation.d.ts

@@ -0,0 +1,2 @@
+import { z } from "zod/v4";
+export declare function validateSchema<T extends z.ZodSchema>(schema: T, data: unknown): Promise<z.output<T>>;

package/dist/utils/schema-validation.js

@@ -0,0 +1,12 @@
+/**
+ * Copyright 2025 The Artinet Project
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { INVALID_PARAMS } from "./errors.js";
+import { logger } from "../config/index.js";
+export async function validateSchema(schema, data) {
+    return await schema.parseAsync(data).catch((error) => {
+        logger.error("Schema validation failed", error);
+        throw INVALID_PARAMS(error);
+    });
+}