@doist/comms-cli 0.0.1 → 1.1.0

package/dist/lib/progress.js

@@ -0,0 +1,86 @@
+import fs from 'node:fs';
+import { getProgressJsonlPath, isProgressJsonlEnabled } from './global-args.js';
+export class ProgressTracker {
+    enabled = false;
+    outputStream = null;
+    constructor() {
+        this.checkAndInitialize();
+    }
+    checkAndInitialize() {
+        if (!isProgressJsonlEnabled()) {
+            return;
+        }
+        this.enabled = true;
+        const outputPath = getProgressJsonlPath();
+        if (outputPath) {
+            try {
+                this.outputStream = fs.createWriteStream(outputPath, { flags: 'a' });
+            }
+            catch (_error) {
+                // Fall back to stderr if file creation fails
+                console.error(`Warning: Could not create progress file ${outputPath}, falling back to stderr`);
+                this.outputStream = process.stderr;
+            }
+        }
+        else {
+            this.outputStream = process.stderr;
+        }
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    emit(event) {
+        if (!this.enabled || !this.outputStream) {
+            return;
+        }
+        const progressEvent = {
+            ...event,
+            timestamp: new Date().toISOString(),
+        };
+        const line = `${JSON.stringify(progressEvent)}\n`;
+        this.outputStream.write(line);
+    }
+    emitStart(command) {
+        this.emit({ type: 'start', command });
+    }
+    emitApiCall(endpoint, cursor) {
+        this.emit({ type: 'api_call', endpoint, cursor });
+    }
+    emitApiResponse(count, hasMore, nextCursor) {
+        this.emit({
+            type: 'api_response',
+            count,
+            has_more: hasMore,
+            next_cursor: nextCursor,
+        });
+    }
+    emitComplete() {
+        this.emit({ type: 'complete' });
+    }
+    emitError(errorCode, message) {
+        this.emit({ type: 'error', error_code: errorCode, message });
+    }
+    close() {
+        if (this.outputStream && this.outputStream !== process.stderr) {
+            ;
+            this.outputStream.close();
+        }
+        this.enabled = false;
+        this.outputStream = null;
+    }
+}
+// Global singleton instance
+let progressTracker = null;
+export function getProgressTracker() {
+    if (!progressTracker) {
+        progressTracker = new ProgressTracker();
+    }
+    return progressTracker;
+}
+export function resetProgressTracker() {
+    if (progressTracker) {
+        progressTracker.close();
+    }
+    progressTracker = null;
+}
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

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

package/dist/lib/public-channels.d.ts

@@ -0,0 +1,4 @@
+export declare function getPublicChannelIds(workspaceId: number): Promise<Set<string>>;
+export declare function clearPublicChannelCache(): void;
+export declare function assertChannelIsPublic(channelId: string, workspaceId: number): Promise<void>;
+//# sourceMappingURL=public-channels.d.ts.map

package/dist/lib/public-channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-channels.d.ts","sourceRoot":"","sources":["../../src/lib/public-channels.ts"],"names":[],"mappings":"AAMA,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAYnF;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG"}

package/dist/lib/public-channels.js

@@ -0,0 +1,32 @@
+import { getCommsClient } from './api.js';
+import { CliError } from './errors.js';
+import { includePrivateChannels } from './global-args.js';
+const publicChannelCache = new Map();
+export async function getPublicChannelIds(workspaceId) {
+    const cached = publicChannelCache.get(workspaceId);
+    if (cached)
+        return cached;
+    const client = await getCommsClient();
+    const channels = await client.channels.getChannels({ workspaceId });
+    const publicIds = new Set();
+    for (const ch of channels) {
+        if (ch.public)
+            publicIds.add(ch.id);
+    }
+    publicChannelCache.set(workspaceId, publicIds);
+    return publicIds;
+}
+export function clearPublicChannelCache() {
+    publicChannelCache.clear();
+}
+export async function assertChannelIsPublic(channelId, workspaceId) {
+    if (includePrivateChannels())
+        return;
+    const publicIds = await getPublicChannelIds(workspaceId);
+    if (!publicIds.has(channelId)) {
+        throw new CliError('NOT_FOUND', 'This thread belongs to a private channel.', [
+            'Use --include-private-channels to access it',
+        ]);
+    }
+}
+//# sourceMappingURL=public-channels.js.map

package/dist/lib/public-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-channels.js","sourceRoot":"","sources":["../../src/lib/public-channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAuB,CAAA;AAEzD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IACzD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAClD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAA;IACrC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC,CAAA;IACnE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxB,IAAI,EAAE,CAAC,MAAM;YAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IACD,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAC9C,OAAO,SAAS,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACnC,kBAAkB,CAAC,KAAK,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB,EAAE,WAAmB;IAC9E,IAAI,sBAAsB,EAAE;QAAE,OAAM;IACpC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAA;IACxD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,2CAA2C,EAAE;YACzE,6CAA6C;SAChD,CAAC,CAAA;IACN,CAAC;AACL,CAAC"}

package/dist/lib/refs.d.ts

@@ -0,0 +1,82 @@
+import type { Channel, Group, Workspace } from '@doist/comms-sdk';
+export declare function isIdRef(ref: string): boolean;
+/**
+ * Returns the raw id portion of `123`, `id:123`, or `id:abc-xyz`. The Comms
+ * backend uses numeric ids for users and workspaces and base58 UUIDv7 strings
+ * for everything else, so this stays string-typed and consumers narrow as
+ * needed (`Number(...)` for numeric refs after validation).
+ */
+export declare function extractId(ref: string): string;
+export declare function extractNumericId(ref: string): number;
+export declare function parseNumericIdRefs(refs: string, label?: string): number[] | null;
+export declare function looksLikeRawId(ref: string): boolean;
+export interface ParsedCommsUrl {
+    workspaceId?: number;
+    channelId?: string;
+    threadId?: string;
+    commentId?: string;
+    conversationId?: string;
+    messageId?: string;
+}
+export declare function parseCommsUrl(url: string): ParsedCommsUrl | null;
+export type ParsedRef = {
+    type: 'id';
+    id: string;
+} | {
+    type: 'url';
+    parsed: ParsedCommsUrl;
+} | {
+    type: 'name';
+    name: string;
+};
+export declare function parseRef(ref: string): ParsedRef;
+export declare function resolveWorkspaceRef(ref: string): Promise<Workspace>;
+export declare function resolveThreadId(ref: string): string;
+export declare function resolveChannelRef(ref: string, workspaceId: number): Promise<Channel>;
+export declare function resolveChannelId(ref: string): string;
+export declare function getDirectChannelId(ref: string): string | null;
+export declare function resolveCommentId(ref: string): string;
+export declare function resolveConversationId(ref: string): string;
+export declare function resolveMessageId(ref: string): string;
+export type CommsUrlRoute = {
+    entityType: 'message' | 'conversation' | 'comment' | 'thread';
+    url: string;
+};
+export declare function classifyCommsUrl(url: string): CommsUrlRoute | null;
+/**
+ * Split a list of notify refs into numeric user IDs and base58 group IDs by
+ * checking each ref against the workspace's known group IDs. Anything not in
+ * the group set is treated as a user ID and parsed as a number.
+ */
+export declare function partitionNotifyIds(ids: readonly string[], groupIds: ReadonlySet<string>): {
+    userIds: number[];
+    groupIds: string[];
+};
+/**
+ * Parse a comma-separated list of notify refs into raw IDs (untyped — callers
+ * use {@link partitionNotifyIds} to split into users vs. groups).
+ */
+export declare function parseNotifyIdRefs(refs: string): string[];
+export declare function resolveGroupRef(ref: string, workspaceId: number): Promise<Group>;
+export type ChannelMemberRefs = {
+    userIds: number[];
+    expandedFrom: {
+        groupId: string;
+        groupName: string;
+        userIds: number[];
+    }[];
+};
+/**
+ * Resolve a mixed list of user and `group:<ref>` references for channel membership.
+ *
+ * Groups are expanded to their current `userIds` at call time. The group itself
+ * is not persistently linked to the channel — callers should surface that
+ * caveat in user-facing help text.
+ *
+ * Returns deduped userIds in input order, with a parallel `expandedFrom` list
+ * recording which groups contributed (and which users each group brought in,
+ * pre-dedup) for reporting purposes.
+ */
+export declare function resolveChannelMemberRefs(refs: string[], workspaceId: number): Promise<ChannelMemberRefs>;
+export declare function resolveUserRefs(refs: string, workspaceId: number): Promise<number[]>;
+//# sourceMappingURL=refs.d.ts.map

package/dist/lib/refs.d.ts.map

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