@tinycloud/node-sdk 3.7.0 → 3.8.0-beta.1

package/dist/{TinyCloudNode-Cw00iiSP.d.ts → TinyCloudNode-Ckqu_fqH.d.ts}

@@ -275,7 +275,9 @@ interface NodeUserAuthorizationConfig {
      * unrestricted `get` covering it is already requested. Storage and
      * scheduling never reach this layer.
      */
-    replication?: Pick<ReplicationOptions, "enabled" | "prefixes" | "allowSecrets">;
+    replication?: Pick<ReplicationOptions, "enabled" | "prefixes" | "allowSecrets" | "syncScope">;
+    /** Extra top-level resource URIs and their abilities added to the sign-in ReCap (e.g. named-key prefixes). */
+    additionalRawAbilities?: Record<string, string[]>;
     /**
      * Mints the replica session stamp on each fresh sign-in (TC-858 §4). Returns
      * `undefined` when replication is off, so the persisted session carries no stamp.
@@ -348,6 +350,7 @@ declare class NodeUserAuthorization implements IUserAuthorization {
     private readonly localNodeIdentityStore?;
     private readonly enablePublicSpace;
     private readonly replication?;
+    private readonly additionalRawAbilities?;
     private readonly establishReplicaStamp?;
     private readonly nonce?;
     private readonly siweConfig?;
@@ -558,7 +561,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      */
     replicationSignInEntries(): PermissionEntry[];
     private defaultEncryptionNetworkId;
+    /** Sign-in capabilities plus the caller's additional top-level resource abilities. */
     private resolveSignInCapabilities;
+    private resolveBaseSignInCapabilities;
     /**
      * Build SIWE overrides from the top-level nonce and siweConfig.
      * - Top-level `nonce` is seeded first so `siweConfig.nonce` wins if both are set.
@@ -1090,6 +1095,8 @@ interface TinyCloudNodeConfig {
      * the same cross-process profile lock as SQLite and pending writes. Browser storage uses
      * its mandatory origin Web Lock instead. Missing guards gate the replica, not the session.
      */
+    /** Extra top-level resource URIs and their abilities added to the sign-in ReCap (e.g. named-key prefixes). */
+    additionalRawAbilities?: Record<string, string[]>;
     replication?: ReplicationOptions & {
         storage: KVReplicaStorage;
         mode?: "background" | "foreground";
@@ -1393,6 +1400,9 @@ declare class TinyCloudNode {
         reason?: string;
         warnings?: BootstrapWarning[];
     };
+    private _freshEncryptionNetworkCreated;
+    /** Whether the last sign-in's fresh account bootstrap created its encryption network. */
+    get freshEncryptionNetworkCreated(): boolean;
     /**
      * Turns every service's storage rejections into one `storage.full` event,
      * and remembers whose storage is full so sign-in and listing skip their

package/dist/{TinyCloudNode-DD7qjyLU.d.cts → TinyCloudNode-DDfx8Fx5.d.cts}

@@ -275,7 +275,9 @@ interface NodeUserAuthorizationConfig {
      * unrestricted `get` covering it is already requested. Storage and
      * scheduling never reach this layer.
      */
-    replication?: Pick<ReplicationOptions, "enabled" | "prefixes" | "allowSecrets">;
+    replication?: Pick<ReplicationOptions, "enabled" | "prefixes" | "allowSecrets" | "syncScope">;
+    /** Extra top-level resource URIs and their abilities added to the sign-in ReCap (e.g. named-key prefixes). */
+    additionalRawAbilities?: Record<string, string[]>;
     /**
      * Mints the replica session stamp on each fresh sign-in (TC-858 §4). Returns
      * `undefined` when replication is off, so the persisted session carries no stamp.
@@ -348,6 +350,7 @@ declare class NodeUserAuthorization implements IUserAuthorization {
     private readonly localNodeIdentityStore?;
     private readonly enablePublicSpace;
     private readonly replication?;
+    private readonly additionalRawAbilities?;
     private readonly establishReplicaStamp?;
     private readonly nonce?;
     private readonly siweConfig?;
@@ -558,7 +561,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      */
     replicationSignInEntries(): PermissionEntry[];
     private defaultEncryptionNetworkId;
+    /** Sign-in capabilities plus the caller's additional top-level resource abilities. */
     private resolveSignInCapabilities;
+    private resolveBaseSignInCapabilities;
     /**
      * Build SIWE overrides from the top-level nonce and siweConfig.
      * - Top-level `nonce` is seeded first so `siweConfig.nonce` wins if both are set.
@@ -1090,6 +1095,8 @@ interface TinyCloudNodeConfig {
      * the same cross-process profile lock as SQLite and pending writes. Browser storage uses
      * its mandatory origin Web Lock instead. Missing guards gate the replica, not the session.
      */
+    /** Extra top-level resource URIs and their abilities added to the sign-in ReCap (e.g. named-key prefixes). */
+    additionalRawAbilities?: Record<string, string[]>;
     replication?: ReplicationOptions & {
         storage: KVReplicaStorage;
         mode?: "background" | "foreground";
@@ -1393,6 +1400,9 @@ declare class TinyCloudNode {
         reason?: string;
         warnings?: BootstrapWarning[];
     };
+    private _freshEncryptionNetworkCreated;
+    /** Whether the last sign-in's fresh account bootstrap created its encryption network. */
+    get freshEncryptionNetworkCreated(): boolean;
     /**
      * Turns every service's storage rejections into one `storage.full` event,
      * and remembers whose storage is full so sign-in and listing skip their

package/dist/{authority-Ck5hZdBn.d.cts → authority-BwM_s3Ya.d.cts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-DD7qjyLU.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-DDfx8Fx5.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {
@@ -12,7 +12,7 @@ declare function hasUnrestrictedGetCoverage(entries: readonly PermissionEntry[],
 declare function augmentSignInEntriesWithReplication(input: {
     entries: readonly PermissionEntry[];
     primarySpaceId: string;
-    replication?: Pick<ReplicationOptions, "prefixes" | "allowSecrets">;
+    replication?: Pick<ReplicationOptions, "prefixes" | "allowSecrets" | "syncScope">;
 }): PermissionEntry[];
 
 /** Report a completed deny from the already-loaded authority; delivery was revoked synchronously. */

package/dist/{authority-DXR6887E.d.ts → authority-DcyJpajL.d.ts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-Cw00iiSP.js';
+import { T as TinyCloudNode } from './TinyCloudNode-Ckqu_fqH.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {
@@ -12,7 +12,7 @@ declare function hasUnrestrictedGetCoverage(entries: readonly PermissionEntry[],
 declare function augmentSignInEntriesWithReplication(input: {
     entries: readonly PermissionEntry[];
     primarySpaceId: string;
-    replication?: Pick<ReplicationOptions, "prefixes" | "allowSecrets">;
+    replication?: Pick<ReplicationOptions, "prefixes" | "allowSecrets" | "syncScope">;
 }): PermissionEntry[];
 
 /** Report a completed deny from the already-loaded authority; delivery was revoked synchronously. */

package/dist/core.cjs

@@ -375,7 +375,7 @@ function augmentSignInEntriesWithReplication(input) {
     }
     eligiblePaths.push(path);
   }
-  if (eligiblePaths.length === replication.prefixes.length && eligiblePaths.length > 0 && hasUnrestrictedGetCoverage(input.entries, input.primarySpaceId, "")) {
+  if (replication.syncScope !== "prefixes" && eligiblePaths.length === replication.prefixes.length && eligiblePaths.length > 0 && hasUnrestrictedGetCoverage(input.entries, input.primarySpaceId, "")) {
     return [{
       service: KV_SERVICE,
       space: input.primarySpaceId,
@@ -547,6 +547,7 @@ var NodeUserAuthorization = class {
     this.includeAccountRegistryPermissions = config.includeAccountRegistryPermissions ?? true;
     this.replication = config.replication?.enabled === true ? config.replication : void 0;
     this.establishReplicaStamp = config.establishReplicaStamp;
+    this.additionalRawAbilities = config.additionalRawAbilities;
     this._manifest = config.manifest;
     this._capabilityRequest = config.capabilityRequest;
     this.sessionManager = config.sessionManager ?? this.wasm.createSessionManager();
@@ -977,7 +978,18 @@ var NodeUserAuthorization = class {
   defaultEncryptionNetworkId(address, chainId) {
     return `urn:tinycloud:encryption:${(0, import_sdk_core5.pkhDid)(address, chainId)}:default`;
   }
+  /** Sign-in capabilities plus the caller's additional top-level resource abilities. */
   resolveSignInCapabilities(address, chainId) {
+    const base = this.resolveBaseSignInCapabilities(address, chainId);
+    const extra = this.additionalRawAbilities;
+    if (extra === void 0 || Object.keys(extra).length === 0) return base;
+    const rawAbilities = { ...base.rawAbilities ?? {} };
+    for (const [resource, actions] of Object.entries(extra)) {
+      for (const action of actions) addRawAbility(rawAbilities, resource, action);
+    }
+    return { ...base, rawAbilities };
+  }
+  resolveBaseSignInCapabilities(address, chainId) {
     const request = this.getCapabilityRequest();
     if (request === void 0) {
       const defaultNetworkId = this.defaultEncryptionNetworkId(address, chainId);
@@ -3849,6 +3861,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._bootstrapStatus = {
       skipped: false
     };
+    this._freshEncryptionNetworkCreated = false;
     /**
      * Turns every service's storage rejections into one `storage.full` event,
      * and remembers whose storage is full so sign-in and listing skip their
@@ -4012,6 +4025,10 @@ var _TinyCloudNode = class _TinyCloudNode {
   get bootstrapStatus() {
     return this._bootstrapStatus;
   }
+  /** Whether the last sign-in's fresh account bootstrap created its encryption network. */
+  get freshEncryptionNetworkCreated() {
+    return this._freshEncryptionNetworkCreated;
+  }
   /**
    * Subscribe to `storage.full`. It fires on the first write any service had
    * rejected because the owner's TinyCloud storage is full
@@ -4214,6 +4231,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       signStrategy: config.signStrategy ?? { type: "auto-sign" },
       wasmBindings: this.wasmBindings,
       ...config.replication?.enabled === true ? { establishReplicaStamp: this.establishReplicaStamp } : {},
+      ...config.additionalRawAbilities === void 0 ? {} : { additionalRawAbilities: config.additionalRawAbilities },
       sessionManager: this.sessionManager,
       sessionStorage: config.sessionStorage ?? new MemorySessionStorage(),
       domain: this.siweDomain,
@@ -4242,7 +4260,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       replication: config.replication?.enabled === true ? {
         enabled: true,
         prefixes: config.replication.prefixes,
-        allowSecrets: config.replication.allowSecrets === true
+        allowSecrets: config.replication.allowSecrets === true,
+        syncScope: config.replication.syncScope
       } : void 0
     });
     this.tc = new import_sdk_core11.TinyCloud(this.auth, {
@@ -4779,6 +4798,7 @@ var _TinyCloudNode = class _TinyCloudNode {
   async bootstrapAccountIfNeeded() {
     this._bootstrapSkipped = false;
     this._bootstrapStatus = { skipped: false };
+    this._freshEncryptionNetworkCreated = false;
     if (this.config.autoBootstrapAccount === false) {
       this._bootstrapStatus = { skipped: true, reason: "auto-bootstrap-disabled" };
       return false;
@@ -5068,6 +5088,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       }
       if (step.kind === "encryption-network-create") {
         await this.ensureEncryptionNetwork(step.networkId, { assumeMissing: mode === "fresh" });
+        if (mode === "fresh") this._freshEncryptionNetworkCreated = true;
       }
       if (step.kind === "secret-records-schema") {
         const db = this.sqlForSpace(step.spaceId).db(step.database);
@@ -6662,7 +6683,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       replication: this.config.replication?.enabled === true ? {
         enabled: true,
         prefixes: this.config.replication.prefixes,
-        allowSecrets: this.config.replication.allowSecrets === true
+        allowSecrets: this.config.replication.allowSecrets === true,
+        syncScope: this.config.replication.syncScope
       } : void 0
     });
     this.tc = new import_sdk_core11.TinyCloud(this.auth, {
@@ -6724,7 +6746,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       replication: this.config.replication?.enabled === true ? {
         enabled: true,
         prefixes: this.config.replication.prefixes,
-        allowSecrets: this.config.replication.allowSecrets === true
+        allowSecrets: this.config.replication.allowSecrets === true,
+        syncScope: this.config.replication.syncScope
       } : void 0
     });
     this.tc = new import_sdk_core11.TinyCloud(this.auth, {