@aithos/sdk 0.1.0-alpha.49 → 0.1.0-alpha.50

package/dist/src/assets.d.ts

@@ -35,8 +35,9 @@
  */
 import { type AssetMetadata, type AssetReference } from "@aithos/assets-crypto";
 export interface CreateAssetsClientArgs {
-    /** Base URL of the deployed assets PDS. */
-    readonly pdsUrl: string;
+    /** Base URL of the assets PDS. Defaults to `https://pds.aithos.be` (the
+     * production vanity domain) when omitted. Override for self-hosting/staging. */
+    readonly pdsUrl?: string;
     /** Subject DID. */
     readonly did: string;
     /** Ed25519 sphere seed (32 bytes). */

package/dist/src/assets.js

@@ -38,6 +38,7 @@
 import { generateAMK, wrapAMKForRecipient, unwrapAMK, encryptAssetBytes, decryptAssetBytes, plaintextSha256Hex, } from "@aithos/assets-crypto";
 import { x25519 } from "@noble/curves/ed25519.js";
 import { sha512 } from "@noble/hashes/sha2.js";
+import { DEFAULT_SDK_ENDPOINTS } from "./endpoints.js";
 import { signOwnerEnvelope } from "./internal/envelope.js";
 /* -------------------------------------------------------------------------- */
 /*  Public factory                                                            */
@@ -58,7 +59,7 @@ export class AssetsClient {
     /** Cache: URN → AMK (recovered on first fetch, reused thereafter). */
     #amkCache = new Map();
     constructor(args) {
-        this.#pdsUrl = args.pdsUrl.replace(/\/$/, "");
+        this.#pdsUrl = (args.pdsUrl ?? DEFAULT_SDK_ENDPOINTS.pds).replace(/\/$/, "");
         this.#did = args.did;
         this.#seed = args.sphereSeed;
         this.#verificationMethod = args.verificationMethod;

package/dist/src/data.d.ts

@@ -7,8 +7,12 @@ export interface AithosSchemaLite {
     readonly defaults: Readonly<Record<string, unknown>>;
 }
 export interface CreateDataClientArgs {
-    /** Base URL of the deployed PDS (e.g. https://abc.execute-api.eu-west-3.amazonaws.com). */
-    readonly pdsUrl: string;
+    /**
+     * PDS base URL. Defaults to `https://pds.aithos.be` (the production vanity
+     * domain, CloudFront-fronted) when omitted. Override for self-hosting or
+     * staging (e.g. a raw `execute-api` URL).
+     */
+    readonly pdsUrl?: string;
     /** Subject DID — typically did:key:… in dev, did:aithos:… in prod. */
     readonly did: string;
     /**
@@ -240,8 +244,9 @@ export interface ListOpts {
 }
 export declare function createDataClient(args: CreateDataClientArgs): DataClient;
 export interface CreateDelegateDataClientArgs {
-    /** PDS base URL (same endpoint the owner writes to). */
-    readonly pdsUrl: string;
+    /** PDS base URL (same endpoint the owner writes to). Defaults to
+     * `https://pds.aithos.be` when omitted. */
+    readonly pdsUrl?: string;
     /** DID of the SUBJECT whose data is being read (the mandate issuer). */
     readonly subjectDid: string;
     /**
@@ -295,8 +300,9 @@ export interface AppendOnlyDataClient {
     reset(): void;
 }
 export interface CreateAppendDataClientArgs {
-    /** PDS base URL (same endpoint the owner writes to). */
-    readonly pdsUrl: string;
+    /** PDS base URL (same endpoint the owner writes to). Defaults to
+     * `https://pds.aithos.be` when omitted. */
+    readonly pdsUrl?: string;
     /** DID of the SUBJECT who owns the target collection (the mandate issuer). */
     readonly subjectDid: string;
     /**

package/dist/src/data.js

@@ -41,6 +41,7 @@ import * as ed from "@noble/ed25519";
 import { multibaseToEd25519PublicKey, edPubToX25519Pub, } from "@aithos/protocol-client";
 import { canonicalize } from "@aithos/protocol-core/canonical";
 import { contactsV1 } from "./data-schema-contacts-v1.js";
+import { DEFAULT_SDK_ENDPOINTS } from "./endpoints.js";
 import { signOwnerEnvelope } from "./internal/envelope.js";
 // noble/ed25519 v2 needs sha512 wired in for sync sign/verify
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -159,7 +160,7 @@ class DataClientImpl {
     #cmkCache = new Map();
     #colCache = new Map();
     constructor(args) {
-        this.#pdsUrl = args.pdsUrl.replace(/\/$/, "");
+        this.#pdsUrl = (args.pdsUrl ?? DEFAULT_SDK_ENDPOINTS.pds).replace(/\/$/, "");
         this.#did = args.did;
         this.#seed = args.sphereSeed;
         this.#vm = args.verificationMethod;

package/dist/src/endpoints.d.ts

@@ -17,6 +17,15 @@ export interface AithosSdkEndpoints {
      * scope without the other.
      */
     readonly web: string;
+    /**
+     * Personal Data Store base URL — the `aithos.data.*` sub-protocol PDS
+     * (and the assets sub-protocol, which shares the same host). Default
+     * `https://pds.aithos.be`. Previously every app had to pass a raw
+     * `execute-api` URL to `createDataClient` / `createAssetsClient`; this
+     * centralizes it on the vanity domain (CloudFront-fronted, same as the
+     * other surfaces). Override for self-hosting or staging.
+     */
+    readonly pds: string;
 }
 /** Production defaults. */
 export declare const DEFAULT_SDK_ENDPOINTS: AithosSdkEndpoints;

package/dist/src/endpoints.js

@@ -5,6 +5,7 @@ export const DEFAULT_SDK_ENDPOINTS = {
     compute: "https://compute.aithos.be",
     wallet: "https://wallet.aithos.be",
     web: "https://extract.aithos.be",
+    pds: "https://pds.aithos.be",
 };
 /** Compose the full compute-invoke URL: `${compute}/v1/invoke`. */
 export function computeInvokeUrl(endpoints) {

package/dist/test/endpoints.test.js

@@ -24,6 +24,7 @@ describe("computeInvokeUrl", () => {
             compute: "https://compute.aithos.be",
             wallet: "https://wallet.aithos.be",
             web: "https://extract.aithos.be",
+            pds: "https://pds.aithos.be",
         }), "https://compute.aithos.be/v1/invoke");
     });
     it("trims a trailing slash on the compute base", () => {
@@ -31,6 +32,7 @@ describe("computeInvokeUrl", () => {
             compute: "https://compute.aithos.be/",
             wallet: "https://wallet.aithos.be",
             web: "https://extract.aithos.be",
+            pds: "https://pds.aithos.be",
         }), "https://compute.aithos.be/v1/invoke");
     });
 });
@@ -40,6 +42,7 @@ describe("walletTopupCheckoutUrl", () => {
             compute: "https://compute.aithos.be",
             wallet: "https://wallet.aithos.be",
             web: "https://extract.aithos.be",
+            pds: "https://pds.aithos.be",
         }), "https://wallet.aithos.be/v1/wallet/topup/checkout");
     });
 });
@@ -49,6 +52,7 @@ describe("webInvokeUrl", () => {
             compute: "https://compute.aithos.be",
             wallet: "https://wallet.aithos.be",
             web: "https://extract.aithos.be",
+            pds: "https://pds.aithos.be",
         }), "https://extract.aithos.be/v1/invoke");
     });
     it("trims a trailing slash on the web base", () => {
@@ -56,6 +60,7 @@ describe("webInvokeUrl", () => {
             compute: "https://compute.aithos.be",
             wallet: "https://wallet.aithos.be",
             web: "https://extract.aithos.be/",
+            pds: "https://pds.aithos.be",
         }), "https://extract.aithos.be/v1/invoke");
     });
 });

package/dist/test/sdk.test.js

@@ -33,6 +33,8 @@ describe("DEFAULT_SDK_ENDPOINTS", () => {
     it("points at the production Aithos hosts", () => {
         assert.equal(DEFAULT_SDK_ENDPOINTS.compute, "https://compute.aithos.be");
         assert.equal(DEFAULT_SDK_ENDPOINTS.wallet, "https://wallet.aithos.be");
+        assert.equal(DEFAULT_SDK_ENDPOINTS.web, "https://extract.aithos.be");
+        assert.equal(DEFAULT_SDK_ENDPOINTS.pds, "https://pds.aithos.be");
     });
 });
 describe("AithosSDK constructor", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aithos/sdk",
-  "version": "0.1.0-alpha.49",
+  "version": "0.1.0-alpha.50",
   "description": "Aithos SDK — high-level TypeScript developer kit for building agentic apps on the Aithos protocol. Wraps @aithos/protocol-client and exposes the Aithos compute proxy and wallet (Stripe top-up) endpoints.",
   "keywords": [
     "aithos",