@interop/did-cli 0.7.1 → 0.8.0

package/dist/commands/was/shared.js

@@ -0,0 +1,237 @@
+/**
+ * Shared helpers for the `was` command group: option factories, address
+ * parsing/assertion, URL building, error reporting, listing renderers, and
+ * the run-and-exit wrapper. Commander `Option` instances are bound to the
+ * command they are added to, so the options are exposed as factories.
+ */
+import { Option } from 'commander';
+import { WasError } from '@interop/was-client';
+import { parseWasAddress } from '../../was/address.js';
+import { renderTable } from '../../table.js';
+/**
+ * Awaits a command's run function and exits the process with its code when
+ * non-zero -- the shared tail of every `was` command action.
+ *
+ * @param run {Promise<number>}
+ * @returns {Promise<void>}
+ */
+export async function runAndExit(run) {
+    const code = await run;
+    if (code !== 0) {
+        process.exit(code);
+    }
+}
+/**
+ * The shared command options, as factories (commander `Option` instances
+ * are bound to the command they are added to, so they cannot be shared).
+ * Centralizing them keeps the flag names and help text consistent across
+ * the whole command tree.
+ *
+ * @returns {Option}
+ */
+export function serverOption() {
+    return new Option('--server <url>', 'the WAS server base URL (or WAS_SERVER_URL)');
+}
+export function didOption() {
+    return new Option('--did <did>', 'DID or stored-DID handle to sign with (or WAS_DID)');
+}
+export function capabilityOption() {
+    return new Option('--capability <ref>', 'a received capability (encoded string, JSON file, or stored zcap ' +
+        'id/handle) instead of a path');
+}
+export function contentTypeOption() {
+    return new Option('--content-type <type>', 'send the payload as-is with this content type (skips JSON detection)');
+}
+/**
+ * Guards a run function against receiving both path- and capability-based
+ * addressing (or neither).
+ *
+ * @param options {object}
+ * @param [options.address] {string}
+ * @param [options.capability] {string}
+ * @returns {void}
+ */
+export function assertOneAddressing({ address, capability }) {
+    if (address && capability) {
+        throw new Error('Provide either a path or --capability, not both.');
+    }
+    if (!address && !capability) {
+        throw new Error('Provide a path or --capability.');
+    }
+}
+/**
+ * Builds the canonical URL of a space, collection, or resource on its
+ * server, for messages and output.
+ *
+ * @param options {object}
+ * @param options.server {string}
+ * @param options.spaceId {string}
+ * @param [options.collectionId] {string}
+ * @param [options.resourceId] {string}
+ * @returns {string}
+ */
+export function wasUrl({ server, spaceId, collectionId, resourceId }) {
+    const segments = [spaceId, collectionId, resourceId]
+        .filter((segment) => segment !== undefined)
+        .map(encodeURIComponent);
+    return `${server.replace(/\/$/, '')}/space/${segments.join('/')}`;
+}
+/**
+ * Prints a one-line error for a failed command and classifies its exit code:
+ * 1 for operation errors (typed WAS errors from the server exchange), 2 for
+ * input errors (bad addresses, unknown handles/DIDs, missing server URL).
+ *
+ * @param options {object}
+ * @param options.action {string}   What failed, e.g. `create the space`.
+ * @param options.err {unknown}
+ * @returns {number}   The process exit code.
+ */
+export function reportError({ action, err }) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Could not ${action}: ${message}`);
+    return err instanceof WasError ? 1 : 2;
+}
+/**
+ * Parses a WAS address and asserts it addresses a space only (no
+ * collection/resource segments), as the `space` subcommands require.
+ *
+ * @param address {string}
+ * @returns {{server?: string, spaceRef: string}}
+ */
+export function parseSpaceAddress(address) {
+    const parsed = parseWasAddress(address);
+    if (parsed.collectionId !== undefined) {
+        throw new Error(`"${address}" addresses a collection or resource; ` +
+            'space commands take a space address.');
+    }
+    return parsed;
+}
+/**
+ * Asserts a resolved target addresses a collection (`SPACE/COLLECTION`,
+ * no resource segment) and narrows its type accordingly.
+ *
+ * @param options {object}
+ * @param options.target {ResolvedWasTarget}
+ * @param options.address {string}   The original address, for error messages.
+ * @returns {ResolvedWasTarget & {collectionId: string}}
+ */
+export function requireCollectionTarget({ target, address }) {
+    if (target.collectionId === undefined || target.resourceId !== undefined) {
+        throw new Error(`"${address}" must address a collection (SPACE/COLLECTION).`);
+    }
+    return target;
+}
+/**
+ * Asserts a resolved target addresses a resource
+ * (`SPACE/COLLECTION/RESOURCE`) and narrows its type accordingly.
+ *
+ * @param options {object}
+ * @param options.target {ResolvedWasTarget}
+ * @param options.address {string}   The original address, for error messages.
+ * @returns {ResolvedWasTarget & {collectionId: string, resourceId: string}}
+ */
+export function requireResourceTarget({ target, address }) {
+    if (target.collectionId === undefined || target.resourceId === undefined) {
+        throw new Error(`"${address}" must address a resource (SPACE/COLLECTION/RESOURCE).`);
+    }
+    return target;
+}
+/**
+ * Renders a listing as a table, raw JSON, or one item id per line -- the
+ * shared output logic of `collection list`, `resource list`, and `ls`.
+ *
+ * @param options {object}
+ * @param options.listing {{items: T[]}}
+ * @param [options.json] {boolean}
+ * @param [options.plain] {boolean}
+ * @param options.columns {Column[]}
+ * @param options.toRow {(item: T) => string[]}
+ * @returns {void}
+ */
+function printListing({ listing, json, plain, columns, toRow }) {
+    if (json) {
+        console.log(JSON.stringify(listing, null, 2));
+        return;
+    }
+    if (plain) {
+        const ids = listing.items.map(item => item.id).sort();
+        for (const id of ids) {
+            console.log(id);
+        }
+        return;
+    }
+    if (listing.items.length === 0) {
+        return;
+    }
+    console.log(renderTable({ columns, rows: listing.items.map(toRow) }));
+}
+/**
+ * Renders a collection listing as a table, raw JSON, or one id per line.
+ *
+ * @param options {object}
+ * @param options.listing {CollectionsList}
+ * @param [options.json] {boolean}
+ * @param [options.plain] {boolean}
+ * @returns {void}
+ */
+export function printCollectionListing({ listing, json, plain }) {
+    printListing({
+        listing,
+        json,
+        plain,
+        columns: [
+            { header: 'ID', maxWidth: 30 },
+            { header: 'NAME', maxWidth: 20 },
+            { header: 'URL' }
+        ],
+        toRow: item => [item.id, item.name, item.url]
+    });
+}
+/**
+ * Renders a resource listing as a table, raw JSON, or one id per line.
+ *
+ * @param options {object}
+ * @param options.listing {CollectionResourcesList}
+ * @param [options.json] {boolean}
+ * @param [options.plain] {boolean}
+ * @returns {void}
+ */
+export function printResourceListing({ listing, json, plain }) {
+    printListing({
+        listing,
+        json,
+        plain,
+        columns: [
+            { header: 'ID', maxWidth: 30 },
+            { header: 'CONTENT TYPE', maxWidth: 24 },
+            { header: 'URL' }
+        ],
+        toRow: item => [item.id, item.contentType, item.url]
+    });
+}
+/**
+ * Builds the access handle (space, collection, or resource) a resolved
+ * target addresses, together with its URL. Policies and publishing work at
+ * every depth, so these commands dispatch through this helper.
+ *
+ * @param target {ResolvedWasTarget}
+ * @returns {{handle: Space | Collection | Resource, url: string}}
+ */
+export function handleForTarget(target) {
+    const url = wasUrl({
+        server: target.server,
+        spaceId: target.spaceId,
+        collectionId: target.collectionId,
+        resourceId: target.resourceId
+    });
+    const space = target.client.space(target.spaceId);
+    if (target.collectionId === undefined) {
+        return { handle: space, url };
+    }
+    const collection = space.collection(target.collectionId);
+    if (target.resourceId === undefined) {
+        return { handle: collection, url };
+    }
+    return { handle: collection.resource(target.resourceId), url };
+}
+//# sourceMappingURL=shared.js.map

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

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

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

@@ -0,0 +1,196 @@
+/**
+ * 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>;
+/**
+ * Lists the storage backends available within a space. The reference server
+ * ships a single server-configured backend (registered as `default`); a
+ * server without backend support returns `null` (a 501), reported as an
+ * error.
+ *
+ * @param options {object}
+ * @param options.address {string}   The space address.
+ * @param [options.json] {boolean}   Output the raw backends 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 runSpaceBackends(options: {
+    address: string;
+    json?: boolean;
+    server?: string;
+    did?: string;
+}): Promise<number>;
+/**
+ * Shows a space's storage quota report, grouped by backend (one row per
+ * backend: state, usage, limit, and any restricted actions). A server
+ * without quota support returns `null` (a 501), reported as an error.
+ *
+ * @param options {object}
+ * @param options.address {string}   The space address.
+ * @param [options.json] {boolean}   Output the raw quota report 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 runSpaceQuotas(options: {
+    address: string;
+    json?: boolean;
+    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>;
+//# sourceMappingURL=space.d.ts.map

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

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