@enbox/api 0.6.30 → 0.6.32

package/dist/esm/enbox.js

@@ -154,7 +154,7 @@ export class Enbox {
      *
      * // Caller-owned auth: enbox.disconnect() only stops Enbox-side state.
      * const auth = await AuthManager.create({...});
-     * const session = await auth.connect();
+     * const session = await auth.connectVault({ createIdentity: true });
      * const enbox = Enbox.fromSession(session);
      * await enbox.disconnect();   // stops sync + clears typed-enbox cache
      * await auth.disconnect();    // sign-out: caller's responsibility
@@ -282,12 +282,12 @@ export class Enbox {
      * - `new Enbox({ agent, connectedDid })` for raw parameters
      * - {@link Enbox.fromSession} for session-shaped objects
      *
-     * Routing happens at runtime inside `AuthManager._isVaultConnect`:
-     * presence of a non-empty `protocols` array or a `connectHandler` selects
-     * the handler flow; everything else routes to local. Local-style fields
-     * (`password`, `dwnEndpoints`, etc.) are forwarded to both the manager
-     * (as defaults) and the per-call payload, so behavior is consistent with
-     * restored sessions.
+     * Routing happens at runtime inside `AuthManager.connect`: a recovery phrase
+     * is treated as an explicit vault-restore action; otherwise, a non-empty
+     * `protocols` array or a `connectHandler` selects the handler flow and
+     * everything else routes to local. Local-style fields (`password`,
+     * `dwnEndpoints`, etc.) are forwarded to both the manager (as defaults) and
+     * the per-call payload, so behavior is consistent with restored sessions.
      *
      * If you need exact control of the `AuthManager.connect()` payload,
      * drop down one layer: create the `AuthManager` yourself with
@@ -426,9 +426,8 @@ export class Enbox {
      * The `satisfies Partial<ConnectOptions>` annotation makes the
      * compiler verify every key in the allowlist exists on `ConnectOptions`,
      * so misspelling a field name is a type error rather than a silent
-     * drop. Routing between local and handler flow happens inside
-     * `AuthManager._isVaultConnect` based on the presence of `protocols`
-     * / `connectHandler`.
+     * drop. Routing between restore, local, and handler flow happens inside
+     * `AuthManager.connect`.
      *
      * `protocols: []` is normalized away — an empty array carries no
      * permission intent and would otherwise produce a zero-grant

package/dist/esm/enbox.js.map

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

package/dist/types/enbox-types.d.ts

@@ -66,16 +66,15 @@ export type EnboxSessionParams = AgentSessionPrimitives;
  * 2. **Per-call signals** ({@link HandlerConnectOptions} ∪
  *    {@link VaultConnectOptions}) — `protocols`, `createIdentity`,
  *    `recoveryPhrase`, `metadata`, etc. Forwarded to
- *    `AuthManager.connect()` and used to route handler vs local flow.
+ *    `AuthManager.connect()` and used to route restore, handler, or local flow.
  *
  * Several fields (`password`, `sync`, `dwnEndpoints`, `connectHandler`)
  * appear on multiple parents. The intersection keeps a single `?:`-typed
  * field; the value flows to both the manager (as a default) and the
  * per-call payload — matching the behavior of restored sessions.
  *
- * Routing between local and handler flow happens at runtime inside
- * `AuthManager._isLocalConnect` based on whether `protocols` or
- * `connectHandler` is provided. See `Enbox.connect()` for examples.
+ * Routing between restore, local, and handler flow happens at runtime inside
+ * `AuthManager.connect`. See `Enbox.connect()` for examples.
  *
  * If you need full control of the exact options forwarded to
  * `AuthManager.connect()`, drop down one layer: create the

package/dist/types/enbox-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enbox-types.d.ts","sourceRoot":"","sources":["../../src/enbox-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,iGAAiG;IACjG,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACpC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mEAAmE;IACnE,GAAG,EAAE,YAAY,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAAG;IAC9D,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uDAAuD;IACvD,IAAI,EAAE,WAAW,CAAC;IAElB,yCAAyC;IACzC,KAAK,EAAE,KAAK,CAAC;IAEb,8DAA8D;IAC9D,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC"}
+{"version":3,"file":"enbox-types.d.ts","sourceRoot":"","sources":["../../src/enbox-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,iGAAiG;IACjG,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACpC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mEAAmE;IACnE,GAAG,EAAE,YAAY,CAAC;CACnB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAAG;IAC9D,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,0EAA0E;AAC1E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uDAAuD;IACvD,IAAI,EAAE,WAAW,CAAC;IAElB,yCAAyC;IACzC,KAAK,EAAE,KAAK,CAAC;IAEb,8DAA8D;IAC9D,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC"}

package/dist/types/enbox.d.ts

@@ -138,7 +138,7 @@ export declare class Enbox {
      *
      * // Caller-owned auth: enbox.disconnect() only stops Enbox-side state.
      * const auth = await AuthManager.create({...});
-     * const session = await auth.connect();
+     * const session = await auth.connectVault({ createIdentity: true });
      * const enbox = Enbox.fromSession(session);
      * await enbox.disconnect();   // stops sync + clears typed-enbox cache
      * await auth.disconnect();    // sign-out: caller's responsibility
@@ -197,12 +197,12 @@ export declare class Enbox {
      * - `new Enbox({ agent, connectedDid })` for raw parameters
      * - {@link Enbox.fromSession} for session-shaped objects
      *
-     * Routing happens at runtime inside `AuthManager._isVaultConnect`:
-     * presence of a non-empty `protocols` array or a `connectHandler` selects
-     * the handler flow; everything else routes to local. Local-style fields
-     * (`password`, `dwnEndpoints`, etc.) are forwarded to both the manager
-     * (as defaults) and the per-call payload, so behavior is consistent with
-     * restored sessions.
+     * Routing happens at runtime inside `AuthManager.connect`: a recovery phrase
+     * is treated as an explicit vault-restore action; otherwise, a non-empty
+     * `protocols` array or a `connectHandler` selects the handler flow and
+     * everything else routes to local. Local-style fields (`password`,
+     * `dwnEndpoints`, etc.) are forwarded to both the manager (as defaults) and
+     * the per-call payload, so behavior is consistent with restored sessions.
      *
      * If you need exact control of the `AuthManager.connect()` payload,
      * drop down one layer: create the `AuthManager` yourself with
@@ -248,9 +248,8 @@ export declare class Enbox {
      * The `satisfies Partial<ConnectOptions>` annotation makes the
      * compiler verify every key in the allowlist exists on `ConnectOptions`,
      * so misspelling a field name is a type error rather than a silent
-     * drop. Routing between local and handler flow happens inside
-     * `AuthManager._isVaultConnect` based on the presence of `protocols`
-     * / `connectHandler`.
+     * drop. Routing between restore, local, and handler flow happens inside
+     * `AuthManager.connect`.
      *
      * `protocols: []` is normalized away — an empty array carries no
      * permission intent and would otherwise produce a zero-grant

package/dist/types/enbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enbox.d.ts","sourceRoot":"","sources":["../../src/enbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAkBpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,KAAK;IAChB;;;;;;OAMG;IACI,KAAK,EAAE,kBAAkB,CAAC;IAEjC,gFAAgF;IACzE,GAAG,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgE;IAEhG,qFAAqF;IAC9E,EAAE,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAAC,CAAgB;gBAE3B,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,WAAW;IAO7D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACI,KAAK,CAAC,CAAC,SAAS,kBAAkB,EAAE,CAAC,SAAS,SAAS,EAC5D,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAenB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;IACU,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAY1C,aAAa;IAwC3B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACW,SAAS,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB;IAc3E;;;;;;;;;;OAUG;WACW,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,KAAK;IAQ7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACiB,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqF3F;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmBnC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAyBpC"}
+{"version":3,"file":"enbox.d.ts","sourceRoot":"","sources":["../../src/enbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAkBpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,KAAK;IAChB;;;;;;OAMG;IACI,KAAK,EAAE,kBAAkB,CAAC;IAEjC,gFAAgF;IACzE,GAAG,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgE;IAEhG,qFAAqF;IAC9E,EAAE,EAAE,KAAK,CAAC;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAAC,CAAgB;gBAE3B,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,WAAW;IAO7D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACI,KAAK,CAAC,CAAC,SAAS,kBAAkB,EAAE,CAAC,SAAS,SAAS,EAC5D,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;IAenB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiDG;IACU,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAY1C,aAAa;IAwC3B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACW,SAAS,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB;IAc3E;;;;;;;;;;OAUG;WACW,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,KAAK;IAQ7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACiB,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqF3F;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmBnC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAyBpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enbox/api",
-  "version": "0.6.30",
+  "version": "0.6.32",
   "description": "Enbox SDK — high-level API for Decentralized Web Nodes, DIDs, and Verifiable Credentials",
   "type": "module",
   "main": "./dist/esm/index.js",
@@ -81,15 +81,15 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@enbox/agent": "0.7.5",
-    "@enbox/auth": "0.6.38",
+    "@enbox/agent": "0.7.7",
+    "@enbox/auth": "0.6.40",
     "@enbox/common": "0.1.1",
-    "@enbox/dwn-clients": "0.4.1"
+    "@enbox/dwn-clients": "0.4.2"
   },
   "devDependencies": {
     "@enbox/crypto": "0.1.1",
     "@enbox/dids": "0.1.1",
-    "@enbox/dwn-sdk-js": "0.3.6",
+    "@enbox/dwn-sdk-js": "0.3.7",
     "@types/node": "22.19.15",
     "@types/sinon": "17.0.3",
     "@typescript-eslint/eslint-plugin": "8.32.1",

package/src/enbox-types.ts

@@ -78,16 +78,15 @@ export type EnboxSessionParams = AgentSessionPrimitives;
  * 2. **Per-call signals** ({@link HandlerConnectOptions} ∪
  *    {@link VaultConnectOptions}) — `protocols`, `createIdentity`,
  *    `recoveryPhrase`, `metadata`, etc. Forwarded to
- *    `AuthManager.connect()` and used to route handler vs local flow.
+ *    `AuthManager.connect()` and used to route restore, handler, or local flow.
  *
  * Several fields (`password`, `sync`, `dwnEndpoints`, `connectHandler`)
  * appear on multiple parents. The intersection keeps a single `?:`-typed
  * field; the value flows to both the manager (as a default) and the
  * per-call payload — matching the behavior of restored sessions.
  *
- * Routing between local and handler flow happens at runtime inside
- * `AuthManager._isLocalConnect` based on whether `protocols` or
- * `connectHandler` is provided. See `Enbox.connect()` for examples.
+ * Routing between restore, local, and handler flow happens at runtime inside
+ * `AuthManager.connect`. See `Enbox.connect()` for examples.
  *
  * If you need full control of the exact options forwarded to
  * `AuthManager.connect()`, drop down one layer: create the

package/src/enbox.ts

@@ -204,7 +204,7 @@ export class Enbox {
    *
    * // Caller-owned auth: enbox.disconnect() only stops Enbox-side state.
    * const auth = await AuthManager.create({...});
-   * const session = await auth.connect();
+   * const session = await auth.connectVault({ createIdentity: true });
    * const enbox = Enbox.fromSession(session);
    * await enbox.disconnect();   // stops sync + clears typed-enbox cache
    * await auth.disconnect();    // sign-out: caller's responsibility
@@ -333,12 +333,12 @@ export class Enbox {
    * - `new Enbox({ agent, connectedDid })` for raw parameters
    * - {@link Enbox.fromSession} for session-shaped objects
    *
-   * Routing happens at runtime inside `AuthManager._isVaultConnect`:
-   * presence of a non-empty `protocols` array or a `connectHandler` selects
-   * the handler flow; everything else routes to local. Local-style fields
-   * (`password`, `dwnEndpoints`, etc.) are forwarded to both the manager
-   * (as defaults) and the per-call payload, so behavior is consistent with
-   * restored sessions.
+   * Routing happens at runtime inside `AuthManager.connect`: a recovery phrase
+   * is treated as an explicit vault-restore action; otherwise, a non-empty
+   * `protocols` array or a `connectHandler` selects the handler flow and
+   * everything else routes to local. Local-style fields (`password`,
+   * `dwnEndpoints`, etc.) are forwarded to both the manager (as defaults) and
+   * the per-call payload, so behavior is consistent with restored sessions.
    *
    * If you need exact control of the `AuthManager.connect()` payload,
    * drop down one layer: create the `AuthManager` yourself with
@@ -486,9 +486,8 @@ export class Enbox {
    * The `satisfies Partial<ConnectOptions>` annotation makes the
    * compiler verify every key in the allowlist exists on `ConnectOptions`,
    * so misspelling a field name is a type error rather than a silent
-   * drop. Routing between local and handler flow happens inside
-   * `AuthManager._isVaultConnect` based on the presence of `protocols`
-   * / `connectHandler`.
+   * drop. Routing between restore, local, and handler flow happens inside
+   * `AuthManager.connect`.
    *
    * `protocols: []` is normalized away — an empty array carries no
    * permission intent and would otherwise produce a zero-grant