@tinycloud/cli 0.7.0-beta.1 → 0.7.0-beta.3

package/dist/index.js

@@ -973,11 +973,19 @@ Open this URL in a browser to authenticate:
 
 // src/commands/init.ts
 function registerInitCommand(program2) {
-  program2.command("init").description("Initialize a new TinyCloud profile").option("--name <profile>", "Profile name", "default").option("--key-only", "Only generate key, skip authentication").option("--host <url>", "TinyCloud node URL").option("--paste", "Use manual paste mode for authentication").option("--no-popup", "Print the OpenKey URL without opening a browser").action(async (options, cmd) => {
+  program2.command("init").description("Initialize a new TinyCloud profile").option("--name <profile>", "Profile name", "default").option("--key-only", "Only generate key, skip authentication").option("--host <url>", "TinyCloud node URL").option("--paste", "Use manual paste mode for authentication").option("--no-popup", "Print the OpenKey URL without opening a browser").option("--default-space <name>", "Default space used when --space is omitted (e.g. applications)").action(async (options, cmd) => {
     try {
       const globalOpts = cmd.optsWithGlobals();
       const profileName = options.name;
       const host = options.host ?? globalOpts.host ?? DEFAULT_HOST;
+      const defaultSpace = options.defaultSpace;
+      if (defaultSpace !== void 0 && !/^[A-Za-z0-9_-]+$/.test(defaultSpace)) {
+        throw new CLIError(
+          "INVALID_SPACE",
+          `Invalid --default-space "${defaultSpace}". Use a short name ([A-Za-z0-9_-]).`,
+          ExitCode.USAGE_ERROR
+        );
+      }
       if (await ProfileManager.profileExists(profileName)) {
         throw new CLIError(
           "PROFILE_EXISTS",
@@ -996,7 +1004,8 @@ function registerInitCommand(program2) {
         chainId: DEFAULT_CHAIN_ID,
         spaceName: "default",
         did,
-        createdAt: (/* @__PURE__ */ new Date()).toISOString()
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        ...defaultSpace ? { defaultSpace } : {}
       };
       await ProfileManager.setProfile(profileName, profileConfig);
       const config = await ProfileManager.getConfig();
@@ -5781,6 +5790,38 @@ var KVService = class extends BaseService {
       signal: this.combineSignals(signal)
     });
   }
+  /**
+   * Serialize a single put value into a fetch body.
+   *
+   * Binary values (Blob/ArrayBuffer/typed-array, incl. Node Buffer) are sent as
+   * raw bytes (as a Blob) so they round-trip byte-identically — without this a
+   * Buffer would be JSON.stringify'd into `{"type":"Buffer","data":[...]}`.
+   * Strings are returned unchanged (preserving prior behavior); other values are
+   * JSON-encoded. `contentType` overrides the inferred type for binary values.
+   */
+  serializePutValue(value, contentType) {
+    if (value instanceof Blob) {
+      if (!contentType || value.type === contentType) {
+        return value;
+      }
+      return new Blob([value], { type: contentType });
+    }
+    if (value instanceof ArrayBuffer) {
+      return new Blob([value], {
+        type: contentType ?? "application/octet-stream"
+      });
+    }
+    if (ArrayBuffer.isView(value)) {
+      const view = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+      return new Blob([view], {
+        type: contentType ?? "application/octet-stream"
+      });
+    }
+    if (typeof value === "string") {
+      return contentType ? new Blob([value], { type: contentType }) : value;
+    }
+    return JSON.stringify(value);
+  }
   serializeBatchPutValue(item) {
     const contentType = item.contentType;
     if (item.value instanceof Blob) {
@@ -5850,10 +5891,13 @@ var KVService = class extends BaseService {
    * @param raw - Whether to return raw text
    * @returns Parsed data
    */
-  async parseResponse(response, raw = false) {
+  async parseResponse(response, raw = false, binary = false) {
     if (!response.ok) {
       return void 0;
     }
+    if (binary) {
+      return new Uint8Array(await response.arrayBuffer());
+    }
     if (raw) {
       return await response.text();
     }
@@ -5960,7 +6004,11 @@ var KVService = class extends BaseService {
             )
           );
         }
-        const data = await this.parseResponse(response, options?.raw);
+        const data = await this.parseResponse(
+          response,
+          options?.raw,
+          options?.binary
+        );
         return ok({
           data,
           headers: this.createResponseHeaders(response.headers)
@@ -5979,12 +6027,7 @@ var KVService = class extends BaseService {
         return err(authRequiredError("kv"));
       }
       const path = this.getFullPath(key, options?.prefix);
-      let body;
-      if (typeof value === "string") {
-        body = value;
-      } else {
-        body = JSON.stringify(value);
-      }
+      const body = this.serializePutValue(value, options?.contentType);
       try {
         const response = await this.invokeOperation(
           path,
@@ -10733,30 +10776,31 @@ function resolveChainId(profile, session) {
   return profile.chainId;
 }
 async function resolveSpaceUri(input, profileName) {
-  if (!input) return void 0;
-  if (input.startsWith("tinycloud:")) {
-    const parsed = parseSpaceUri(input);
+  const profile = await ProfileManager.getProfile(profileName);
+  const effective = input || profile.defaultSpace;
+  if (!effective) return void 0;
+  if (effective.startsWith("tinycloud:")) {
+    const parsed = parseSpaceUri(effective);
     if (!parsed) {
       throw new CLIError(
         "INVALID_SPACE",
-        `Invalid --space "${input}". Use a short name ([A-Za-z0-9_-]) or a full tinycloud:... URI.`,
+        `Invalid space "${effective}". Use a short name ([A-Za-z0-9_-]) or a full tinycloud:... URI.`,
         ExitCode.USAGE_ERROR
       );
     }
     return buildSpaceUri(parsed.owner, parsed.name);
   }
-  if (!/^[A-Za-z0-9_-]+$/.test(input)) {
+  if (!/^[A-Za-z0-9_-]+$/.test(effective)) {
     throw new CLIError(
       "INVALID_SPACE",
-      `Invalid --space "${input}". Use a short name ([A-Za-z0-9_-]) or a full tinycloud:... URI.`,
+      `Invalid space "${effective}". Use a short name ([A-Za-z0-9_-]) or a full tinycloud:... URI.`,
       ExitCode.USAGE_ERROR
     );
   }
-  const profile = await ProfileManager.getProfile(profileName);
   const session = await ProfileManager.getSession(profileName);
   const address = resolveAddress(profile, session);
   const chainId = resolveChainId(profile, session);
-  return makePkhSpaceId(address, chainId, input);
+  return makePkhSpaceId(address, chainId, effective);
 }
 
 // src/lib/permissions.ts
@@ -11874,9 +11918,10 @@ function groupPermissionsBySpace(permissions) {
       rawEntries.push(permission);
       continue;
     }
-    const group = groups.get(permission.space) ?? [];
+    const key = normalizeSpaceForCompare(permission.space);
+    const group = groups.get(key) ?? [];
     group.push(permission);
-    groups.set(permission.space, group);
+    groups.set(key, group);
   }
   const grouped = Array.from(groups.values());
   if (grouped.length === 0) {
@@ -11888,8 +11933,16 @@ function groupPermissionsBySpace(permissions) {
 function isRawPermission(permission) {
   return permission.service === "tinycloud.encryption" && permission.path.startsWith("urn:tinycloud:encryption:");
 }
+function normalizeSpaceForCompare(space) {
+  return space.replace(
+    /(eip155:\d+:)(0x[0-9a-fA-F]{40})/,
+    (_match, prefix, addr) => prefix + addr.toLowerCase()
+  );
+}
 function returnedSpaceMatchesExpected(returnedSpace, expectedSpace) {
-  if (returnedSpace === expectedSpace) return true;
+  if (normalizeSpaceForCompare(returnedSpace) === normalizeSpaceForCompare(expectedSpace)) {
+    return true;
+  }
   if (!returnedSpace.startsWith("tinycloud:")) return false;
   const returnedName = returnedSpace.slice(returnedSpace.lastIndexOf(":") + 1);
   return returnedName === expectedSpace;
@@ -11898,7 +11951,7 @@ function portableFromOpenKeyDelegation(data, permissions, host) {
   const primary = permissions.find((permission) => !isRawPermission(permission)) ?? permissions[0];
   const returnedSpace = String(data.spaceId ?? primary.space ?? "encryption");
   const expectedSpaces = new Set(
-    permissions.filter((permission) => !isRawPermission(permission)).map((permission) => permission.space)
+    permissions.filter((permission) => !isRawPermission(permission)).map((permission) => normalizeSpaceForCompare(permission.space))
   );
   const matchesExpectedSpace = expectedSpaces.size === 1 && returnedSpaceMatchesExpected(returnedSpace, Array.from(expectedSpaces)[0]);
   if (expectedSpaces.size > 0 && !matchesExpectedSpace) {
@@ -12144,7 +12197,11 @@ function registerKvCommand(program2) {
       const ctx = await ProfileManager.resolveContext(globalOpts);
       const node = await ensureAuthenticated(ctx);
       const kv2 = await kvHandle(node, options.space, ctx.profile);
-      const result = await withSpinner(`Getting ${key}...`, () => kv2.get(key));
+      const wantBytes = !!options.output || !!options.raw;
+      const result = await withSpinner(
+        `Getting ${key}...`,
+        () => kv2.get(key, wantBytes ? { binary: true } : void 0)
+      );
       if (!result.ok) {
         if (result.error.code === "KV_NOT_FOUND" || result.error.code === "NOT_FOUND") {
           throw new CLIError("NOT_FOUND", `Key "${key}" not found`, ExitCode.NOT_FOUND);
@@ -12154,14 +12211,12 @@ function registerKvCommand(program2) {
       const data = result.data.data;
       const metadata = result.data.headers ?? {};
       if (options.output) {
-        const content = typeof data === "string" ? data : JSON.stringify(data);
-        await writeFile3(options.output, content);
+        await writeFile3(options.output, data);
         outputJson({ key, written: options.output });
         return;
       }
       if (options.raw) {
-        const content = typeof data === "string" ? data : JSON.stringify(data);
-        process.stdout.write(content);
+        process.stdout.write(data);
         return;
       }
       if (shouldOutputJson()) {
@@ -12178,7 +12233,7 @@ function registerKvCommand(program2) {
       handleError(error);
     }
   });
-  kv.command("put <key> [value]").description("Set a value").option("--file <path>", "Read value from file").option("--stdin", "Read value from stdin").action(async (key, value, options, cmd) => {
+  kv.command("put <key> [value]").description("Set a value").option("--file <path>", "Read value from file").option("--stdin", "Read value from stdin").option("--space <name|uri>", "Target a non-primary space (short name or full URI)").action(async (key, value, options, cmd) => {
     try {
       const globalOpts = cmd.optsWithGlobals();
       const ctx = await ProfileManager.resolveContext(globalOpts);
@@ -12202,7 +12257,8 @@ function registerKvCommand(program2) {
           putValue = value;
         }
       }
-      const result = await withSpinner(`Writing ${key}...`, () => node.kv.put(key, putValue));
+      const kv2 = await kvHandle(node, options.space, ctx.profile);
+      const result = await withSpinner(`Writing ${key}...`, () => kv2.put(key, putValue));
       if (!result.ok) {
         throw new CLIError(result.error.code, result.error.message, ExitCode.ERROR);
       }
@@ -12211,12 +12267,13 @@ function registerKvCommand(program2) {
       handleError(error);
     }
   });
-  kv.command("delete <key>").description("Delete a key").action(async (key, _options, cmd) => {
+  kv.command("delete <key>").description("Delete a key").option("--space <name|uri>", "Target a non-primary space (short name or full URI)").action(async (key, options, cmd) => {
     try {
       const globalOpts = cmd.optsWithGlobals();
       const ctx = await ProfileManager.resolveContext(globalOpts);
       const node = await ensureAuthenticated(ctx);
-      const result = await withSpinner(`Deleting ${key}...`, () => node.kv.delete(key));
+      const kv2 = await kvHandle(node, options.space, ctx.profile);
+      const result = await withSpinner(`Deleting ${key}...`, () => kv2.delete(key));
       if (!result.ok) {
         throw new CLIError(result.error.code, result.error.message, ExitCode.ERROR);
       }
@@ -12315,16 +12372,13 @@ function registerSpaceCommand(program2) {
       handleError(error);
     }
   });
-  space.command("create <name>").description("Create a new space").action(async (name, _options, cmd) => {
+  space.command("create <name>").alias("host").description("Create (host) one of your owned spaces by name").action(async (name, _options, cmd) => {
     try {
       const globalOpts = cmd.optsWithGlobals();
       const ctx = await ProfileManager.resolveContext(globalOpts);
       const node = await ensureAuthenticated(ctx);
-      const result = await node.spaces.create(name);
-      if (!result.ok) {
-        throw new CLIError(result.error.code, result.error.message, ExitCode.ERROR);
-      }
-      outputJson({ spaceId: result.data.id, name });
+      const spaceId = await node.hostOwnedSpace(name);
+      outputJson({ spaceId, name, hosted: true });
     } catch (error) {
       handleError(error);
     }
@@ -12776,6 +12830,7 @@ function registerProfileCommand(program2) {
         process.stdout.write(formatField("Posture", posture) + "\n");
         process.stdout.write(formatField("Operator", operatorType) + "\n");
         process.stdout.write(formatField("Space", p.spaceId || null) + "\n");
+        process.stdout.write(formatField("Default Space", p.defaultSpace || null) + "\n");
         process.stdout.write(formatField("Key", hasKey) + "\n");
         process.stdout.write(formatField("Session", hasSession) + "\n");
         process.stdout.write(formatField("Created", p.createdAt) + "\n");
@@ -12796,6 +12851,46 @@ function registerProfileCommand(program2) {
       handleError(error);
     }
   });
+  profile.command("set-default-space [name]").description("Set (or clear) the default space used when --space is omitted").option("--profile <name>", "Profile to modify (defaults to the active profile)").option("--unset", "Clear the default space so commands fall back to the primary space").addHelpText("after", `
+
+The default space is a short space NAME (e.g. "applications"), resolved per
+profile at command time. Precedence for every kv/sql command:
+  explicit --space flag  >  profile defaultSpace  >  primary space.
+
+Examples:
+  $ tc profile set-default-space applications
+  $ tc profile set-default-space applications --profile cli-test
+  $ tc profile set-default-space --unset
+`).action(async (name, options, cmd) => {
+    try {
+      const globalOpts = cmd.optsWithGlobals();
+      const ctx = await ProfileManager.resolveContext({
+        ...globalOpts,
+        profile: options.profile ?? globalOpts.profile
+      });
+      const profileName = ctx.profile;
+      if (!options.unset && (name === void 0 || name === "")) {
+        throw new CLIError(
+          "USAGE_ERROR",
+          "Provide a space name (e.g. `tc profile set-default-space applications`) or pass --unset.",
+          ExitCode.USAGE_ERROR
+        );
+      }
+      if (!options.unset && !/^[A-Za-z0-9_-]+$/.test(name)) {
+        throw new CLIError(
+          "INVALID_SPACE",
+          `Invalid space name "${name}". Use a short name ([A-Za-z0-9_-]).`,
+          ExitCode.USAGE_ERROR
+        );
+      }
+      const p = await ProfileManager.getProfile(profileName);
+      const defaultSpace = options.unset ? void 0 : name;
+      await ProfileManager.setProfile(profileName, { ...p, defaultSpace });
+      outputJson({ profile: profileName, defaultSpace: defaultSpace ?? null, updated: true });
+    } catch (error) {
+      handleError(error);
+    }
+  });
   profile.command("delete <name>").description("Delete a profile").action(async (name, _options, cmd) => {
     try {
       if (isInteractive()) {