@layerall/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sidarta Veloso
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @layerall/sdk
+
+Minimal TypeScript client for LayerAll orchestrator services.
+
+## Install
+
+```bash
+npm install @layerall/sdk
+```
+
+## Usage
+
+```ts
+import { Orchestrator } from '@layerall/sdk';
+
+const client = new Orchestrator({
+  apiKey: process.env.LAYERALL_API_KEY!,
+  baseUrl: 'https://api.your-allx.com',
+});
+
+const result = await client.operation('create', {
+  payload: { externalId: 'req_123', data: { /* domain payload */ } },
+  strategy: 'round_robin',
+  timeoutMs: 8000,
+});
+
+console.log(result.id, result.provider, result.status, result.providerReceipt);
+```
+
+The same SDK works across any "All‑X" backend (e‑signature, payments, messaging, storage, LLMs, KYC…). See the root [README](../../README.md).

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { OperationName, OperationRequestOptions, OperationResult } from '@layerall/core';
+
+declare class Orchestrator {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly endpoint;
+    private readonly fetchImpl;
+    constructor(opts: {
+        apiKey: string;
+        baseUrl: string;
+        /** Mount path of the operation endpoint (default `/v1/operation`). */
+        endpoint?: string;
+        /** Injectable fetch (for tests/non-browser runtimes). */
+        fetchImpl?: typeof fetch;
+    });
+    /**
+     * Performs an agnostic operation against the orchestrator backend.
+     * The backend resolves policy/strategy and routes to the chosen provider.
+     */
+    operation<TData = unknown, TResult = unknown>(operation: OperationName, params: {
+        payload: {
+            externalId?: string;
+            data: TData;
+        };
+    } & OperationRequestOptions): Promise<OperationResult<TResult>>;
+}
+declare class OrchestratorError extends Error {
+    status: number;
+    code: string;
+    constructor(message: string, status: number, code: string);
+}
+
+export { Orchestrator, OrchestratorError };

package/dist/index.js

@@ -0,0 +1,54 @@
+// src/index.ts
+var Orchestrator = class {
+  constructor(opts) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = opts.baseUrl.replace(/\/$/, "");
+    this.endpoint = opts.endpoint ?? "/v1/operation";
+    this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+  }
+  /**
+   * Performs an agnostic operation against the orchestrator backend.
+   * The backend resolves policy/strategy and routes to the chosen provider.
+   */
+  async operation(operation, params) {
+    const url = `${this.baseUrl}${this.endpoint}/${encodeURIComponent(operation)}`;
+    const body = {
+      payload: params.payload,
+      ...params.strategy ? { strategy: params.strategy } : {},
+      ...typeof params.timeoutMs === "number" ? { timeoutMs: params.timeoutMs } : {},
+      ...typeof params.failover === "boolean" ? { failover: params.failover } : {}
+    };
+    const res = await this.fetchImpl(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body),
+      ...params.signal ? { signal: params.signal } : {}
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      const err = new OrchestratorError(
+        json?.error?.message ?? `HTTP ${res.status}`,
+        res.status,
+        json?.error?.code ?? "http_error"
+      );
+      err.result = json;
+      throw err;
+    }
+    return json;
+  }
+};
+var OrchestratorError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.name = "OrchestratorError";
+    this.status = status;
+    this.code = code;
+  }
+};
+export {
+  Orchestrator,
+  OrchestratorError
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@layerall/sdk",
+  "version": "0.1.0",
+  "description": "Minimal TypeScript client SDK for LayerAll orchestrator services",
+  "keywords": [
+    "sdk",
+    "client",
+    "orchestration",
+    "layerall",
+    "typescript"
+  ],
+  "author": "Sidarta Veloso <sidartaveloso@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sidartaveloso/layerall.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/sidartaveloso/layerall/issues"
+  },
+  "homepage": "https://github.com/sidartaveloso/layerall#readme",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@layerall/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "clean": "rm -rf dist",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:no-coverage": "vitest run"
+  }
+}