@patchr-core/sdk 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# Patchr Node.js SDK
+
+```bash
+npm install @patchr-core/sdk
+```
+
+```ts
+import { PatchrClient } from "@patchr-core/sdk";
+
+const patchr = PatchrClient.fromEnv();
+const manifest = await patchr.manifest();
+const run = await patchr.runWorkflowTemplate("auditDisputedClaim", {
+  claim: "seller name and payment instructions do not match",
+});
+```
+
+Set `PATCHR_API_BASE_URL` and `PATCHR_API_TOKEN` for hosted API calls. The default base URL is `https://api.patchr.co`.

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue | undefined;
+};
+export type PatchrClientOptions = {
+    baseUrl?: string;
+    token?: string;
+    fetch?: typeof fetch;
+};
+export declare class PatchrApiError extends Error {
+    readonly status: number;
+    readonly payload: JsonValue;
+    constructor(status: number, payload: JsonValue);
+}
+export declare class PatchrClient {
+    readonly baseUrl: string;
+    readonly token: string;
+    private readonly fetchImpl;
+    constructor(options?: PatchrClientOptions);
+    static fromEnv(env?: Record<string, string | undefined>): PatchrClient;
+    request<T = JsonValue>(method: string, path: string, payload?: JsonObject | null): Promise<T>;
+    get<T = JsonValue>(path: string, query?: JsonObject): Promise<T>;
+    post<T = JsonValue>(path: string, payload?: JsonObject): Promise<T>;
+    health(): Promise<JsonValue>;
+    apiStatus(): Promise<JsonValue>;
+    manifest(): Promise<JsonValue>;
+    protocolMap(): Promise<JsonValue>;
+    listSchemas(): Promise<JsonValue>;
+    getSchema(schemaId: string): Promise<JsonValue>;
+    listWorkflowTemplates(): Promise<JsonValue>;
+    getWorkflowTemplate(templateId: string): Promise<JsonValue>;
+    runWorkflowTemplate(templateId: string, payload: JsonObject): Promise<JsonValue>;
+    runOrchestrator(payload: JsonObject): Promise<JsonValue>;
+    createA2AEnvelope(payload: JsonObject): Promise<JsonValue>;
+    createTask(payload: JsonObject): Promise<JsonValue>;
+    createProofPack(payload: JsonObject): Promise<JsonValue>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AACjE,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC;AAEF,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;gBAEhB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;CAM/C;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,GAAE,mBAAwB;IAS7C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,YAAY;IAShE,OAAO,CAAC,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IA4BnG,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE,IAAI,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC;IAInE,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAI5B,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;IAI/B,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAI9B,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAIjC,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAIjC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI/C,qBAAqB,IAAI,OAAO,CAAC,SAAS,CAAC;IAI3C,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3D,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhF,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAIxD,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAI1D,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAInD,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;CAGzD"}

package/dist/index.js

@@ -0,0 +1,127 @@
+export class PatchrApiError extends Error {
+    status;
+    payload;
+    constructor(status, payload) {
+        super(typeof payload === "object" && payload !== null && "error" in payload ? String(payload.error) : `patchr_api_${status}`);
+        this.name = "PatchrApiError";
+        this.status = status;
+        this.payload = payload;
+    }
+}
+export class PatchrClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(options = {}) {
+        this.baseUrl = options.baseUrl ?? "https://api.patchr.co";
+        this.token = options.token ?? "";
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        if (!this.fetchImpl) {
+            throw new Error("PatchrClient requires a fetch implementation. Use Node.js 18+ or pass options.fetch.");
+        }
+    }
+    static fromEnv(env) {
+        const processEnv = globalThis.process?.env ?? {};
+        const source = env ?? processEnv;
+        return new PatchrClient({
+            baseUrl: source.PATCHR_API_BASE_URL || source.PICUX_API_BASE_URL || "https://api.patchr.co",
+            token: source.PATCHR_API_TOKEN || source.PICUX_API_TOKEN || "",
+        });
+    }
+    async request(method, path, payload) {
+        let url = joinUrl(this.baseUrl, path);
+        let body;
+        const headers = new Headers({ Accept: "application/json" });
+        if (this.token) {
+            headers.set("Authorization", `Bearer ${this.token}`);
+        }
+        if (method.toUpperCase() === "GET" && payload && Object.keys(payload).length > 0) {
+            url = withQuery(url, payload);
+        }
+        else if (payload !== undefined && payload !== null) {
+            headers.set("Content-Type", "application/json");
+            body = JSON.stringify(payload);
+        }
+        const response = await this.fetchImpl(url, {
+            method: method.toUpperCase(),
+            headers,
+            body,
+        });
+        const parsed = await parseResponse(response);
+        if (!response.ok) {
+            throw new PatchrApiError(response.status, parsed);
+        }
+        return parsed;
+    }
+    get(path, query) {
+        return this.request("GET", path, query);
+    }
+    post(path, payload) {
+        return this.request("POST", path, payload ?? {});
+    }
+    health() {
+        return this.get("/healthz");
+    }
+    apiStatus() {
+        return this.get("/v1/status");
+    }
+    manifest() {
+        return this.get("/v1/manifest");
+    }
+    protocolMap() {
+        return this.get("/v1/protocol-map");
+    }
+    listSchemas() {
+        return this.get("/v1/schemas");
+    }
+    getSchema(schemaId) {
+        return this.get(`/v1/schemas/${encodeURIComponent(schemaId)}`);
+    }
+    listWorkflowTemplates() {
+        return this.get("/v1/workflows/templates");
+    }
+    getWorkflowTemplate(templateId) {
+        return this.get(`/v1/workflows/templates/${encodeURIComponent(templateId)}`);
+    }
+    runWorkflowTemplate(templateId, payload) {
+        return this.post(`/v1/workflows/templates/${encodeURIComponent(templateId)}/run`, payload);
+    }
+    runOrchestrator(payload) {
+        return this.post("/v1/orchestrator/run", payload);
+    }
+    createA2AEnvelope(payload) {
+        return this.post("/v1/a2a/envelopes", payload);
+    }
+    createTask(payload) {
+        return this.post("/v1/tasks", payload);
+    }
+    createProofPack(payload) {
+        return this.post("/v1/audit/proofPacks", payload);
+    }
+}
+function joinUrl(baseUrl, path) {
+    return `${baseUrl.replace(/\/+$/, "")}/${path.replace(/^\/+/, "")}`;
+}
+function withQuery(url, query) {
+    const next = new URL(url);
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        next.searchParams.set(key, String(value));
+    }
+    return next.toString();
+}
+async function parseResponse(response) {
+    if (response.status === 204)
+        return {};
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { text };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@patchr-core/sdk",
+  "version": "0.1.0",
+  "description": "Patchr JavaScript and TypeScript SDK for API, MCP, A2A, and workflow surfaces.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "homepage": "https://patchr.co",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orepos/Picux.git",
+    "directory": "packages/node-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/orepos/Picux/issues"
+  },
+  "keywords": [
+    "patchr",
+    "sdk",
+    "mcp",
+    "a2a",
+    "agents",
+    "workflows"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test test/*.test.mjs",
+    "prepublishOnly": "npm run build && npm test"
+  }
+}