@interop/did-cli 0.6.0 → 0.8.0

package/dist/commands/was/tree.js

@@ -0,0 +1,135 @@
+/**
+ * The depth-dispatching `was` shorthands `ls` and `rm`: they inspect the
+ * path (or a `--capability`'s invocation target) and delegate to the right
+ * space/collection/resource run function, mirroring the client's
+ * uniform-verbs-at-every-level design.
+ */
+import { parseWasAddress } from '../../was/address.js';
+import { resolveCapabilityTarget } from '../../was/capability.js';
+import { assertOneAddressing, printCollectionListing, printResourceListing, reportError } from './shared.js';
+import { runCollectionDelete, runCollectionList } from './collection.js';
+import { runResourceDelete, runResourceList } from './resource.js';
+import { runSpaceDelete } from './space.js';
+/**
+ * The `was ls` shorthand: lists the collections of a space or the resources
+ * of a collection, depending on the depth of the path (or of a
+ * `--capability`'s invocation target).
+ *
+ * @param options {object}
+ * @param [options.address] {string}   A space or collection address.
+ * @param [options.capability] {string}   A capability reference instead of
+ *   a path.
+ * @param [options.json] {boolean}   Output the raw listing JSON.
+ * @param [options.plain] {boolean}   Output one id per line.
+ * @param [options.server] {string}   The server base URL.
+ * @param [options.did] {string}   The signing DID or stored-DID handle.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runLs(options) {
+    if (options.capability) {
+        try {
+            assertOneAddressing(options);
+            const resolved = await resolveCapabilityTarget({
+                ref: options.capability,
+                did: options.did
+            });
+            if (resolved.depth === 'resource') {
+                throw new Error('the capability targets a resource; ' +
+                    'ls takes a space or collection capability.');
+            }
+            if (resolved.depth === 'space') {
+                const listing = await resolved.handle.collections();
+                if (listing === null) {
+                    console.error(`Not found (or not visible to you): ${resolved.url}`);
+                    return 1;
+                }
+                printCollectionListing({
+                    listing,
+                    json: options.json,
+                    plain: options.plain
+                });
+            }
+            else {
+                const listing = await resolved.handle.list();
+                if (listing === null) {
+                    console.error(`Not found (or not visible to you): ${resolved.url}`);
+                    return 1;
+                }
+                printResourceListing({
+                    listing,
+                    json: options.json,
+                    plain: options.plain
+                });
+            }
+            return 0;
+        }
+        catch (err) {
+            return reportError({ action: 'list the path', err });
+        }
+    }
+    let parsed;
+    try {
+        assertOneAddressing(options);
+        parsed = parseWasAddress(options.address);
+    }
+    catch (err) {
+        return reportError({ action: 'list the path', err });
+    }
+    if (parsed.resourceId !== undefined) {
+        console.error(`Could not list the path: "${options.address}" is a resource; ` +
+            'ls takes a space or collection address.');
+        return 2;
+    }
+    if (parsed.collectionId !== undefined) {
+        return runResourceList({ ...options, address: options.address });
+    }
+    return runCollectionList({ ...options, address: options.address });
+}
+/**
+ * The `was rm` shorthand: deletes whatever the path (or a `--capability`'s
+ * invocation target) points at -- a space, a collection, or a resource (the
+ * client's uniform `delete()` design).
+ *
+ * @param options {object}
+ * @param [options.address] {string}   A space, collection, or resource
+ *   address.
+ * @param [options.capability] {string}   A capability reference instead of
+ *   a path.
+ * @param [options.server] {string}   The server base URL.
+ * @param [options.did] {string}   The signing DID or stored-DID handle.
+ * @returns {Promise<number>}   The process exit code.
+ */
+export async function runRm(options) {
+    if (options.capability) {
+        try {
+            assertOneAddressing(options);
+            const resolved = await resolveCapabilityTarget({
+                ref: options.capability,
+                did: options.did
+            });
+            await resolved.handle.delete();
+            console.error(`Deleted ${resolved.url} on the server.`);
+            return 0;
+        }
+        catch (err) {
+            return reportError({ action: 'delete the path', err });
+        }
+    }
+    let parsed;
+    try {
+        assertOneAddressing(options);
+        parsed = parseWasAddress(options.address);
+    }
+    catch (err) {
+        return reportError({ action: 'delete the path', err });
+    }
+    const pathOptions = { ...options, address: options.address };
+    if (parsed.resourceId !== undefined) {
+        return runResourceDelete(pathOptions);
+    }
+    if (parsed.collectionId !== undefined) {
+        return runCollectionDelete(pathOptions);
+    }
+    return runSpaceDelete(pathOptions);
+}
+//# sourceMappingURL=tree.js.map

package/dist/commands/was/tree.js.map

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

package/dist/commands/was.d.ts

@@ -1,500 +1,33 @@
-import { Command } from 'commander';
-/**
- * Creates a space on the server and prints `{ id, url, name?, controller }`.
- *
- * @param options {object}
- * @param [options.name] {string}   The space's display name.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @param [options.id] {string}   A caller-chosen space id.
- * @param [options.save] {boolean}   Register the space in the local wallet.
- * @param [options.handle] {string}   Short tag for the registry entry.
- * @param [options.description] {string}   Longer registry entry description.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceCreate(options: {
-    name?: string;
-    server?: string;
-    did?: string;
-    id?: string;
-    save?: boolean;
-    handle?: string;
-    description?: string;
-}): Promise<number>;
 /**
- * Lists the locally registered spaces (the working model while servers do
- * not implement List Spaces); `--remote` asks the server instead.
- *
- * @param options {object}
- * @param [options.json] {boolean}   Output a JSON array with metadata.
- * @param [options.plain] {boolean}   Output one space id per line.
- * @param [options.remote] {boolean}   List spaces on the server instead.
- * @param [options.server] {string}   The server base URL (with `--remote`).
- * @param [options.did] {string}   The signing DID (with `--remote`).
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceList(options: {
-    json?: boolean;
-    plain?: boolean;
-    remote?: boolean;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Shows a space: its Space Description from the server, or (`--meta`) its
- * local registry record and metadata.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.meta] {boolean}   Show the local registry metadata instead.
- * @param [options.json] {boolean}   With `--meta`, output JSON.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceShow(options: {
-    address: string;
-    meta?: boolean;
-    json?: boolean;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Updates a space's description fields on the server (upsert via
- * `configure()`), refreshing the name in the local registry entry when one
- * exists.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.name] {string}   The new display name.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceUpdate(options: {
-    address: string;
-    name?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Deletes a space on the server (idempotent) and removes its local registry
- * entry when one exists. The local-only counterpart is `forget`.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceDelete(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Removes a space's local registry entry only; the server-side space is
- * untouched. The remote counterpart is `delete`.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceForget(options: {
-    address: string;
-}): Promise<number>;
-/**
- * Registers an existing remote space (e.g. created elsewhere or received via
- * delegation) in the local registry, verifying it first with `describe()`.
- *
- * @param options {object}
- * @param options.address {string}   A full space https URL or a bare space id.
- * @param [options.server] {string}   The server base URL (with a bare id).
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @param [options.handle] {string}   Short tag for the registry entry.
- * @param [options.description] {string}   Longer registry entry description.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceAdd(options: {
-    address: string;
-    server?: string;
-    did?: string;
-    handle?: string;
-    description?: string;
-}): Promise<number>;
-/**
- * Creates a collection within a space and prints `{ id, url, name? }`.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.name] {string}   The collection's display name.
- * @param [options.id] {string}   A caller-chosen collection id.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runCollectionCreate(options: {
-    address: string;
-    name?: string;
-    id?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Lists the collections in a space.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.json] {boolean}   Output the raw listing JSON.
- * @param [options.plain] {boolean}   Output one collection id per line.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runCollectionList(options: {
-    address: string;
-    json?: boolean;
-    plain?: boolean;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Shows a collection's description from the server.
- *
- * @param options {object}
- * @param options.address {string}   The collection address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runCollectionShow(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Updates a collection's description fields on the server (upsert via
- * `configure()`).
- *
- * @param options {object}
- * @param options.address {string}   The collection address.
- * @param options.name {string}   The collection's new display name.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runCollectionUpdate(options: {
-    address: string;
-    name: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Deletes a whole collection and its contents on the server. Idempotent.
- *
- * @param options {object}
- * @param options.address {string}   The collection address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runCollectionDelete(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Adds a resource to a collection (server-generated id) and prints the
- * `{ id, url, contentType }` add result. The collection comes from a path
- * or a `--capability` targeting one.
- *
- * @param options {object}
- * @param [options.address] {string}   The collection address.
- * @param [options.capability] {string}   A capability reference instead of
- *   a path.
- * @param [options.file] {string}   The payload file; stdin when omitted.
- * @param [options.contentType] {string}   Explicit payload content type.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runResourceAdd(options: {
-    address?: string;
-    capability?: string;
-    file?: string;
-    contentType?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Creates or replaces a resource at a known id (upsert) and prints
- * `{ id, url }`. The resource comes from a path or a `--capability`
- * targeting one.
- *
- * @param options {object}
- * @param [options.address] {string}   The resource address.
- * @param [options.capability] {string}   A capability reference instead of
- *   a path.
- * @param [options.file] {string}   The payload file; stdin when omitted.
- * @param [options.contentType] {string}   Explicit payload content type.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
+ * `was` command -- Wallet Attached Storage (WAS) operations.
+ *
+ * Talks to WAS servers via `@interop/was-client`, signing every request with
+ * a `did:key` DID stored in the local wallet. Spaces are addressed by a
+ * single positional WAS path -- `SPACE[/COLLECTION[/RESOURCE]]` -- where the
+ * space part is a local registry handle, a bare space id, or a full space
+ * https URL (see `src/was/address.ts`). The local space registry
+ * (`~/.config/did-cli-wallet/was-spaces/`) records each space's server URL and controller
+ * DID so day-to-day commands need no `--server`/`--did` flags.
+ *
+ * Subcommand groups: `space` (`create`, `list`, `show`, `update` alias
+ * `configure`, `delete`, `forget`, `add`, `backends`, `quotas`),
+ * `collection` (alias `coll`;
+ * `create`, `list`, `show`, `update`, `delete`, `backend`, `quota`),
+ * `resource` (alias
+ * `res`; `add`, `put`, `get`, `list`, `delete`), and `resource-meta`
+ * (alias `meta`; `get`, `put`). The top-level shorthand
+ * verbs `ls`, `get`, `put`, and `rm` dispatch on the path depth, mirroring
+ * the client's uniform-verbs-at-every-level design. Resource payloads come
+ * from a file argument or stdin, with JSON-vs-binary detection in
+ * `src/was/io.ts`.
+ *
+ * Data goes to stdout, diagnostics to stderr. Exit codes: 0 success, 1
+ * operation error (typed WAS errors and not-found/not-visible reads), 2
+ * input error (bad path syntax, unknown handle/DID, missing server URL).
+ *
+ * The run functions for each subcommand group live in `src/commands/was/`;
+ * this module wires them onto the commander command tree.
  */
-export declare function runResourcePut(options: {
-    address?: string;
-    capability?: string;
-    file?: string;
-    contentType?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Reads a resource: JSON pretty-printed to stdout, binary written raw
- * (`--output` for files). The resource comes from a path or a
- * `--capability` targeting one.
- *
- * @param options {object}
- * @param [options.address] {string}   The resource address.
- * @param [options.capability] {string}   A capability reference instead of
- *   a path.
- * @param [options.output] {string}   The output file path; stdout when
- *   omitted.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runResourceGet(options: {
-    address?: string;
-    capability?: string;
-    output?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Lists the resources in a collection.
- *
- * @param options {object}
- * @param options.address {string}   The collection address.
- * @param [options.json] {boolean}   Output the raw listing JSON.
- * @param [options.plain] {boolean}   Output one resource id per line.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runResourceList(options: {
-    address: string;
-    json?: boolean;
-    plain?: boolean;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Deletes a resource on the server. Idempotent.
- *
- * @param options {object}
- * @param options.address {string}   The resource address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runResourceDelete(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * The `was ls` shorthand: lists the collections of a space or the resources
- * of a collection, depending on the depth of the path (or of a
- * `--capability`'s invocation target).
- *
- * @param options {object}
- * @param [options.address] {string}   A space or collection address.
- * @param [options.capability] {string}   A capability reference instead of
- *   a path.
- * @param [options.json] {boolean}   Output the raw listing JSON.
- * @param [options.plain] {boolean}   Output one id per line.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runLs(options: {
-    address?: string;
-    capability?: string;
-    json?: boolean;
-    plain?: boolean;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * The `was rm` shorthand: deletes whatever the path (or a `--capability`'s
- * invocation target) points at -- a space, a collection, or a resource (the
- * client's uniform `delete()` design).
- *
- * @param options {object}
- * @param [options.address] {string}   A space, collection, or resource
- *   address.
- * @param [options.capability] {string}   A capability reference instead of
- *   a path.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runRm(options: {
-    address?: string;
-    capability?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Shows the access-control policy of a space, collection, or resource.
- *
- * @param options {object}
- * @param options.address {string}   A space/collection/resource address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runPolicyShow(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Sets (creates or replaces) the access-control policy of a space,
- * collection, or resource, and prints the policy document that was set.
- *
- * @param options {object}
- * @param options.address {string}   A space/collection/resource address.
- * @param [options.file] {string}   A policy JSON file.
- * @param [options.type] {string}   A simple type-only policy (e.g.
- *   PublicCanRead).
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runPolicySet(options: {
-    address: string;
-    file?: string;
-    type?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Removes the access-control policy of a space, collection, or resource,
- * reverting it to capability-only access. Idempotent.
- *
- * @param options {object}
- * @param options.address {string}   A space/collection/resource address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runPolicyClear(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Makes a space, collection, or resource world-readable (the
- * `PublicCanRead` policy) and prints its public URL -- the "share via
- * public link" case.
- *
- * @param options {object}
- * @param options.address {string}   A space/collection/resource address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runPublish(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Reverts a published space, collection, or resource to capability-only
- * access (clears its policy). Idempotent.
- *
- * @param options {object}
- * @param options.address {string}   A space/collection/resource address.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runUnpublish(options: {
-    address: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Exports a whole space as a tar archive, written to `--output` or raw to
- * stdout.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.output] {string}   The output file path; stdout when
- *   omitted.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceExport(options: {
-    address: string;
-    output?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Imports (merges) a tar archive into a space and prints the import stats
- * summary.
- *
- * @param options {object}
- * @param options.address {string}   The space address.
- * @param [options.file] {string}   The tar file; stdin when omitted.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runSpaceImport(options: {
-    address: string;
-    file?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
-/**
- * Delegates access to a space, collection, or resource: signs a capability
- * for the `--to` DID with the given actions and expiration, and prints
- * `{ delegatedCapability, encoded }` (the same shape as `zcap delegate`).
- * `--save` stores the capability in the local zcap store
- * (`~/.config/did-cli-wallet/zcaps/`).
- *
- * @param options {object}
- * @param options.address {string}   The space/collection/resource address.
- * @param options.to {string}   The delegatee DID (or stored-DID handle).
- * @param options.action {string[]}   Allowed actions (HTTP verbs; lowercase
- *   accepted).
- * @param [options.ttl] {string}   Time-to-live for expiration (default 1y).
- * @param [options.expires] {string}   Explicit ISO 8601 expiration
- *   (overrides --ttl).
- * @param [options.save] {boolean}   Save the capability to the zcap store.
- * @param [options.handle] {string}   Short tag for the saved zcap.
- * @param [options.description] {string}   Longer description for the saved
- *   zcap.
- * @param [options.server] {string}   The server base URL.
- * @param [options.did] {string}   The signing DID or stored-DID handle.
- * @returns {Promise<number>}   The process exit code.
- */
-export declare function runGrant(options: {
-    address: string;
-    to: string;
-    action: string[];
-    ttl?: string;
-    expires?: string;
-    save?: boolean;
-    handle?: string;
-    description?: string;
-    server?: string;
-    did?: string;
-}): Promise<number>;
+import { Command } from 'commander';
 export declare function makeWasCommand(): Command;
 //# sourceMappingURL=was.d.ts.map