@oobe-protocol-labs/synapse-sap-sdk 0.12.9 → 0.14.0

package/dist/esm/utils/schemas.js

@@ -1,320 +0,0 @@
-/**
- * @module utils/schemas
- * @description Zod schemas for runtime validation of environment variables,
- * tool arguments, agent manifests, and x402 payment parameters.
- *
- * These schemas enforce correctness at the boundary: CLI scripts refuse
- * to run if required fields are missing or mis-typed, and SDK methods
- * validate inputs before hitting the chain.
- *
- * Zod is a peer dependency — these schemas are tree-shaken if not imported.
- *
- * @category Utils
- * @since v0.6.0
- */
-// ═══════════════════════════════════════════════════════════════════
-//  Dynamic Zod import (peer dependency)
-// ═══════════════════════════════════════════════════════════════════
-// We use a lazy getter pattern to avoid hard failures when zod is not installed
-let _z = null;
-function getZod() {
-    if (!_z) {
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            _z = require("zod");
-        }
-        catch {
-            throw new Error("[SAP SDK] Zod is required for schema validation. Install it: npm install zod");
-        }
-    }
-    return _z;
-}
-// ═══════════════════════════════════════════════════════════════════
-//  Environment Schemas
-// ═══════════════════════════════════════════════════════════════════
-/**
- * @name createEnvSchema
- * @description Create a Zod schema for SAP SDK environment variables.
- * Validates that all required env vars are present and correctly typed.
- *
- * @returns A Zod schema object for env validation.
- *
- * @category Utils
- * @since v0.6.0
- *
- * @example
- * ```ts
- * import { createEnvSchema } from "@synapse-sap/sdk";
- *
- * const schema = createEnvSchema();
- * const env = schema.parse(process.env);
- * // env.SOLANA_CLUSTER is typed as "mainnet-beta" | "devnet" | "localnet"
- * ```
- */
-export function createEnvSchema() {
-    const z = getZod();
-    return z.object({
-        SOLANA_CLUSTER: z
-            .enum(["mainnet-beta", "devnet", "localnet"])
-            .default("devnet")
-            .describe("Solana cluster"),
-        SOLANA_RPC_URL: z
-            .string()
-            .url()
-            .optional()
-            .describe("Primary RPC endpoint URL"),
-        SOLANA_FALLBACK_RPC_URL: z
-            .string()
-            .url()
-            .optional()
-            .describe("Fallback RPC for SPL token ops"),
-        SOLANA_WS_URL: z
-            .string()
-            .url()
-            .optional()
-            .describe("WebSocket endpoint URL"),
-        WALLET_KEYPAIR_PATH: z
-            .string()
-            .optional()
-            .describe("Path to keypair JSON file"),
-        WALLET_PRIVATE_KEY: z
-            .string()
-            .optional()
-            .describe("Base58 private key (alternative to file)"),
-        SAP_PROGRAM_ID: z
-            .string()
-            .optional()
-            .describe("Custom SAP program ID override"),
-        DATABASE_URL: z
-            .string()
-            .optional()
-            .describe("PostgreSQL connection URL"),
-        LOG_LEVEL: z
-            .enum(["debug", "info", "warn", "error"])
-            .default("info")
-            .describe("Log level"),
-        X402_ENDPOINT: z
-            .string()
-            .url()
-            .optional()
-            .describe("Agent x402 payment endpoint"),
-        AGENT_URI: z
-            .string()
-            .url()
-            .optional()
-            .describe("Agent public API URI"),
-    });
-}
-// ═══════════════════════════════════════════════════════════════════
-//  Endpoint Schemas
-// ═══════════════════════════════════════════════════════════════════
-/**
- * @name createEndpointDescriptorSchema
- * @description Zod schema for {@link EndpointDescriptor}.
- * @returns A Zod schema for endpoint descriptor validation.
- * @category Utils
- * @since v0.6.0
- */
-export function createEndpointDescriptorSchema() {
-    const z = getZod();
-    return z.object({
-        url: z.string().url(),
-        method: z.enum(["GET", "POST", "PUT", "DELETE"]).default("POST"),
-        contentType: z.string().default("application/json"),
-        requiresAuth: z.boolean().default(false),
-        authType: z.enum(["bearer", "api-key", "x402", "none"]).optional(),
-        requiresCSRF: z.boolean().default(false),
-        requiresCookies: z.boolean().default(false),
-        corsOrigins: z.array(z.string()).optional(),
-        requiredHeaders: z.record(z.string(), z.string()).optional(),
-    });
-}
-/**
- * @name createHealthCheckSchema
- * @description Zod schema for {@link HealthCheckDescriptor}.
- * @returns A Zod schema for health check validation.
- * @category Utils
- * @since v0.6.0
- */
-export function createHealthCheckSchema() {
-    const z = getZod();
-    return z.object({
-        url: z.string().url(),
-        expectedStatus: z.number().int().min(100).max(599).default(200),
-        timeoutMs: z.number().int().min(100).max(60_000).default(5000),
-        method: z.enum(["GET", "HEAD"]).default("GET"),
-    });
-}
-// ═══════════════════════════════════════════════════════════════════
-//  Tool Manifest Schemas
-// ═══════════════════════════════════════════════════════════════════
-/**
- * @name createToolManifestEntrySchema
- * @description Zod schema for a single tool in an agent manifest.
- * @returns A Zod schema for tool manifest entry validation.
- * @category Utils
- * @since v0.6.0
- */
-export function createToolManifestEntrySchema() {
-    const z = getZod();
-    return z.object({
-        name: z.string().min(1).max(64),
-        description: z.string().max(256),
-        protocol: z.string().min(1).max(64),
-        category: z.string().min(1),
-        inputSchema: z.record(z.string(), z.unknown()),
-        outputSchema: z.record(z.string(), z.unknown()),
-        httpMethod: z.enum(["GET", "POST", "PUT", "DELETE", "COMPOUND"]).default("POST"),
-        paymentMode: z.enum(["x402", "free", "prepaid", "subscription"]).default("x402"),
-        pricePerCall: z.number().int().min(0).default(0),
-        requiredArgs: z.array(z.string()).default([]),
-        prerequisites: z.array(z.string()).default([]),
-        endpointOverride: createEndpointDescriptorSchema().optional(),
-    });
-}
-/**
- * @name createAgentManifestSchema
- * @description Zod schema for a complete agent manifest.
- * @returns A Zod schema for manifest validation.
- * @category Utils
- * @since v0.6.0
- *
- * @example
- * ```ts
- * import { createAgentManifestSchema } from "@synapse-sap/sdk";
- *
- * const schema = createAgentManifestSchema();
- * const manifest = schema.parse(JSON.parse(fs.readFileSync("manifest.json", "utf-8")));
- * ```
- */
-export function createAgentManifestSchema() {
-    const z = getZod();
-    return z.object({
-        version: z.literal("1.0.0"),
-        wallet: z.string().min(32).max(50),
-        name: z.string().min(1).max(64),
-        description: z.string().max(256),
-        endpoint: createEndpointDescriptorSchema(),
-        healthCheck: createHealthCheckSchema().optional(),
-        tools: z.array(createToolManifestEntrySchema()),
-        supportedNetworks: z.array(z.string()).min(1),
-        generatedAt: z.string().datetime(),
-    });
-}
-// ═══════════════════════════════════════════════════════════════════
-//  x402 Payment Schemas
-// ═══════════════════════════════════════════════════════════════════
-/**
- * @name createPreparePaymentSchema
- * @description Zod schema for x402 payment preparation parameters.
- * @returns A Zod schema for payment option validation.
- * @category Utils
- * @since v0.6.0
- */
-export function createPreparePaymentSchema() {
-    const z = getZod();
-    return z.object({
-        pricePerCall: z.union([z.number(), z.string(), z.bigint()]),
-        maxCalls: z.union([z.number(), z.string(), z.bigint()]).optional(),
-        deposit: z.union([z.number(), z.string(), z.bigint()]),
-        expiresAt: z.union([z.number(), z.string(), z.bigint()]).optional(),
-        volumeCurve: z
-            .array(z.object({
-            afterCalls: z.number().int().min(1),
-            pricePerCall: z.union([z.number(), z.string(), z.bigint()]),
-        }))
-            .optional(),
-        tokenMint: z.string().optional(),
-        tokenDecimals: z.number().int().min(0).max(18).default(9),
-        networkIdentifier: z.string().optional(),
-    });
-}
-// ═══════════════════════════════════════════════════════════════════
-//  Agent Registration Schemas
-// ═══════════════════════════════════════════════════════════════════
-/**
- * @name createRegisterAgentSchema
- * @description Zod schema for agent registration arguments.
- * @returns A Zod schema for registration validation.
- * @category Utils
- * @since v0.6.0
- */
-export function createRegisterAgentSchema() {
-    const z = getZod();
-    return z.object({
-        name: z.string().min(1).max(64),
-        description: z.string().min(1).max(256),
-        agentId: z.string().max(128).optional().nullable(),
-        agentUri: z.string().max(256).optional().nullable(),
-        x402Endpoint: z.string().url().max(256).optional().nullable(),
-        capabilities: z
-            .array(z.object({
-            id: z.string().min(1),
-            description: z.string().nullable().optional(),
-            protocolId: z.string().nullable().optional(),
-            version: z.string().nullable().optional(),
-        }))
-            .max(10)
-            .default([]),
-        protocols: z.array(z.string()).max(5).default([]),
-        pricing: z
-            .array(z.object({
-            tierId: z.string().min(1),
-            pricePerCall: z.union([z.number(), z.string()]),
-            rateLimit: z.number().int().min(0),
-            tokenType: z.enum(["sol", "usdc", "spl"]).default("sol"),
-            settlementMode: z.enum(["instant", "escrow", "batched", "x402"]).default("x402"),
-        }))
-            .max(5)
-            .default([]),
-    });
-}
-// ═══════════════════════════════════════════════════════════════════
-//  CLI Script Argument Schemas
-// ═══════════════════════════════════════════════════════════════════
-/**
- * @name createCallArgsSchema
- * @description Zod schema for `npm run call` script arguments.
- * Ensures all required fields are present before executing an x402 call.
- *
- * @returns A Zod schema for call argument validation.
- * @category Utils
- * @since v0.6.0
- */
-export function createCallArgsSchema() {
-    const z = getZod();
-    return z.object({
-        agentWallet: z.string().min(32).max(50).describe("Agent wallet (base58)"),
-        tool: z.string().min(1).describe("Tool name to invoke"),
-        args: z.record(z.string(), z.unknown()).default({}).describe("Tool arguments (JSON)"),
-        endpoint: z.string().url().optional().describe("Endpoint URL override"),
-        network: z.string().optional().describe("Network identifier override"),
-        maxRetries: z.number().int().min(0).max(10).default(2),
-        timeoutMs: z.number().int().min(1000).max(120_000).default(30_000),
-    });
-}
-/**
- * @name validateOrThrow
- * @description Validate a value against a Zod schema, throwing a SapValidationError
- * with a friendly message if validation fails.
- *
- * @param schema - A Zod schema.
- * @param value - The value to validate.
- * @param label - A label for error messages (e.g. "environment", "call args").
- * @returns The parsed and typed value.
- * @throws {Error} With formatted validation errors.
- *
- * @category Utils
- * @since v0.6.0
- */
-export function validateOrThrow(schema, value, label) {
-    const result = schema.safeParse(value);
-    if (result.success)
-        return schema.parse(value);
-    const issues = result.error?.issues ?? [];
-    const formatted = issues
-        .map((i) => `  • ${i.path.join(".")}: ${i.message}`)
-        .join("\n");
-    throw new Error(`[SAP SDK] Invalid ${label}:\n${formatted}`);
-}
-//# sourceMappingURL=schemas.js.map

package/dist/esm/utils/schemas.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/utils/schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/serialization.js

@@ -1,98 +0,0 @@
-/**
- * @module utils/serialization
- * @description JSON-safe serialization helpers for on-chain account data.
- *
- * On-chain Anchor account objects contain `PublicKey` and `BN` instances
- * that are not JSON-serializable. These helpers convert them to plain
- * strings (`base58` and decimal `string`) recursively.
- *
- * @category Utils
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { serializeAccount } from "@synapse-sap/sdk/utils";
- *
- * const raw = await program.account.agent.fetch(pda);
- * const json = serializeAccount(raw);
- * // { authority: "GBL...", totalCalls: "42", ... }
- * ```
- */
-import { PublicKey } from "@solana/web3.js";
-import BN from "bn.js";
-/**
- * Recursively convert a single value for JSON serialization.
- *
- * - `PublicKey` → base58 string
- * - `BN` → decimal string
- * - `Uint8Array` / `Buffer` → hex string
- * - `Array` → recursed
- * - plain `object` → recursed via {@link serializeAccount}
- * - primitives → identity
- *
- * @name serializeValue
- * @description Transforms a single Anchor-typed value into its JSON-safe equivalent.
- * @param value - The value to serialize.
- * @returns The JSON-safe representation of `value`.
- * @category Utils
- * @since v0.1.0
- * @example
- * ```ts
- * import { serializeValue } from "@synapse-sap/sdk/utils";
- *
- * serializeValue(new PublicKey("11111111111111111111111111111111")); // "1111..."
- * serializeValue(new BN(42)); // "42"
- * ```
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function serializeValue(value) {
-    if (value === null || value === undefined)
-        return null;
-    if (value instanceof PublicKey)
-        return value.toBase58();
-    if (BN.isBN(value))
-        return value.toString();
-    if (value instanceof Uint8Array || Buffer.isBuffer(value))
-        return Buffer.from(value).toString("hex");
-    if (Array.isArray(value))
-        return value.map(serializeValue);
-    if (typeof value === "object") {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return serializeAccount(value);
-    }
-    return value;
-}
-/**
- * Serialize an entire on-chain account object to a JSON-safe shape.
- *
- * Iterates over each key and delegates to {@link serializeValue}.
- * Handles `PublicKey` → base58, `BN` → string, and nested
- * objects / arrays recursively.
- *
- * @name serializeAccount
- * @description Converts all non-primitive fields in an Anchor account record to JSON-safe strings.
- * @param obj - The raw account object returned by `program.account.<name>.fetch()`.
- * @returns A new plain object with all values converted.
- * @category Utils
- * @since v0.1.0
- * @example
- * ```ts
- * import { serializeAccount } from "@synapse-sap/sdk/utils";
- *
- * const raw = await program.account.agent.fetch(pda);
- * const safe = serializeAccount(raw);
- * console.log(JSON.stringify(safe));
- * ```
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function serializeAccount(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-obj) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        result[key] = serializeValue(value);
-    }
-    return result;
-}
-//# sourceMappingURL=serialization.js.map

package/dist/esm/utils/serialization.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../src/utils/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxD,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5C,IAAI,KAAK,YAAY,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,8DAA8D;QAC9D,OAAO,gBAAgB,CAAC,KAA4B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB;AAC9B,8DAA8D;AAC9D,GAAwB;IAGxB,8DAA8D;IAC9D,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/utils/validation.js

@@ -1,33 +0,0 @@
-/**
- * @module utils/validation
- * @description Runtime assertion helpers.
- *
- * @category Utils
- * @since v0.1.0
- */
-/**
- * Assert that a condition holds, throwing a descriptive error otherwise.
- *
- * Uses TypeScript’s `asserts condition` return type so the compiler
- * narrows the guarded value after the call.
- *
- * @name assert
- * @description Runtime guard — throws `RangeError` with a `[SAP SDK]` prefix when the condition is falsy.
- * @param condition - The boolean expression to verify.
- * @param message   - Human-readable message included in the thrown error.
- * @throws {RangeError} When `condition` is `false`.
- * @category Utils
- * @since v0.1.0
- * @example
- * ```ts
- * import { assert } from "@synapse-sap/sdk/utils";
- *
- * assert(name.length <= 64, "Agent name exceeds MAX_NAME_LEN");
- * ```
- */
-export function assert(condition, message) {
-    if (!condition) {
-        throw new RangeError(`[SAP SDK] ${message}`);
-    }
-}
-//# sourceMappingURL=validation.js.map

package/dist/esm/utils/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CACpB,SAAkB,EAClB,OAAe;IAEf,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}