@solarpunkltd/swarm-id 0.8.0 → 0.8.2

package/dist/sync/batch-write-coordinator.d.ts

@@ -77,6 +77,7 @@ export interface WithWriteOptions {
     wait?: "block" | "skip";
 }
 export interface BatchWriteCoordinatorDeps {
+    /** Read on every use, so a getter here follows a change of node. */
     bee: Bee;
     /** Postage batch id (hex) — the `withBatchWriteLock` key. */
     batchId: string;

package/dist/sync/device-state.d.ts

@@ -43,8 +43,9 @@ export declare const DeviceStateSnapshotSchemaV1: z.ZodObject<{
         appDescription: z.ZodOptional<z.ZodString>;
         connectedUntil: z.ZodOptional<z.ZodNumber>;
         appSecret: z.ZodOptional<z.ZodString>;
-        postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<BatchId, string>>>;
+        postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<BatchId, string>>]>>;
         postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+        stampPending: z.ZodOptional<z.ZodLiteral<true>>;
         revokedAt: z.ZodOptional<z.ZodNumber>;
         disconnectedAt: z.ZodOptional<z.ZodNumber>;
         chatBinding: z.ZodOptional<z.ZodObject<{

package/dist/types.d.ts

@@ -537,8 +537,10 @@ export type UploadMode = z.infer<typeof UploadModeSchema>;
 /**
  * Why a session cannot upload, when `uploadMode` is `"unavailable"`.
  *
- * - `no-stamp` — no stamp resolved: the account has no drive, or its pointers
- *   name one that is gone
+ * - `no-stamp`: the site has no stamp to use. The account has no drive (or
+ *   its pointers name only drives that are gone), the person set this site to
+ *   no drive, or the person has not yet confirmed the site's drive in the
+ *   connect window since the site signed in.
  * - `stamper-failed` — the stamp resolved and the stamper still did not build.
  *   `initializeStamper` logs and returns rather than throwing, so without this
  *   the symptom is indistinguishable from having no stamp at all.
@@ -653,6 +655,8 @@ export declare const ConnectionInfoSchema: z.ZodObject<{
         message: z.ZodString;
         signature: z.ZodString;
     }, z.core.$strip>>;
+    beeApiUrl: z.ZodOptional<z.ZodString>;
+    postageBatchId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ConnectionInfo = z.infer<typeof ConnectionInfoSchema>;
 export declare const AppMetadataSchema: z.ZodObject<{
@@ -762,6 +766,15 @@ export declare const DeriveAppSecretMessageSchema: z.ZodObject<{
     requestId: z.ZodString;
     label: z.ZodString;
 }, z.core.$strip>;
+/**
+ * The site's own Bee address for this frame from now on, replacing the one
+ * `parentIdentify` gave, for the site's session alone.
+ */
+export declare const SetBeeApiUrlMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"setBeeApiUrl">;
+    requestId: z.ZodString;
+    beeApiUrl: z.ZodString;
+}, z.core.$strip>;
 export declare const GetChatKeyMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"getChatKey">;
     requestId: z.ZodString;
@@ -1366,6 +1379,10 @@ export declare const ParentToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"getChatKey">;
     requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setBeeApiUrl">;
+    requestId: z.ZodString;
+    beeApiUrl: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"stampChunk">;
     requestId: z.ZodString;
@@ -1833,6 +1850,7 @@ export type UploadDataMessage = z.infer<typeof UploadDataMessageSchema>;
 export type DownloadDataMessage = z.infer<typeof DownloadDataMessageSchema>;
 export type DeriveAppSecretMessage = z.infer<typeof DeriveAppSecretMessageSchema>;
 export type GetChatKeyMessage = z.infer<typeof GetChatKeyMessageSchema>;
+export type SetBeeApiUrlMessage = z.infer<typeof SetBeeApiUrlMessageSchema>;
 export type StampChunkSigner = z.infer<typeof StampChunkSignerSchema>;
 export type StampChunkRequest = z.infer<typeof StampChunkRequestSchema>;
 export type StampChunkMessage = z.infer<typeof StampChunkMessageSchema>;
@@ -1917,6 +1935,11 @@ export declare const GetChatKeyResponseMessageSchema: z.ZodObject<{
     requestId: z.ZodString;
     chatKey: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
 }, z.core.$strip>;
+export declare const SetBeeApiUrlResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"setBeeApiUrlResponse">;
+    requestId: z.ZodString;
+    beeApiUrl: z.ZodString;
+}, z.core.$strip>;
 export declare const StampChunkResponseMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"stampChunkResponse">;
     requestId: z.ZodString;
@@ -2122,6 +2145,8 @@ export declare const ConnectionInfoChangedMessageSchema: z.ZodObject<{
         message: z.ZodString;
         signature: z.ZodString;
     }, z.core.$strip>>;
+    beeApiUrl: z.ZodOptional<z.ZodString>;
+    postageBatchId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ConnectResponseMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"connectResponse">;
@@ -2365,6 +2390,10 @@ export declare const IframeToParentMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
     type: z.ZodLiteral<"getChatKeyResponse">;
     requestId: z.ZodString;
     chatKey: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setBeeApiUrlResponse">;
+    requestId: z.ZodString;
+    beeApiUrl: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"stampChunkResponse">;
     requestId: z.ZodString;
@@ -2485,6 +2514,8 @@ export declare const IframeToParentMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
         message: z.ZodString;
         signature: z.ZodString;
     }, z.core.$strip>>;
+    beeApiUrl: z.ZodOptional<z.ZodString>;
+    postageBatchId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"connectResponse">;
     requestId: z.ZodString;
@@ -2671,6 +2702,7 @@ export type AuthSuccessMessage = z.infer<typeof AuthSuccessMessageSchema>;
 export type UploadDataResponseMessage = z.infer<typeof UploadDataResponseMessageSchema>;
 export type DownloadDataResponseMessage = z.infer<typeof DownloadDataResponseMessageSchema>;
 export type GetChatKeyResponseMessage = z.infer<typeof GetChatKeyResponseMessageSchema>;
+export type SetBeeApiUrlResponseMessage = z.infer<typeof SetBeeApiUrlResponseMessageSchema>;
 export type DeriveAppSecretResponseMessage = z.infer<typeof DeriveAppSecretResponseMessageSchema>;
 export type StampChunkResponseMessage = z.infer<typeof StampChunkResponseMessageSchema>;
 export type UploadFileResponseMessage = z.infer<typeof UploadFileResponseMessageSchema>;
@@ -2739,8 +2771,9 @@ export declare const AuthDataSchema: z.ZodObject<{
             appDescription: z.ZodOptional<z.ZodString>;
             connectedUntil: z.ZodOptional<z.ZodNumber>;
             appSecret: z.ZodOptional<z.ZodString>;
-            postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>>;
+            postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>]>>;
             postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+            stampPending: z.ZodOptional<z.ZodLiteral<true>>;
             revokedAt: z.ZodOptional<z.ZodNumber>;
             disconnectedAt: z.ZodOptional<z.ZodNumber>;
             chatBinding: z.ZodOptional<z.ZodObject<{
@@ -2779,6 +2812,7 @@ export declare const AuthDataSchema: z.ZodObject<{
         message: z.ZodString;
         signature: z.ZodString;
     }, z.core.$strip>>;
+    stampPending: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 export type AuthData = z.infer<typeof AuthDataSchema>;
 /**
@@ -2852,8 +2886,9 @@ export declare const SetSecretMessageSchema: z.ZodObject<{
                 appDescription: z.ZodOptional<z.ZodString>;
                 connectedUntil: z.ZodOptional<z.ZodNumber>;
                 appSecret: z.ZodOptional<z.ZodString>;
-                postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>>;
+                postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>]>>;
                 postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+                stampPending: z.ZodOptional<z.ZodLiteral<true>>;
                 revokedAt: z.ZodOptional<z.ZodNumber>;
                 disconnectedAt: z.ZodOptional<z.ZodNumber>;
                 chatBinding: z.ZodOptional<z.ZodObject<{
@@ -2892,6 +2927,7 @@ export declare const SetSecretMessageSchema: z.ZodObject<{
             message: z.ZodString;
             signature: z.ZodString;
         }, z.core.$strip>>;
+        stampPending: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const PopupToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2927,8 +2963,9 @@ export declare const PopupToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 appDescription: z.ZodOptional<z.ZodString>;
                 connectedUntil: z.ZodOptional<z.ZodNumber>;
                 appSecret: z.ZodOptional<z.ZodString>;
-                postageStampBatchID: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>>;
+                postageStampBatchID: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"none">, z.ZodPipe<z.ZodString, z.ZodTransform<import("@ethersphere/core-sdk").BatchId, string>>]>>;
                 postageStampBatchIDAt: z.ZodOptional<z.ZodNumber>;
+                stampPending: z.ZodOptional<z.ZodLiteral<true>>;
                 revokedAt: z.ZodOptional<z.ZodNumber>;
                 disconnectedAt: z.ZodOptional<z.ZodNumber>;
                 chatBinding: z.ZodOptional<z.ZodObject<{
@@ -2967,6 +3004,7 @@ export declare const PopupToIframeMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
             message: z.ZodString;
             signature: z.ZodString;
         }, z.core.$strip>>;
+        stampPending: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">;
 export type SetSecretMessage = z.infer<typeof SetSecretMessageSchema>;
@@ -2990,6 +3028,14 @@ export interface ClientOptions {
     containerId?: string;
     /** URL of a subsidised gateway for users without postage stamps. Gateway handles stamping server-side. */
     subsidisedGatewayUrl?: string;
+    /**
+     * The Bee node this site's content reads and stamped uploads go through, in
+     * place of the node the person set in Swarm ID, which keeps applying on
+     * every other site. The person's account and device coordination stay on
+     * their own node. An http(s) URL, optionally with a path. Change it later
+     * with `setBeeApiUrl`. Held by this site's frame alone and never stored.
+     */
+    beeApiUrl?: string;
 }
 export interface AuthOptions {
     masterKeyStorageKey?: string;

package/dist/utils/postage-stamp-association.d.ts

@@ -1,10 +1,11 @@
-import type { ConnectedApp, PostageStamp, SignedInAccount } from "../schemas";
+import { type ConnectedApp, type PostageStamp, type SignedInAccount } from "../schemas";
 /**
  * Resolve which postage stamp an app should upload with.
  *
  * An app may carry its own batch override (`postageStampBatchID`); otherwise it
  * falls back to the account's default stamp. The account owns the stamp set, so
- * these pointers are the single source of truth.
+ * these pointers are the single source of truth. An app set to
+ * `NO_POSTAGE_STAMP` resolves to no stamp, the default included.
  *
  * The lookup is existence-checked: a pointer whose stamp is missing (e.g. a
  * removed or replaced batch) is skipped so resolution falls through to the next
@@ -36,4 +37,4 @@ export declare function resolveStampForApp(app: Pick<ConnectedApp, "postageStamp
  * cannot upload at all. Tombstones its pointers still name are kept too — a
  * tombstone is how the session learns the stamp it was spending is deleted.
  */
-export declare function stampsReachableByApp(app: Pick<ConnectedApp, "postageStampBatchID">, account: Pick<SignedInAccount, "defaultPostageStampBatchID">, stamps: PostageStamp[]): PostageStamp[];
+export declare function stampsReachableByApp(app: Pick<ConnectedApp, "postageStampBatchID" | "stampPending">, account: Pick<SignedInAccount, "defaultPostageStampBatchID">, stamps: PostageStamp[]): PostageStamp[];

package/dist/utils/url.d.ts

@@ -11,6 +11,14 @@ export declare function normalizeUrl(url: string): string;
  * dialog so a broken Bee/RPC endpoint can't be saved or persisted.
  */
 export declare function isHttpUrl(value: string): boolean;
+/**
+ * True for an address a site may name as its Bee node: an `http:` or
+ * `https:` URL, optionally with a path, the way a gateway in front of Bee is
+ * often mounted. Refused besides what `isHttpUrl` refuses: credentials, which
+ * `fetch` will not send from a URL and throws on, and a query or fragment,
+ * which bee-js would put in the middle of every request path it appends.
+ */
+export declare function isBeeApiUrl(value: string): boolean;
 /**
  * Configuration options for building the authentication URL.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solarpunkltd/swarm-id",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "type": "module",
   "description": "Swarm ID library for authentication and Bee API operations",
   "main": "dist/swarm-id.esm.js",
@@ -19,6 +19,25 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "rollup -c",
+    "build:watch": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:live": "vitest run --config vitest.live.config.ts",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "typecheck": "tsc --noEmit -p tsconfig.check.json",
+    "check:all": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test",
+    "prepack": "npm run clean && npm run build",
+    "check:pack": "node dev/check-pack.js"
+  },
   "keywords": [
     "swarm",
     "identity",
@@ -52,6 +71,8 @@
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-terser": "0.4.4",
     "@rollup/plugin-typescript": "12.3.0",
+    "@swarm-id/eslint-rules": "workspace:*",
+    "@swarm-id/signaling": "workspace:*",
     "@types/node": "24.10.1",
     "@typescript-eslint/eslint-plugin": "8.69.0",
     "@typescript-eslint/parser": "8.69.0",
@@ -62,9 +83,7 @@
     "rollup": "4.53.3",
     "tslib": "2.8.1",
     "typescript": "5.8.3",
-    "vitest": "4.0.14",
-    "@swarm-id/signaling": "0.1.0",
-    "@swarm-id/eslint-rules": "0.0.0"
+    "vitest": "4.0.14"
   },
   "engines": {
     "node": ">=22",
@@ -72,23 +91,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "rollup -c",
-    "build:watch": "rollup -c -w",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:integration": "vitest run --config vitest.integration.config.ts",
-    "test:live": "vitest run --config vitest.live.config.ts",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
-    "typecheck": "tsc --noEmit -p tsconfig.check.json",
-    "check:all": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test",
-    "check:pack": "node dev/check-pack.js"
   }
-}
+}