@instantkom/cli 3.129.2 → 3.131.0

package/dist/commands/webhooks/events.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command.js';
+export default class WebhooksEvents extends BaseCommand {
+    static description: string;
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-color': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/webhooks/events.js

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../base-command.js';
+const EVENTS = [
+    'new_contact',
+    'new_message',
+    'broadcast_sent',
+    'contact_updated',
+    'contact_opted_out',
+];
+export default class WebhooksEvents extends BaseCommand {
+    static description = 'List supported webhook event names';
+    static flags = { ...BaseCommand.baseFlags };
+    async run() {
+        const { flags } = await this.parse(WebhooksEvents);
+        this.flags = flags;
+        if (!flags.quiet)
+            this.log(this.toFormatted(EVENTS.map((event) => ({ event }))));
+    }
+}

package/dist/commands/webhooks/logs.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../base-command.js';
+export default class WebhooksLogs extends BaseCommand {
+    static description: string;
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-color': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/webhooks/logs.js

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../base-command.js';
+import { ApiError } from '../../errors/api-error.js';
+export default class WebhooksLogs extends BaseCommand {
+    static description = 'Explain webhook log availability';
+    static flags = { ...BaseCommand.baseFlags };
+    async run() {
+        const { flags } = await this.parse(WebhooksLogs);
+        this.flags = flags;
+        throw new ApiError('user_error', 'Webhook delivery logs are not exposed by the Public API yet. Use webhooks test for endpoint validation and server logs for delivery forensics.');
+    }
+}

package/dist/commands/webhooks/test.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../base-command.js';
+export default class WebhooksTest extends BaseCommand {
+    static description: string;
+    static flags: {
+        url: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        event: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        payload: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-color': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/webhooks/test.js

@@ -0,0 +1,27 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { ApiClient } from '../../api-client.js';
+import { parseJsonValue } from '../../command-helpers/json.js';
+export default class WebhooksTest extends BaseCommand {
+    static description = 'Send a test webhook payload to a URL';
+    static flags = {
+        ...BaseCommand.baseFlags,
+        url: Flags.string({ description: 'Webhook URL to call', required: true }),
+        event: Flags.string({ description: 'Event name', default: 'cli.test' }),
+        payload: Flags.string({ description: 'Payload JSON' }),
+    };
+    async run() {
+        const { flags } = await this.parse(WebhooksTest);
+        this.flags = flags;
+        const payload = flags.payload
+            ? parseJsonValue(flags.payload, '--payload')
+            : {
+                event: flags.event,
+                source: 'instantkom-cli',
+                sentAt: new Date().toISOString(),
+            };
+        const result = await ApiClient.postRaw(flags.url, payload);
+        if (!flags.quiet)
+            this.log(this.toFormatted(result));
+    }
+}

package/dist/commands/whoami.js

@@ -1,5 +1,4 @@
 import { BaseCommand } from '../base-command.js';
-import { EXIT_CODES } from '../errors/exit-codes.js';
 import { ApiError } from '../errors/api-error.js';
 import { resolveToken } from '../auth/token-resolver.js';
 import { ApiClient } from '../api-client.js';
@@ -35,6 +34,5 @@ export default class Whoami extends BaseCommand {
             channel_count: me.channel_count ?? 0,
         };
         this.log(this.toFormatted(output));
-        this.exit(EXIT_CODES.OK);
     }
 }

package/dist/crud/csv.js

@@ -65,7 +65,8 @@ function serializeValue(value) {
     if (value === undefined || value === null) {
         return '';
     }
-    const text = typeof value === 'object' ? JSON.stringify(value) : String(value);
+    const rawText = typeof value === 'object' ? JSON.stringify(value) : String(value);
+    const text = /^[=+\-@\t\r]/.test(rawText) ? `'${rawText}` : rawText;
     if (/[",\r\n]/.test(text)) {
         return `"${text.replaceAll('"', '""')}"`;
     }

package/dist/errors/api-error.d.ts

@@ -1,4 +1,4 @@
-export type ApiErrorKind = 'unauthorized' | 'rate_limited' | 'server_error' | 'network' | 'user_error';
+export type ApiErrorKind = 'unauthorized' | 'forbidden' | 'rate_limited' | 'server_error' | 'network' | 'user_error';
 export declare class ApiError extends Error {
     kind: ApiErrorKind;
     status?: number | undefined;

package/dist/errors/exit-codes.js

@@ -9,6 +9,7 @@ export const EXIT_CODES = Object.freeze({
 export function mapApiErrorToCode(err) {
     switch (err.kind) {
         case 'unauthorized':
+        case 'forbidden':
             return EXIT_CODES.AUTH;
         case 'rate_limited':
             return EXIT_CODES.RATE_LIMIT;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@instantkom/cli",
-  "version": "3.129.2",
+  "version": "3.131.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@instantkom/cli",
-      "version": "3.129.2",
+      "version": "3.131.0",
       "license": "UNLICENSED",
       "dependencies": {
         "@oclif/core": "^4",