@lpenguin/notion-cli 1.0.0

package/dist/lib/safety.js

@@ -0,0 +1,60 @@
+/**
+ * Safety module — confirmation prompts, dry-run, and write guards.
+ *
+ * This is the single point of control for write safety.
+ */
+import chalk from 'chalk';
+import { createTwoFilesPatch } from 'diff';
+import * as logger from '../utils/logger.js';
+/**
+ * Guard for dry-run mode.
+ * Returns true if we should skip the actual write (dry-run is active).
+ */
+export function isDryRun(dryRun) {
+    if (dryRun === true) {
+        logger.info(chalk.cyan('[DRY RUN] No changes will be made.'));
+        return true;
+    }
+    return false;
+}
+/**
+ * Display a diff preview before applying changes.
+ *
+ * Shows a colored unified diff of the changes.
+ */
+export function showDiffPreview(before, after) {
+    const diffHunk = buildDiffHunk(before, after);
+    if (diffHunk === '') {
+        process.stderr.write(chalk.gray('\nNo changes detected.\n\n'));
+        return;
+    }
+    process.stderr.write(`\n${chalk.bold('Changes preview:')}\n`);
+    const lines = diffHunk.split('\n');
+    for (const line of lines) {
+        if (line.startsWith('+') && !line.startsWith('+++')) {
+            process.stderr.write(`${chalk.green(line)}\n`);
+        }
+        else if (line.startsWith('-') && !line.startsWith('---')) {
+            process.stderr.write(`${chalk.red(line)}\n`);
+        }
+        else if (line.startsWith('@@')) {
+            process.stderr.write(`${chalk.cyan(line)}\n`);
+        }
+        else if (line.startsWith('---') || line.startsWith('+++')) {
+            // Skip file headers
+        }
+        else {
+            process.stderr.write(` ${line}\n`);
+        }
+    }
+    process.stderr.write('\n');
+}
+/**
+ * Build a unified diff hunk with context.
+ */
+function buildDiffHunk(before, after) {
+    return createTwoFilesPatch('original', 'patched', before, after, '', '', {
+        context: 3,
+    });
+}
+//# sourceMappingURL=safety.js.map

package/dist/lib/safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/lib/safety.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAgB;IACvC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,KAAa;IAC3D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE9D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,oBAAoB;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,MAAc,EAAE,KAAa;IAClD,OAAO,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE;QACvE,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Shared types for the Notion CLI.
+ */
+/** Standard JSON output envelope for AI agent consumption. */
+export interface CliSuccessResponse<T = unknown> {
+    readonly ok: true;
+    readonly data: T;
+    readonly meta?: ResponseMeta;
+}
+export interface CliErrorResponse {
+    readonly ok: false;
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly details?: unknown;
+    };
+}
+export type CliResponse<T = unknown> = CliSuccessResponse<T> | CliErrorResponse;
+export interface ResponseMeta {
+    readonly cursor?: string;
+    readonly hasMore?: boolean;
+    readonly totalCount?: number;
+}
+/** Exit codes mapped to error categories. */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly VALIDATION_ERROR: 2;
+    readonly AUTH_ERROR: 3;
+    readonly NOT_FOUND: 4;
+    readonly RATE_LIMITED: 5;
+};
+export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
+/** Global CLI options available on every command. */
+export interface GlobalOptions {
+    readonly json?: boolean;
+    readonly token?: string;
+    readonly dryRun?: boolean;
+    readonly verbose?: boolean;
+}
+/** Page read result. */
+export interface PageReadResult {
+    readonly pageId: string;
+    readonly parentId?: string;
+    readonly title: string;
+    readonly markdown: string;
+    readonly lastEditedTime: string;
+}
+/** Page write result. */
+export interface PageWriteResult {
+    readonly pageId: string;
+    readonly blocksWritten: number;
+}
+/** Page patch result. */
+export interface PagePatchResult {
+    readonly pageId: string;
+    readonly linesChanged: number;
+    readonly diff: string;
+}
+/** Search result item. */
+export interface SearchResultItem {
+    readonly id: string;
+    readonly type: 'page' | 'database';
+    readonly title: string;
+    readonly url: string;
+    readonly lastEditedTime: string;
+}
+/** Search results. */
+export interface SearchResults {
+    readonly results: readonly SearchResultItem[];
+    readonly hasMore: boolean;
+    readonly nextCursor?: string;
+}
+/** Database schema property. */
+export interface DbPropertySchema {
+    readonly name: string;
+    readonly type: string;
+    readonly options?: readonly string[];
+}
+/** Database schema. */
+export interface DbSchema {
+    readonly databaseId: string;
+    readonly title: string;
+    readonly properties: readonly DbPropertySchema[];
+}
+/** Patch mode options. */
+export interface PatchLineRange {
+    readonly mode: 'lines';
+    readonly start: number;
+    readonly end: number;
+    readonly content: string;
+}
+export type PatchOperation = PatchLineRange;
+/** Block-to-line mapping for surgical patching. */
+export interface BlockLineMapping {
+    /** Notion block UUID. */
+    readonly blockId: string;
+    /** Block type (paragraph, heading_1, etc.). */
+    readonly type: string;
+    /** 1-indexed start line (inclusive). */
+    readonly startLine: number;
+    /** 1-indexed end line (inclusive). */
+    readonly endLine: number;
+    /** The markdown content for this block. */
+    readonly markdown: string;
+    /** Child block mappings (for nested blocks). */
+    readonly children: readonly BlockLineMapping[];
+}
+/** Result of building a block-line map. */
+export interface BlockLineMapResult {
+    /** The full markdown content. */
+    readonly markdown: string;
+    /** Mapping of blocks to line ranges. */
+    readonly mappings: readonly BlockLineMapping[];
+}
+/** A plan for surgical block patching. */
+export interface PatchPlan {
+    /** Block IDs to delete entirely. */
+    readonly blocksToDelete: readonly string[];
+    /** New blocks to insert. */
+    readonly blocksToInsert: readonly BlockInsert[];
+}
+/** A block insertion operation. */
+export interface BlockInsert {
+    /** Insert after this block ID. null = insert at start of page/parent. */
+    readonly afterId: string | null;
+    /** The markdown content to convert to blocks and insert. */
+    readonly markdown: string;
+    /** If set, insert as children of this block instead of at the page level. */
+    readonly parentBlockId?: string;
+}
+/** Config file shape. */
+export interface CliConfig {
+    readonly token?: string;
+    readonly defaultDatabase?: string;
+    readonly confirmBeforeWrite?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/types.js

@@ -0,0 +1,13 @@
+/**
+ * Shared types for the Notion CLI.
+ */
+/** Exit codes mapped to error categories. */
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    VALIDATION_ERROR: 2,
+    AUTH_ERROR: 3,
+    NOT_FOUND: 4,
+    RATE_LIMITED: 5,
+};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;CACP,CAAC"}

package/dist/lib/validator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Zod schemas for input validation.
+ * All user inputs are validated before hitting the Notion API.
+ */
+import { z } from 'zod';
+export declare const notionIdSchema: z.ZodString;
+/** Normalize a Notion ID to dashed UUID format. */
+export declare function normalizeId(id: string): string;
+/** Notion token: must start with ntn_ or secret_. */
+export declare const tokenSchema: z.ZodEffects<z.ZodString, string, string>;
+/** Line range: "START:END" where both are positive integers. */
+export declare const lineRangeSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, {
+    start: number;
+    end: number;
+}, string>, {
+    start: number;
+    end: number;
+}, string>, {
+    start: number;
+    end: number;
+}, string>, {
+    start: number;
+    end: number;
+}, string>;
+/** Search query: non-empty string, max 100 chars. */
+export declare const searchQuerySchema: z.ZodString;
+/** Limit: positive integer, max 100. */
+export declare const limitSchema: z.ZodNumber;
+/** File path: non-empty string. */
+export declare const filePathSchema: z.ZodString;
+/** JSON filter/sort string: must parse as valid JSON. */
+export declare const jsonStringSchema: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, unknown, string>;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,aAEyD,CAAC;AAErF,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED,qDAAqD;AACrD,eAAO,MAAM,WAAW,2CAMrB,CAAC;AAEJ,gEAAgE;AAChE,eAAO,MAAM,eAAe;;;;;;;;;;;;UAWyC,CAAC;AAEtE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,aAGwB,CAAC;AAEvD,wCAAwC;AACxC,eAAO,MAAM,WAAW,aAIY,CAAC;AAErC,mCAAmC;AACnC,eAAO,MAAM,cAAc,aAEY,CAAC;AAExC,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,0EAagB,CAAC"}

package/dist/lib/validator.js

@@ -0,0 +1,68 @@
+/**
+ * Zod schemas for input validation.
+ * All user inputs are validated before hitting the Notion API.
+ */
+import { z } from 'zod';
+/** Notion ID: UUID with or without dashes (32 hex chars). */
+const NOTION_ID_REGEX = /^[a-f0-9]{8}-?[a-f0-9]{4}-?[a-f0-9]{4}-?[a-f0-9]{4}-?[a-f0-9]{12}$/i;
+export const notionIdSchema = z
+    .string()
+    .regex(NOTION_ID_REGEX, 'Invalid Notion ID. Expected a UUID (32 hex characters).');
+/** Normalize a Notion ID to dashed UUID format. */
+export function normalizeId(id) {
+    const clean = id.replace(/-/g, '');
+    return [
+        clean.slice(0, 8),
+        clean.slice(8, 12),
+        clean.slice(12, 16),
+        clean.slice(16, 20),
+        clean.slice(20, 32),
+    ].join('-');
+}
+/** Notion token: must start with ntn_ or secret_. */
+export const tokenSchema = z
+    .string()
+    .min(1, 'Token cannot be empty.')
+    .refine((t) => t.startsWith('ntn_') || t.startsWith('secret_'), 'Token must start with "ntn_" or "secret_".');
+/** Line range: "START:END" where both are positive integers. */
+export const lineRangeSchema = z
+    .string()
+    .regex(/^\d+:\d+$/, 'Line range must be in format START:END (e.g., "192:256"). Both start and end are required.')
+    .transform((val) => {
+    const [startStr, endStr] = val.split(':');
+    const start = parseInt(startStr ?? '0', 10);
+    const end = parseInt(endStr ?? '0', 10);
+    return { start, end };
+})
+    .refine((r) => r.start >= 1, 'Start line must be >= 1.')
+    .refine((r) => r.end >= 1, 'End line must be >= 1.')
+    .refine((r) => r.end >= r.start, 'End line must be >= start line.');
+/** Search query: non-empty string, max 100 chars. */
+export const searchQuerySchema = z
+    .string()
+    .min(1, 'Search query cannot be empty.')
+    .max(100, 'Search query must be <= 100 characters.');
+/** Limit: positive integer, max 100. */
+export const limitSchema = z
+    .number()
+    .int()
+    .min(1, 'Limit must be >= 1.')
+    .max(100, 'Limit must be <= 100.');
+/** File path: non-empty string. */
+export const filePathSchema = z
+    .string()
+    .min(1, 'File path cannot be empty.');
+/** JSON filter/sort string: must parse as valid JSON. */
+export const jsonStringSchema = z
+    .string()
+    .refine((s) => {
+    try {
+        JSON.parse(s);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, 'Invalid JSON string.')
+    .transform((s) => JSON.parse(s));
+//# sourceMappingURL=validator.js.map

package/dist/lib/validator.js.map

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

package/dist/utils/id.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Notion ID parsing, validation, and extraction utilities.
+ */
+/**
+ * Parse and validate a Notion ID from user input.
+ * Accepts:
+ * - Raw UUIDs (with or without dashes)
+ * - Notion URLs (https://notion.so/page-title-abc123...)
+ * - Notion API IDs
+ *
+ * Returns a normalized dashed UUID.
+ */
+export declare function parseNotionId(input: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBnD"}

package/dist/utils/id.js

@@ -0,0 +1,33 @@
+/**
+ * Notion ID parsing, validation, and extraction utilities.
+ */
+import { notionIdSchema, normalizeId } from '../lib/validator.js';
+import { ValidationError } from '../lib/errors.js';
+/**
+ * Parse and validate a Notion ID from user input.
+ * Accepts:
+ * - Raw UUIDs (with or without dashes)
+ * - Notion URLs (https://notion.so/page-title-abc123...)
+ * - Notion API IDs
+ *
+ * Returns a normalized dashed UUID.
+ */
+export function parseNotionId(input) {
+    // Try to extract ID from a Notion URL
+    const urlMatch = /([a-f0-9]{32})(?:\?|$)/i.exec(input);
+    if (urlMatch?.[1] !== undefined) {
+        return normalizeId(urlMatch[1]);
+    }
+    // Try to extract dashed UUID from URL path
+    const dashedMatch = /([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})/i.exec(input);
+    if (dashedMatch?.[1] !== undefined) {
+        return normalizeId(dashedMatch[1]);
+    }
+    // Validate as raw ID
+    const result = notionIdSchema.safeParse(input);
+    if (!result.success) {
+        throw new ValidationError(`Invalid Notion ID: "${input}". Expected a UUID or Notion URL.`);
+    }
+    return normalizeId(result.data);
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,sCAAsC;IACtC,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,2CAA2C;IAC3C,MAAM,WAAW,GACf,iEAAiE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,qBAAqB;IACrB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CAAC,uBAAuB,KAAK,mCAAmC,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Structured logger — all status/progress goes to stderr.
+ * Data output goes to stdout (handled by output.ts).
+ * This ensures clean piping for AI agents.
+ */
+export declare function setVerbose(enabled: boolean): void;
+export declare function isVerbose(): boolean;
+/** Log informational message to stderr. */
+export declare function info(message: string): void;
+/** Log success message to stderr. */
+export declare function success(message: string): void;
+/** Log warning message to stderr. */
+export declare function warn(message: string): void;
+/** Log error message to stderr. */
+export declare function error(message: string): void;
+/** Log debug message to stderr (only when --verbose). */
+export declare function debug(message: string): void;
+/** Mask a token for safe logging. Shows first 4 and last 4 chars. */
+export declare function maskToken(token: string): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,2CAA2C;AAC3C,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,qCAAqC;AACrC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,mCAAmC;AACnC,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,yDAAyD;AACzD,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/dist/utils/logger.js

@@ -0,0 +1,43 @@
+/**
+ * Structured logger — all status/progress goes to stderr.
+ * Data output goes to stdout (handled by output.ts).
+ * This ensures clean piping for AI agents.
+ */
+import chalk from 'chalk';
+let verboseEnabled = false;
+export function setVerbose(enabled) {
+    verboseEnabled = enabled;
+}
+export function isVerbose() {
+    return verboseEnabled;
+}
+/** Log informational message to stderr. */
+export function info(message) {
+    process.stderr.write(`${chalk.blue('ℹ')} ${message}\n`);
+}
+/** Log success message to stderr. */
+export function success(message) {
+    process.stderr.write(`${chalk.green('✔')} ${message}\n`);
+}
+/** Log warning message to stderr. */
+export function warn(message) {
+    process.stderr.write(`${chalk.yellow('⚠')} ${message}\n`);
+}
+/** Log error message to stderr. */
+export function error(message) {
+    process.stderr.write(`${chalk.red('✖')} ${message}\n`);
+}
+/** Log debug message to stderr (only when --verbose). */
+export function debug(message) {
+    if (verboseEnabled) {
+        process.stderr.write(`${chalk.gray('⋯')} ${message}\n`);
+    }
+}
+/** Mask a token for safe logging. Shows first 4 and last 4 chars. */
+export function maskToken(token) {
+    if (token.length <= 12) {
+        return '****';
+    }
+    return `${token.slice(0, 4)}...${token.slice(-4)}`;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/utils/string.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Unescape string sequences like \n, \t, \r from command line arguments.
+ */
+export declare function unescapeString(str: string): string;
+/**
+ * Remove the common leading whitespace from every line in a string.
+ *
+ * Blank lines are ignored when calculating the common indent.
+ * Useful when nested Notion blocks produce indented markdown that
+ * must be fed back to a Markdown→Notion converter without the
+ * cosmetic indentation being misinterpreted as a code block.
+ */
+export declare function dedentMarkdown(text: string): string;
+//# sourceMappingURL=string.d.ts.map

package/dist/utils/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBnD"}

package/dist/utils/string.js

@@ -0,0 +1,37 @@
+/**
+ * Unescape string sequences like \n, \t, \r from command line arguments.
+ */
+export function unescapeString(str) {
+    return str
+        .replace(/\\n/g, '\n')
+        .replace(/\\t/g, '\t')
+        .replace(/\\r/g, '\r')
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, '\\');
+}
+/**
+ * Remove the common leading whitespace from every line in a string.
+ *
+ * Blank lines are ignored when calculating the common indent.
+ * Useful when nested Notion blocks produce indented markdown that
+ * must be fed back to a Markdown→Notion converter without the
+ * cosmetic indentation being misinterpreted as a code block.
+ */
+export function dedentMarkdown(text) {
+    const lines = text.split('\n');
+    const nonEmptyLines = lines.filter((l) => l.trim().length > 0);
+    if (nonEmptyLines.length === 0) {
+        return text;
+    }
+    const minIndent = Math.min(...nonEmptyLines.map((l) => {
+        const match = /^(\s*)/.exec(l);
+        return match?.[1]?.length ?? 0;
+    }));
+    if (minIndent === 0) {
+        return text;
+    }
+    return lines
+        .map((l) => (l.trim().length === 0 ? l : l.slice(minIndent)))
+        .join('\n');
+}
+//# sourceMappingURL=string.js.map

package/dist/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG;SACP,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;SAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@lpenguin/notion-cli",
+  "version": "1.0.0",
+  "description": "CLI tool for reading and editing Notion entries through Markdown and CSV. AI agent friendly.",
+  "type": "module",
+  "bin": {
+    "notion-md-csv-cli": "dist/index.js",
+    "notion-cli": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "notion",
+    "markdown",
+    "csv",
+    "cli",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@notionhq/client": "^5.9.0",
+    "@tryfabric/martian": "^1.2.4",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "csv-parse": "^5.5.6",
+    "csv-stringify": "^6.5.1",
+    "diff": "^7.0.0",
+    "dotenv": "^16.4.5",
+    "notion-to-md": "^3.1.1",
+    "ora": "^8.1.0",
+    "p-queue": "^9.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/diff": "^6.0.0",
+    "@types/node": "^22.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.16.0",
+    "@typescript-eslint/parser": "^8.16.0",
+    "eslint": "^9.15.0",
+    "prettier": "^3.4.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}