@interop/did-cli 0.7.1 → 0.9.0

package/dist/commands/was/collection.js

@@ -0,0 +1,316 @@
+/**
+ * `was collection` run functions: create, list, show, update, delete, and the
+ * read-only `backend` (the storage backend the collection is stored on) and
+ * `quota` (the collection's storage usage, scoped to that backend) for a
+ * collection within a space.
+ */
+import { resolveWasTarget } from '../../was/client.js';
+import { renderTable } from '../../table.js';
+import { parseSpaceAddress, printCollectionListing, reportError, requireCollectionTarget, wasUrl } from './shared.js';
+/**
+ * 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 async function runCollectionCreate(options) {
+    try {
+        parseSpaceAddress(options.address);
+        const target = await resolveWasTarget({
+            address: options.address,
+            server: options.server,
+            did: options.did
+        });
+        const collection = await target.client
+            .space(target.spaceId)
+            .createCollection({
+            ...(options.name !== undefined && { name: options.name }),
+            ...(options.id !== undefined && { id: options.id })
+        });
+        const url = wasUrl({
+            server: target.server,
+            spaceId: target.spaceId,
+            collectionId: collection.id
+        });
+        console.log(JSON.stringify({
+            id: collection.id,
+            url,
+            ...(options.name !== undefined && { name: options.name })
+        }, null, 2));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'create the collection', err });
+    }
+}
+/**
+ * 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 async function runCollectionList(options) {
+    try {
+        parseSpaceAddress(options.address);
+        const target = await resolveWasTarget({
+            address: options.address,
+            server: options.server,
+            did: options.did
+        });
+        const listing = await target.client.space(target.spaceId).collections();
+        if (listing === null) {
+            console.error('Not found (or not visible to you): ' +
+                wasUrl({ server: target.server, spaceId: target.spaceId }));
+            return 1;
+        }
+        printCollectionListing({
+            listing,
+            json: options.json,
+            plain: options.plain
+        });
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'list collections', err });
+    }
+}
+/**
+ * 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 async function runCollectionShow(options) {
+    try {
+        const target = requireCollectionTarget({
+            target: await resolveWasTarget({
+                address: options.address,
+                server: options.server,
+                did: options.did
+            }),
+            address: options.address
+        });
+        const description = await target.client
+            .space(target.spaceId)
+            .collection(target.collectionId)
+            .describe();
+        if (description === null) {
+            console.error('Not found (or not visible to you): ' +
+                wasUrl({
+                    server: target.server,
+                    spaceId: target.spaceId,
+                    collectionId: target.collectionId
+                }));
+            return 1;
+        }
+        console.log(JSON.stringify(description, null, 2));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'show the collection', err });
+    }
+}
+/**
+ * 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 async function runCollectionUpdate(options) {
+    try {
+        const target = requireCollectionTarget({
+            target: await resolveWasTarget({
+                address: options.address,
+                server: options.server,
+                did: options.did
+            }),
+            address: options.address
+        });
+        const description = await target.client
+            .space(target.spaceId)
+            .collection(target.collectionId)
+            .configure({ name: options.name });
+        console.log(JSON.stringify(description, null, 2));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'update the collection', err });
+    }
+}
+/**
+ * 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 async function runCollectionDelete(options) {
+    try {
+        const target = requireCollectionTarget({
+            target: await resolveWasTarget({
+                address: options.address,
+                server: options.server,
+                did: options.did
+            }),
+            address: options.address
+        });
+        await target.client
+            .space(target.spaceId)
+            .collection(target.collectionId)
+            .delete();
+        console.error('Deleted ' +
+            wasUrl({
+                server: target.server,
+                spaceId: target.spaceId,
+                collectionId: target.collectionId
+            }) +
+            ' on the server.');
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'delete the collection', err });
+    }
+}
+/**
+ * Shows the storage backend a collection is stored on (its "Collection Backend
+ * Selected" descriptor). A missing/not-visible collection returns `null` (a
+ * 404), reported as not-found; a server without backend support surfaces its
+ * 501 as a typed error.
+ *
+ * @param options {object}
+ * @param options.address {string}   The collection address.
+ * @param [options.json] {boolean}   Output the raw backend 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 async function runCollectionBackend(options) {
+    try {
+        const target = requireCollectionTarget({
+            target: await resolveWasTarget({
+                address: options.address,
+                server: options.server,
+                did: options.did
+            }),
+            address: options.address
+        });
+        const backend = await target.client
+            .space(target.spaceId)
+            .collection(target.collectionId)
+            .backend();
+        if (backend === null) {
+            console.error('Not found (or not visible to you): ' +
+                wasUrl({
+                    server: target.server,
+                    spaceId: target.spaceId,
+                    collectionId: target.collectionId
+                }));
+            return 1;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(backend, null, 2));
+            return 0;
+        }
+        const rows = [
+            ['ID', backend.id],
+            ['Name', backend.name ?? ''],
+            ['Managed By', backend.managedBy ?? ''],
+            ['Storage Mode', backend.storageMode?.join(', ') ?? ''],
+            ['Persistence', backend.persistence ?? '']
+        ];
+        console.log(renderTable({
+            columns: [{ header: 'FIELD' }, { header: 'VALUE' }],
+            rows
+        }));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'show the collection backend', err });
+    }
+}
+/**
+ * Shows a collection's storage usage report, scoped to its backend (one
+ * `BackendUsage` entry: state, usage, limit, and any restricted actions). A
+ * missing/not-visible collection returns `null` (a 404), reported as
+ * not-found; a backend that cannot account per-collection surfaces its 501 as
+ * a typed error.
+ *
+ * @param options {object}
+ * @param options.address {string}   The collection address.
+ * @param [options.json] {boolean}   Output the raw usage 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 async function runCollectionQuota(options) {
+    try {
+        const target = requireCollectionTarget({
+            target: await resolveWasTarget({
+                address: options.address,
+                server: options.server,
+                did: options.did
+            }),
+            address: options.address
+        });
+        const usage = await target.client
+            .space(target.spaceId)
+            .collection(target.collectionId)
+            .quota();
+        if (usage === null) {
+            console.error('Not found (or not visible to you): ' +
+                wasUrl({
+                    server: target.server,
+                    spaceId: target.spaceId,
+                    collectionId: target.collectionId
+                }));
+            return 1;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(usage, null, 2));
+            return 0;
+        }
+        const rows = [
+            ['Backend', usage.name ? `${usage.id} (${usage.name})` : usage.id],
+            ['Managed By', usage.managedBy],
+            ['State', usage.state],
+            ['Usage (B)', String(usage.usageBytes)],
+            [
+                'Limit (B)',
+                usage.limit.isUnlimited
+                    ? 'unlimited'
+                    : String(usage.limit.capacityBytes ?? '')
+            ],
+            ['Restricted', usage.restrictedActions.join(', ')],
+            ['Measured At', usage.measuredAt]
+        ];
+        console.log(renderTable({
+            columns: [{ header: 'FIELD' }, { header: 'VALUE' }],
+            rows
+        }));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'get the collection quota', err });
+    }
+}
+//# sourceMappingURL=collection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../../src/commands/was/collection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,uBAAuB,EACvB,MAAM,EACP,MAAM,aAAa,CAAA;AAEpB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAMzC;IACC,IAAI,CAAC;QACH,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAA;QACF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM;aACnC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACrB,gBAAgB,CAAC;YAChB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACzD,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;SACpD,CAAC,CAAA;QACJ,MAAM,GAAG,GAAG,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,UAAU,CAAC,EAAE;SAC5B,CAAC,CAAA;QACF,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,GAAG;YACH,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;SAC1D,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAMvC;IACC,IAAI,CAAC;QACH,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAA;QACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAA;QACvE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CACX,qCAAqC;gBACnC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAC7D,CAAA;YACD,OAAO,CAAC,CAAA;QACV,CAAC;QACD,sBAAsB,CAAC;YACrB,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAA;QACF,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAA;IACzD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAIvC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACrC,MAAM,EAAE,MAAM,gBAAgB,CAAC;gBAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC;YACF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,MAAM;aACpC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACrB,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;aAC/B,QAAQ,EAAE,CAAA;QACb,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CACX,qCAAqC;gBACnC,MAAM,CAAC;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC,CACL,CAAA;YACD,OAAO,CAAC,CAAA;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACjD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAKzC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACrC,MAAM,EAAE,MAAM,gBAAgB,CAAC;gBAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC;YACF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,MAAM;aACpC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACrB,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;aAC/B,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACjD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAIzC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACrC,MAAM,EAAE,MAAM,gBAAgB,CAAC;gBAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC;YACF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,MAAM,MAAM,CAAC,MAAM;aAChB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACrB,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;aAC/B,MAAM,EAAE,CAAA;QACX,OAAO,CAAC,KAAK,CACX,UAAU;YACR,MAAM,CAAC;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC;YACF,iBAAiB,CACpB,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAK1C;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACrC,MAAM,EAAE,MAAM,gBAAgB,CAAC;gBAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC;YACF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM;aAChC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACrB,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;aAC/B,OAAO,EAAE,CAAA;QACZ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CACX,qCAAqC;gBACnC,MAAM,CAAC;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC,CACL,CAAA;YACD,OAAO,CAAC,CAAA;QACV,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;YAC7C,OAAO,CAAC,CAAA;QACV,CAAC;QACD,MAAM,IAAI,GAAG;YACX,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YAClB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YAC5B,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;YACvC,CAAC,cAAc,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACvD,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;SAC3C,CAAA;QACD,OAAO,CAAC,GAAG,CACT,WAAW,CAAC;YACV,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YACnD,IAAI;SACL,CAAC,CACH,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,6BAA6B,EAAE,GAAG,EAAE,CAAC,CAAA;IACpE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAKxC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACrC,MAAM,EAAE,MAAM,gBAAgB,CAAC;gBAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC;YACF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QACF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM;aAC9B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACrB,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;aAC/B,KAAK,EAAE,CAAA;QACV,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CACX,qCAAqC;gBACnC,MAAM,CAAC;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC,CACL,CAAA;YACD,OAAO,CAAC,CAAA;QACV,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;YAC3C,OAAO,CAAC,CAAA;QACV,CAAC;QACD,MAAM,IAAI,GAAG;YACX,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAClE,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;YAC/B,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;YACtB,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACvC;gBACE,WAAW;gBACX,KAAK,CAAC,KAAK,CAAC,WAAW;oBACrB,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;aAC5C;YACD,CAAC,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC;SAClC,CAAA;QACD,OAAO,CAAC,GAAG,CACT,WAAW,CAAC;YACV,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YACnD,IAAI;SACL,CAAC,CACH,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,GAAG,EAAE,CAAC,CAAA;IACjE,CAAC;AACH,CAAC"}

package/dist/commands/was/policy.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/commands/was/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/commands/was/policy.ts"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlB;AAiDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB"}

package/dist/commands/was/policy.js

@@ -0,0 +1,133 @@
+/**
+ * `was policy` run functions: show, set (from `--type` or a JSON file), and
+ * clear the access-control policy of a space, collection, or resource.
+ */
+import { readFile } from 'node:fs/promises';
+import { resolveWasTarget } from '../../was/client.js';
+import { handleForTarget, reportError } from './shared.js';
+/**
+ * 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 async function runPolicyShow(options) {
+    try {
+        const target = await resolveWasTarget({
+            address: options.address,
+            server: options.server,
+            did: options.did
+        });
+        const { handle, url } = handleForTarget(target);
+        const policy = await handle.getPolicy();
+        if (policy === null) {
+            console.error(`No policy set (or not visible to you): ${url}`);
+            return 1;
+        }
+        console.log(JSON.stringify(policy, null, 2));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'show the policy', err });
+    }
+}
+/**
+ * Parses the `policy set` arguments -- `--type <type>` for a simple
+ * type-only policy, or a JSON file for richer ones -- into a policy
+ * document.
+ *
+ * @param options {object}
+ * @param [options.type] {string}
+ * @param [options.file] {string}
+ * @returns {Promise<PolicyDocument>}
+ */
+async function resolvePolicyInput({ type, file }) {
+    if (type && file) {
+        throw new Error('Provide either --type or a policy file, not both.');
+    }
+    if (type) {
+        return { type };
+    }
+    if (!file) {
+        throw new Error('Provide --type <type> or a policy JSON file.');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch (err) {
+        throw new Error(`${file} does not contain policy JSON: ` +
+            `${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    if (parsed === null ||
+        typeof parsed !== 'object' ||
+        Array.isArray(parsed) ||
+        typeof parsed.type !== 'string') {
+        throw new Error(`${file} must hold a policy object with a "type" field.`);
+    }
+    return parsed;
+}
+/**
+ * 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 async function runPolicySet(options) {
+    try {
+        const policy = await resolvePolicyInput({
+            type: options.type,
+            file: options.file
+        });
+        const target = await resolveWasTarget({
+            address: options.address,
+            server: options.server,
+            did: options.did
+        });
+        const { handle, url } = handleForTarget(target);
+        await handle.setPolicy(policy);
+        console.error(`Policy set on ${url}`);
+        console.log(JSON.stringify(policy, null, 2));
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'set the policy', err });
+    }
+}
+/**
+ * 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 async function runPolicyClear(options) {
+    try {
+        const target = await resolveWasTarget({
+            address: options.address,
+            server: options.server,
+            did: options.did
+        });
+        const { handle, url } = handleForTarget(target);
+        await handle.clearPolicy();
+        console.error(`Cleared the policy on ${url} (capability-only access).`);
+        return 0;
+    }
+    catch (err) {
+        return reportError({ action: 'clear the policy', err });
+    }
+}
+//# sourceMappingURL=policy.js.map

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

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

package/dist/commands/was/publish.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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>;
+/**
+ * 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>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/commands/was/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/commands/was/publish.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAclB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ClB"}