@tinycloud/sdk-core 2.2.0-beta.0 → 2.2.0-beta.1

package/dist/index.d.cts

@@ -226,6 +226,8 @@ interface PermissionEntry {
     skipPrefix?: boolean;
     /** Per-entry expiry override, ms-format. */
     expiry?: string;
+    /** User/agent-facing context for why this permission is requested. */
+    description?: string;
 }
 /**
  * The valid values for `Manifest.defaults`.
@@ -296,6 +298,8 @@ interface ResourceCapability {
     actions: string[];
     /** Per-entry expiry override in milliseconds. */
     expiryMs?: number;
+    /** User/agent-facing context copied from the source permission entry. */
+    description?: string;
 }
 /**
  * A resolved delegation entry with fully-expanded permissions.
@@ -2131,8 +2135,8 @@ declare const ShareLinkSchema: z.ZodObject<{
     };
     token: string;
     schema: "base64" | "compact" | "ipfs";
-    expiresAt?: Date | undefined;
     description?: string | undefined;
+    expiresAt?: Date | undefined;
 }, {
     url: string;
     delegation: {
@@ -2151,8 +2155,8 @@ declare const ShareLinkSchema: z.ZodObject<{
     };
     token: string;
     schema: "base64" | "compact" | "ipfs";
-    expiresAt?: Date | undefined;
     description?: string | undefined;
+    expiresAt?: Date | undefined;
 }>;
 type ShareLink = z.infer<typeof ShareLinkSchema>;
 type ShareLinkData<T = unknown> = {
@@ -2209,15 +2213,15 @@ declare const GenerateShareParamsSchema: z.ZodObject<{
     path: string;
     actions?: string[] | undefined;
     expiry?: Date | undefined;
-    schema?: "base64" | "compact" | "ipfs" | undefined;
     description?: string | undefined;
+    schema?: "base64" | "compact" | "ipfs" | undefined;
     baseUrl?: string | undefined;
 }, {
     path: string;
     actions?: string[] | undefined;
     expiry?: Date | undefined;
-    schema?: "base64" | "compact" | "ipfs" | undefined;
     description?: string | undefined;
+    schema?: "base64" | "compact" | "ipfs" | undefined;
     baseUrl?: string | undefined;
 }>;
 type GenerateShareParams = z.infer<typeof GenerateShareParamsSchema>;

package/dist/index.d.ts

@@ -226,6 +226,8 @@ interface PermissionEntry {
     skipPrefix?: boolean;
     /** Per-entry expiry override, ms-format. */
     expiry?: string;
+    /** User/agent-facing context for why this permission is requested. */
+    description?: string;
 }
 /**
  * The valid values for `Manifest.defaults`.
@@ -296,6 +298,8 @@ interface ResourceCapability {
     actions: string[];
     /** Per-entry expiry override in milliseconds. */
     expiryMs?: number;
+    /** User/agent-facing context copied from the source permission entry. */
+    description?: string;
 }
 /**
  * A resolved delegation entry with fully-expanded permissions.
@@ -2131,8 +2135,8 @@ declare const ShareLinkSchema: z.ZodObject<{
     };
     token: string;
     schema: "base64" | "compact" | "ipfs";
-    expiresAt?: Date | undefined;
     description?: string | undefined;
+    expiresAt?: Date | undefined;
 }, {
     url: string;
     delegation: {
@@ -2151,8 +2155,8 @@ declare const ShareLinkSchema: z.ZodObject<{
     };
     token: string;
     schema: "base64" | "compact" | "ipfs";
-    expiresAt?: Date | undefined;
     description?: string | undefined;
+    expiresAt?: Date | undefined;
 }>;
 type ShareLink = z.infer<typeof ShareLinkSchema>;
 type ShareLinkData<T = unknown> = {
@@ -2209,15 +2213,15 @@ declare const GenerateShareParamsSchema: z.ZodObject<{
     path: string;
     actions?: string[] | undefined;
     expiry?: Date | undefined;
-    schema?: "base64" | "compact" | "ipfs" | undefined;
     description?: string | undefined;
+    schema?: "base64" | "compact" | "ipfs" | undefined;
     baseUrl?: string | undefined;
 }, {
     path: string;
     actions?: string[] | undefined;
     expiry?: Date | undefined;
-    schema?: "base64" | "compact" | "ipfs" | undefined;
     description?: string | undefined;
+    schema?: "base64" | "compact" | "ipfs" | undefined;
     baseUrl?: string | undefined;
 }>;
 type GenerateShareParams = z.infer<typeof GenerateShareParamsSchema>;

package/dist/index.js

@@ -2754,9 +2754,7 @@ function parseExpiry(duration) {
       `expiry must be a non-empty duration string (got ${JSON.stringify(duration)})`
     );
   }
-  const parsed = ms(
-    duration
-  );
+  const parsed = ms(duration);
   if (typeof parsed !== "number" || !Number.isFinite(parsed) || parsed <= 0) {
     throw new ManifestValidationError(
       `invalid expiry duration: ${JSON.stringify(duration)}`
@@ -2811,23 +2809,33 @@ function validateManifest(input) {
     );
   }
   if (typeof m.app_id !== "string" || m.app_id.length === 0) {
-    throw new ManifestValidationError("manifest.app_id is required and must be a non-empty string");
+    throw new ManifestValidationError(
+      "manifest.app_id is required and must be a non-empty string"
+    );
   }
   if (typeof m.name !== "string" || m.name.length === 0) {
-    throw new ManifestValidationError("manifest.name is required and must be a non-empty string");
+    throw new ManifestValidationError(
+      "manifest.name is required and must be a non-empty string"
+    );
   }
   if (m.did !== void 0 && (typeof m.did !== "string" || m.did.length === 0)) {
-    throw new ManifestValidationError("manifest.did must be a non-empty DID string");
+    throw new ManifestValidationError(
+      "manifest.did must be a non-empty DID string"
+    );
   }
   if (m.space !== void 0 && (typeof m.space !== "string" || m.space.length === 0)) {
-    throw new ManifestValidationError("manifest.space must be a non-empty string");
+    throw new ManifestValidationError(
+      "manifest.space must be a non-empty string"
+    );
   }
   if (m.expiry !== void 0) {
     parseExpiry(m.expiry);
   }
   if (m.permissions !== void 0) {
     if (!Array.isArray(m.permissions)) {
-      throw new ManifestValidationError("manifest.permissions must be an array");
+      throw new ManifestValidationError(
+        "manifest.permissions must be an array"
+      );
     }
     m.permissions.forEach(
       (p, i) => validatePermissionEntry(p, `permissions[${i}]`)
@@ -2844,7 +2852,9 @@ function validatePermissionEntry(p, path) {
     throw new ManifestValidationError(`${path}.service is required`);
   }
   if (entry.space !== void 0 && (typeof entry.space !== "string" || entry.space.length === 0)) {
-    throw new ManifestValidationError(`${path}.space must be a non-empty string`);
+    throw new ManifestValidationError(
+      `${path}.space must be a non-empty string`
+    );
   }
   if (typeof entry.path !== "string") {
     throw new ManifestValidationError(
@@ -2935,7 +2945,8 @@ function resolveEntry(entry, prefix, _inheritedExpiryMs, inheritedSpace) {
     // Only populate `expiryMs` when the entry had its own expiry override.
     // When absent, callers use the parent (delegation or manifest) expiry
     // which is carried on ResolvedDelegate.expiryMs / ResolvedCapabilities.expiryMs.
-    ...entryExpiryMs !== void 0 ? { expiryMs: entryExpiryMs } : {}
+    ...entryExpiryMs !== void 0 ? { expiryMs: entryExpiryMs } : {},
+    ...entry.description !== void 0 ? { description: entry.description } : {}
   };
 }
 function cloneResourceCapability(entry) {
@@ -2944,7 +2955,8 @@ function cloneResourceCapability(entry) {
     space: entry.space,
     path: entry.path,
     actions: [...entry.actions],
-    ...entry.expiryMs !== void 0 ? { expiryMs: entry.expiryMs } : {}
+    ...entry.expiryMs !== void 0 ? { expiryMs: entry.expiryMs } : {},
+    ...entry.description !== void 0 ? { description: entry.description } : {}
   };
 }
 function clonePermissionEntry(entry) {
@@ -2954,7 +2966,8 @@ function clonePermissionEntry(entry) {
     path: entry.path,
     actions: [...entry.actions],
     ...entry.skipPrefix !== void 0 ? { skipPrefix: entry.skipPrefix } : {},
-    ...entry.expiry !== void 0 ? { expiry: entry.expiry } : {}
+    ...entry.expiry !== void 0 ? { expiry: entry.expiry } : {},
+    ...entry.description !== void 0 ? { description: entry.description } : {}
   };
 }
 function dedupeResources(resources) {
@@ -2973,6 +2986,9 @@ function dedupeResources(resources) {
         seen.add(action);
       }
     }
+    if (existing.description === void 0 && resource.description !== void 0) {
+      existing.description = resource.description;
+    }
   }
   return [...byKey.values()];
 }
@@ -2981,11 +2997,7 @@ function accountRegistryPermission() {
     service: "tinycloud.kv",
     space: ACCOUNT_REGISTRY_SPACE,
     path: ACCOUNT_REGISTRY_PATH,
-    actions: [
-      "tinycloud.kv/get",
-      "tinycloud.kv/put",
-      "tinycloud.kv/list"
-    ]
+    actions: ["tinycloud.kv/get", "tinycloud.kv/put", "tinycloud.kv/list"]
   };
 }
 function composeManifestRequest(inputs, options = {}) {