@veilio-inc/cli 0.5.4 → 0.6.1

package/dist/client/maps.d.ts

@@ -0,0 +1,115 @@
+import { type Env } from './project-scope.js';
+import { type Outcome } from './wording.js';
+export interface ClientContext {
+    /** Home directory the credential and unlocked keys live under. */
+    home?: string;
+    /**
+     * Ask for the vault passphrase. The CLI passes its hidden prompt; the MCP
+     * server passes nothing, and a passphrase is then never asked for - it
+     * opens personal maps with the personal-maps key or not at all (FR-011).
+     */
+    passphrase?: () => Promise<string>;
+    /**
+     * Where `VEILIO_PROJECT` is read from (FR-012a). Undefined: this process's
+     * environment. The MCP server passes its own; tests pass theirs.
+     */
+    env?: Env;
+}
+export interface ListedMap {
+    id: string;
+    name: string;
+    scope: 'personal' | 'team';
+    count: number | null;
+    /** Whether this account published it. A team map that is not is a
+     *  teammate's: readable, not ours to update or remove. */
+    mine: boolean;
+    updatedAt: string;
+}
+export declare function listCloudMaps(ctx: ClientContext): Promise<Outcome<{
+    maps: ListedMap[];
+    teamId: string | null;
+    project: string | null;
+    /** VEILIO_PROJECT chose `project`: `projects use` does not change it here. */
+    projectFromEnv: boolean;
+}>>;
+export declare function pullCloudMap(ctx: ClientContext, id: string | null, opts: {
+    mapPath: string;
+    force?: boolean;
+}): Promise<Outcome<{
+    id: string;
+    name: string;
+    count: number;
+    path: string;
+}>>;
+/**
+ * Placeholders the local map and the team's namespace use for DIFFERENT names.
+ *
+ * Publishing one creates a DISPUTED placeholder, which then restores for no
+ * member of the team until somebody deletes a map. One person's push, a cost
+ * paid by everyone, and nothing errors at the time - so it is checked before
+ * anything is sealed. An identifier the team holds under a DIFFERENT
+ * placeholder is an alias, not a conflict: both still restore (spec 017).
+ */
+export declare function conflictsWithTeam(local: Record<string, string>, teamNamespace: Record<string, string>): {
+    placeholder: string;
+    mine: string;
+    theirs: string;
+}[];
+export interface Created {
+    id: string;
+    name: string;
+    scope: 'personal' | 'team';
+    count: number;
+    /** Team only: identifiers in the team's shared set after this one. */
+    teamTotal?: number;
+    /** Team only: placeholders the team's maps disagree on. */
+    disputed?: number;
+    /** Things worth saying that are not refusals. */
+    notes: string[];
+}
+/** Seal the local map and upload it as a new map, personal or the team's. */
+export declare function createCloudMap(ctx: ClientContext, opts: {
+    name: string | null;
+    scope: 'personal' | 'team';
+    mapPath: string;
+}): Promise<Outcome<Created>>;
+export interface Updated {
+    id: string;
+    name: string;
+    scope: 'personal' | 'team';
+    count: number;
+    /** Entries the Cloud map held that it no longer does - only with allowDrop. */
+    dropped: number;
+    updatedAt: string;
+    notes: string[];
+}
+/**
+ * Replace a Cloud map's entries with the local map's, in place: same id, name
+ * and project (spec 052 US1).
+ *
+ * The server cannot read names, so the two checks that need them are made
+ * here, before anything is sealed: the entries the update would drop (FR-005),
+ * and - for a team map - clashes with the project's OTHER team maps (FR-003).
+ * The server decides the rest: owner or publisher, the rotation lock, and the
+ * version this read (`if_updated_at`), so a teammate's write in between is
+ * reported rather than overwritten.
+ */
+export declare function updateCloudMap(ctx: ClientContext, id: string | null, opts: {
+    mapPath: string;
+    allowDrop?: boolean;
+}): Promise<Outcome<Updated>>;
+/**
+ * Remove a map from Cloud. Who may remove a team map is the server's decision;
+ * this says what each refusal means and changes nothing locally either way.
+ *
+ * `confirmName`, when given (the MCP server, FR-010), must equal the map's
+ * exact name, and is checked before the removal is sent. Without it the name
+ * is read only so the confirmation can say WHICH map went.
+ */
+export declare function removeCloudMap(ctx: ClientContext, id: string | null, opts?: {
+    confirmName?: string;
+}): Promise<Outcome<{
+    id: string;
+    name: string | null;
+}>>;
+//# sourceMappingURL=maps.d.ts.map

package/dist/client/maps.d.ts.map

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