bkper 4.0.1 → 4.1.0

package/lib/commands/collections/index.js

@@ -1,4 +1,4 @@
-export { listCollections } from './list.js';
+export { listCollections, listCollectionsFormatted } from './list.js';
 export { getCollection } from './get.js';
 export { createCollection } from './create.js';
 export { updateCollection } from './update.js';

package/lib/commands/collections/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAA2B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAA2B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/commands/collections/list.d.ts

@@ -1,3 +1,14 @@
 import { Collection } from 'bkper-js';
+import type { OutputFormat, ListResult } from '../../render/output.js';
+/**
+ * Fetches all collections for the authenticated user.
+ *
+ * @returns Array of all collections
+ */
 export declare function listCollections(): Promise<Collection[]>;
+/**
+ * Lists collections and returns a ListResult ready for rendering.
+ * Absorbs manual matrix building and JSON mapping.
+ */
+export declare function listCollectionsFormatted(format: OutputFormat): Promise<ListResult>;
 //# sourceMappingURL=list.d.ts.map

package/lib/commands/collections/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAI7D"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAI7D;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBxF"}

package/lib/commands/collections/list.js

@@ -8,6 +8,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { getBkperInstance } from '../../bkper-factory.js';
+/**
+ * Fetches all collections for the authenticated user.
+ *
+ * @returns Array of all collections
+ */
 export function listCollections() {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();
@@ -15,4 +20,25 @@ export function listCollections() {
         return collections;
     });
 }
+/**
+ * Lists collections and returns a ListResult ready for rendering.
+ * Absorbs manual matrix building and JSON mapping.
+ */
+export function listCollectionsFormatted(format) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const collections = yield listCollections();
+        if (format === 'json') {
+            return { kind: 'json', data: collections.map(c => c.json()) };
+        }
+        if (collections.length === 0) {
+            return { kind: 'matrix', matrix: [['No collections found.']] };
+        }
+        const matrix = [['ID', 'Name', 'Books']];
+        for (const col of collections) {
+            const books = col.getBooks();
+            matrix.push([col.getId() || '', col.getName() || '', books.length.toString()]);
+        }
+        return { kind: 'matrix', matrix };
+    });
+}
 //# sourceMappingURL=list.js.map

package/lib/commands/collections/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/collections/list.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,UAAgB,eAAe;;QACjC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC;IACvB,CAAC;CAAA"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/collections/list.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D;;;;GAIG;AACH,MAAM,UAAgB,eAAe;;QACjC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC;IACvB,CAAC;CAAA;AAED;;;GAGG;AACH,MAAM,UAAgB,wBAAwB,CAAC,MAAoB;;QAC/D,MAAM,WAAW,GAAG,MAAM,eAAe,EAAE,CAAC;QAE5C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC;QAED,MAAM,MAAM,GAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;CAAA"}

package/lib/commands/collections/register.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCollectionCommands(program: Command): void;
+//# sourceMappingURL=register.d.ts.map

package/lib/commands/collections/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyGjE"}

package/lib/commands/collections/register.js

@@ -0,0 +1,86 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { withAction } from '../action.js';
+import { collectBook } from '../cli-helpers.js';
+import { renderListResult, renderItem } from '../../render/index.js';
+import { validateRequiredOptions, throwIfErrors } from '../../utils/validation.js';
+import { listCollectionsFormatted, getCollection, createCollection, updateCollection, deleteCollection, addBookToCollection, removeBookFromCollection, } from './index.js';
+export function registerCollectionCommands(program) {
+    const collectionCommand = program.command('collection').description('Manage Collections');
+    collectionCommand
+        .command('list')
+        .description('List all collections')
+        .action(withAction('listing collections', (format) => __awaiter(this, void 0, void 0, function* () {
+        const result = yield listCollectionsFormatted(format);
+        renderListResult(result, format);
+    })));
+    collectionCommand
+        .command('get <collectionId>')
+        .description('Get a collection by ID')
+        .action((collectionId) => withAction('getting collection', (format) => __awaiter(this, void 0, void 0, function* () {
+        const collection = yield getCollection(collectionId);
+        renderItem(collection.json(), format);
+    }))());
+    collectionCommand
+        .command('create')
+        .description('Create a new collection')
+        .option('--name <name>', 'Collection name')
+        .action(options => withAction('creating collection', (format) => __awaiter(this, void 0, void 0, function* () {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'name', flag: '--name' }]));
+        const collection = yield createCollection({ name: options.name });
+        renderItem(collection.json(), format);
+    }))());
+    collectionCommand
+        .command('update <collectionId>')
+        .description('Update a collection')
+        .option('--name <name>', 'Collection name')
+        .action((collectionId, options) => withAction('updating collection', (format) => __awaiter(this, void 0, void 0, function* () {
+        const collection = yield updateCollection(collectionId, {
+            name: options.name,
+        });
+        renderItem(collection.json(), format);
+    }))());
+    collectionCommand
+        .command('delete <collectionId>')
+        .description('Delete a collection')
+        .action((collectionId) => withAction('deleting collection', () => __awaiter(this, void 0, void 0, function* () {
+        yield deleteCollection(collectionId);
+        console.log(`Collection ${collectionId} deleted.`);
+    }))());
+    collectionCommand
+        .command('add-book <collectionId>')
+        .description('Add books to a collection')
+        .option('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
+        .action((collectionId, options) => withAction('adding books to collection', (format) => __awaiter(this, void 0, void 0, function* () {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
+        const books = yield addBookToCollection(collectionId, options.book);
+        if (format === 'json' || format === 'csv') {
+            console.log(JSON.stringify(books.map(b => b.json()), null, 2));
+        }
+        else {
+            console.log(`Added ${options.book.length} book(s) to collection ${collectionId}.`);
+        }
+    }))());
+    collectionCommand
+        .command('remove-book <collectionId>')
+        .description('Remove books from a collection')
+        .option('-b, --book <bookId>', 'Book ID (repeatable)', collectBook)
+        .action((collectionId, options) => withAction('removing books from collection', (format) => __awaiter(this, void 0, void 0, function* () {
+        throwIfErrors(validateRequiredOptions(options, [{ name: 'book', flag: '--book' }]));
+        const books = yield removeBookFromCollection(collectionId, options.book);
+        if (format === 'json' || format === 'csv') {
+            console.log(JSON.stringify(books.map(b => b.json()), null, 2));
+        }
+        else {
+            console.log(`Removed ${options.book.length} book(s) from collection ${collectionId}.`);
+        }
+    }))());
+}
+//# sourceMappingURL=register.js.map

package/lib/commands/collections/register.js.map

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

package/lib/commands/collections/remove-book.d.ts

@@ -1,3 +1,11 @@
 import { Book } from 'bkper-js';
+/**
+ * Removes one or more books from a collection.
+ *
+ * @param collectionId - The ID of the collection to remove books from
+ * @param bookIds - Array of book IDs to remove
+ * @returns The books that were removed from the collection
+ * @throws Error if the collection is not found
+ */
 export declare function removeBookFromCollection(collectionId: string, bookIds: string[]): Promise<Book[]>;
 //# sourceMappingURL=remove-book.d.ts.map

package/lib/commands/collections/remove-book.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove-book.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/remove-book.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,wBAAsB,wBAAwB,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,EAAE,CAAC,CAgBjB"}
+{"version":3,"file":"remove-book.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/remove-book.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC1C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,EAAE,CAAC,CAgBjB"}

package/lib/commands/collections/remove-book.js

@@ -8,6 +8,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { getBkperInstance } from '../../bkper-factory.js';
+/**
+ * Removes one or more books from a collection.
+ *
+ * @param collectionId - The ID of the collection to remove books from
+ * @param bookIds - Array of book IDs to remove
+ * @returns The books that were removed from the collection
+ * @throws Error if the collection is not found
+ */
 export function removeBookFromCollection(collectionId, bookIds) {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();

package/lib/commands/collections/remove-book.js.map

@@ -1 +1 @@
-{"version":3,"file":"remove-book.js","sourceRoot":"","sources":["../../../src/commands/collections/remove-book.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,UAAgB,wBAAwB,CAC1C,YAAoB,EACpB,OAAiB;;QAEjB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,YAAY,CAAC,CAAC;QAErE,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CAAA"}
+{"version":3,"file":"remove-book.js","sourceRoot":"","sources":["../../../src/commands/collections/remove-book.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;;GAOG;AACH,MAAM,UAAgB,wBAAwB,CAC1C,YAAoB,EACpB,OAAiB;;QAEjB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,YAAY,CAAC,CAAC;QAErE,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CAAA"}

package/lib/commands/collections/update.d.ts

@@ -1,6 +1,17 @@
 import { Collection } from 'bkper-js';
+/**
+ * Options for updating a collection.
+ */
 export interface UpdateCollectionOptions {
     name?: string;
 }
+/**
+ * Updates an existing collection with the provided options.
+ *
+ * @param collectionId - The ID of the collection to update
+ * @param options - Fields to update on the collection
+ * @returns The updated Collection
+ * @throws Error if the collection is not found
+ */
 export declare function updateCollection(collectionId: string, options: UpdateCollectionOptions): Promise<Collection>;
 //# sourceMappingURL=update.d.ts.map

package/lib/commands/collections/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,uBAAuB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,UAAU,CAAC,CAYrB"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/collections/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,UAAU,CAAC,CAYrB"}

package/lib/commands/collections/update.js

@@ -8,6 +8,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { getBkperInstance } from '../../bkper-factory.js';
+/**
+ * Updates an existing collection with the provided options.
+ *
+ * @param collectionId - The ID of the collection to update
+ * @param options - Fields to update on the collection
+ * @returns The updated Collection
+ * @throws Error if the collection is not found
+ */
 export function updateCollection(collectionId, options) {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();

package/lib/commands/collections/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/collections/update.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO1D,MAAM,UAAgB,gBAAgB,CAClC,YAAoB,EACpB,OAAgC;;QAEhC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,YAAY,CAAC,CAAC;QAErE,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjE,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;CAAA"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/collections/update.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU1D;;;;;;;GAOG;AACH,MAAM,UAAgB,gBAAgB,CAClC,YAAoB,EACpB,OAAgC;;QAEhC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,YAAY,CAAC,CAAC;QAErE,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEjE,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;CAAA"}

package/lib/commands/groups/batch-create.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Creates multiple groups from stdin items using the batch API.
+ * Outputs NDJSON (one JSON object per line) as each chunk completes.
+ *
+ * @param bookId - Target book ID
+ * @param items - Parsed stdin items (field-value maps)
+ * @param propertyOverrides - CLI --property flags that override stdin fields
+ */
+export declare function batchCreateGroups(bookId: string, items: Record<string, string>[], propertyOverrides?: string[]): Promise<void>;
+//# sourceMappingURL=batch-create.d.ts.map

package/lib/commands/groups/batch-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-create.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/batch-create.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAC/B,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/lib/commands/groups/batch-create.js

@@ -0,0 +1,69 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { getBkperInstance } from '../../bkper-factory.js';
+import { Group } from 'bkper-js';
+import { parsePropertyFlag } from '../../utils/properties.js';
+const CHUNK_SIZE = 100;
+/**
+ * Creates multiple groups from stdin items using the batch API.
+ * Outputs NDJSON (one JSON object per line) as each chunk completes.
+ *
+ * @param bookId - Target book ID
+ * @param items - Parsed stdin items (field-value maps)
+ * @param propertyOverrides - CLI --property flags that override stdin fields
+ */
+export function batchCreateGroups(bookId, items, propertyOverrides) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const bkper = getBkperInstance();
+        const book = yield bkper.getBook(bookId);
+        for (let i = 0; i < items.length; i += CHUNK_SIZE) {
+            const chunk = items.slice(i, i + CHUNK_SIZE);
+            const groups = [];
+            for (const item of chunk) {
+                const group = new Group(book);
+                if (item.name)
+                    group.setName(item.name);
+                if (item.hidden !== undefined)
+                    group.setHidden(item.hidden === 'true');
+                // Set properties from stdin fields (excluding known fields)
+                const knownFields = new Set(['name', 'parent', 'hidden']);
+                for (const [key, value] of Object.entries(item)) {
+                    if (!knownFields.has(key) && value !== '') {
+                        group.setProperty(key, value);
+                    }
+                }
+                // CLI --property flags override stdin
+                if (propertyOverrides) {
+                    for (const raw of propertyOverrides) {
+                        const [key, value] = parsePropertyFlag(raw);
+                        if (value === '') {
+                            group.deleteProperty(key);
+                        }
+                        else {
+                            group.setProperty(key, value);
+                        }
+                    }
+                }
+                if (item.parent) {
+                    const parentGroup = yield book.getGroup(item.parent);
+                    if (parentGroup) {
+                        group.setParent(parentGroup);
+                    }
+                }
+                groups.push(group);
+            }
+            const results = yield book.batchCreateGroups(groups);
+            for (const result of results) {
+                console.log(JSON.stringify(result.json()));
+            }
+        }
+    });
+}
+//# sourceMappingURL=batch-create.js.map

package/lib/commands/groups/batch-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-create.js","sourceRoot":"","sources":["../../../src/commands/groups/batch-create.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAgB,iBAAiB,CACnC,MAAc,EACd,KAA+B,EAC/B,iBAA4B;;QAE5B,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAY,EAAE,CAAC;YAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI;oBAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;oBAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;gBAEvE,4DAA4D;gBAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;wBACxC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBAClC,CAAC;gBACL,CAAC;gBAED,sCAAsC;gBACtC,IAAI,iBAAiB,EAAE,CAAC;oBACpB,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;wBAClC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;wBAC5C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;4BACf,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;wBAC9B,CAAC;6BAAM,CAAC;4BACJ,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAClC,CAAC;oBACL,CAAC;gBACL,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACd,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACrD,IAAI,WAAW,EAAE,CAAC;wBACd,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;oBACjC,CAAC;gBACL,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACrD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/C,CAAC;QACL,CAAC;IACL,CAAC;CAAA"}

package/lib/commands/groups/create.d.ts

@@ -1,9 +1,17 @@
 import { Group } from 'bkper-js';
+/** Options for creating a new group in a book. */
 export interface CreateGroupOptions {
     name: string;
     parent?: string;
     hidden?: boolean;
     property?: string[];
 }
+/**
+ * Creates a new group in the specified book.
+ *
+ * @param bookId - The ID of the book to create the group in
+ * @param options - Group creation options including name, parent, and properties
+ * @returns The newly created Group
+ */
 export declare function createGroup(bookId: string, options: CreateGroupOptions): Promise<Group>;
 //# sourceMappingURL=create.d.ts.map

package/lib/commands/groups/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjC,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CA2B7F"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAIjC,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAqC7F"}

package/lib/commands/groups/create.js

@@ -10,21 +10,35 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { getBkperInstance } from '../../bkper-factory.js';
 import { Group } from 'bkper-js';
 import { parsePropertyFlag } from '../../utils/properties.js';
+import { throwIfErrors } from '../../utils/validation.js';
+/**
+ * Creates a new group in the specified book.
+ *
+ * @param bookId - The ID of the book to create the group in
+ * @param options - Group creation options including name, parent, and properties
+ * @returns The newly created Group
+ */
 export function createGroup(bookId, options) {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();
         const book = yield bkper.getBook(bookId);
+        const errors = [];
         const group = new Group(book).setName(options.name);
         if (options.hidden !== undefined)
             group.setHidden(options.hidden);
         if (options.property) {
             for (const raw of options.property) {
-                const [key, value] = parsePropertyFlag(raw);
-                if (value === '') {
-                    group.deleteProperty(key);
+                try {
+                    const [key, value] = parsePropertyFlag(raw);
+                    if (value === '') {
+                        group.deleteProperty(key);
+                    }
+                    else {
+                        group.setProperty(key, value);
+                    }
                 }
-                else {
-                    group.setProperty(key, value);
+                catch (err) {
+                    errors.push(err.message);
                 }
             }
         }
@@ -33,7 +47,11 @@ export function createGroup(bookId, options) {
             if (parentGroup) {
                 group.setParent(parentGroup);
             }
+            else {
+                errors.push(`Parent group not found: ${options.parent}`);
+            }
         }
+        throwIfErrors(errors);
         return group.create();
     });
 }

package/lib/commands/groups/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAS9D,MAAM,UAAgB,WAAW,CAAC,MAAc,EAAE,OAA2B;;QACzE,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;gBAC5C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;oBACf,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACJ,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAClC,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,WAAW,EAAE,CAAC;gBACd,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;CAAA"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAU1D;;;;;;GAMG;AACH,MAAM,UAAgB,WAAW,CAAC,MAAc,EAAE,OAA2B;;QACzE,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACD,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;oBAC5C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;wBACf,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;oBAC9B,CAAC;yBAAM,CAAC;wBACJ,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBAClC,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACpB,MAAM,CAAC,IAAI,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;gBACxC,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,WAAW,EAAE,CAAC;gBACd,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC;QAED,aAAa,CAAC,MAAM,CAAC,CAAC;QAEtB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;CAAA"}

package/lib/commands/groups/delete.d.ts

@@ -1,3 +1,10 @@
 import { Group } from 'bkper-js';
+/**
+ * Deletes a group from the specified book.
+ *
+ * @param bookId - The ID of the book containing the group
+ * @param groupIdOrName - The ID or name of the group to delete
+ * @returns The removed Group
+ */
 export declare function deleteGroup(bookId: string, groupIdOrName: string): Promise<Group>;
 //# sourceMappingURL=delete.d.ts.map

package/lib/commands/groups/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CASvF"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CASvF"}

package/lib/commands/groups/delete.js

@@ -8,6 +8,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { getBkperInstance } from '../../bkper-factory.js';
+/**
+ * Deletes a group from the specified book.
+ *
+ * @param bookId - The ID of the book containing the group
+ * @param groupIdOrName - The ID or name of the group to delete
+ * @returns The removed Group
+ */
 export function deleteGroup(bookId, groupIdOrName) {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();

package/lib/commands/groups/delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,UAAgB,WAAW,CAAC,MAAc,EAAE,aAAqB;;QACnE,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;CAAA"}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,UAAgB,WAAW,CAAC,MAAc,EAAE,aAAqB;;QACnE,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;CAAA"}

package/lib/commands/groups/get.d.ts

@@ -1,3 +1,10 @@
 import { Group } from 'bkper-js';
+/**
+ * Retrieves a group by its ID or name from the specified book.
+ *
+ * @param bookId - The ID of the book containing the group
+ * @param groupIdOrName - The ID or name of the group to retrieve
+ * @returns The matching Group
+ */
 export declare function getGroup(bookId: string, groupIdOrName: string): Promise<Group>;
 //# sourceMappingURL=get.d.ts.map

package/lib/commands/groups/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAQpF"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAQpF"}

package/lib/commands/groups/get.js

@@ -8,6 +8,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { getBkperInstance } from '../../bkper-factory.js';
+/**
+ * Retrieves a group by its ID or name from the specified book.
+ *
+ * @param bookId - The ID of the book containing the group
+ * @param groupIdOrName - The ID or name of the group to retrieve
+ * @returns The matching Group
+ */
 export function getGroup(bookId, groupIdOrName) {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();

package/lib/commands/groups/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/groups/get.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,UAAgB,QAAQ,CAAC,MAAc,EAAE,aAAqB;;QAChE,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CAAA"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/groups/get.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,UAAgB,QAAQ,CAAC,MAAc,EAAE,aAAqB;;QAChE,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CAAA"}

package/lib/commands/groups/index.d.ts

@@ -1,6 +1,7 @@
-export { listGroups } from './list.js';
+export { listGroups, listGroupsFormatted } from './list.js';
 export { getGroup } from './get.js';
 export { createGroup, CreateGroupOptions } from './create.js';
 export { updateGroup, UpdateGroupOptions } from './update.js';
 export { deleteGroup } from './delete.js';
+export { batchCreateGroups } from './batch-create.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/commands/groups/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/commands/groups/index.js

@@ -1,6 +1,7 @@
-export { listGroups } from './list.js';
+export { listGroups, listGroupsFormatted } from './list.js';
 export { getGroup } from './get.js';
 export { createGroup } from './create.js';
 export { updateGroup } from './update.js';
 export { deleteGroup } from './delete.js';
+export { batchCreateGroups } from './batch-create.js';
 //# sourceMappingURL=index.js.map

package/lib/commands/groups/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/groups/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/groups/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/commands/groups/list.d.ts

@@ -1,3 +1,15 @@
 import { Group } from 'bkper-js';
+import type { OutputFormat, ListResult } from '../../render/output.js';
+/**
+ * Retrieves all groups from the specified book.
+ *
+ * @param bookId - The ID of the book to list groups from
+ * @returns Array of groups in the book, or an empty array if none exist
+ */
 export declare function listGroups(bookId: string): Promise<Group[]>;
+/**
+ * Lists groups and returns a ListResult ready for rendering.
+ * Absorbs GroupsDataTableBuilder config and JSON mapping.
+ */
+export declare function listGroupsFormatted(bookId: string, format: OutputFormat): Promise<ListResult>;
 //# sourceMappingURL=list.d.ts.map

package/lib/commands/groups/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAKjE"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAA0B,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAKjE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/lib/commands/groups/list.js

@@ -8,6 +8,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { getBkperInstance } from '../../bkper-factory.js';
+import { GroupsDataTableBuilder } from 'bkper-js';
+/**
+ * Retrieves all groups from the specified book.
+ *
+ * @param bookId - The ID of the book to list groups from
+ * @returns Array of groups in the book, or an empty array if none exist
+ */
 export function listGroups(bookId) {
     return __awaiter(this, void 0, void 0, function* () {
         const bkper = getBkperInstance();
@@ -16,4 +23,22 @@ export function listGroups(bookId) {
         return groups || [];
     });
 }
+/**
+ * Lists groups and returns a ListResult ready for rendering.
+ * Absorbs GroupsDataTableBuilder config and JSON mapping.
+ */
+export function listGroupsFormatted(bookId, format) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const groups = yield listGroups(bookId);
+        if (format === 'json') {
+            return { kind: 'json', data: groups.map(g => g.json()) };
+        }
+        const builder = new GroupsDataTableBuilder(groups).ids(true).tree(true);
+        if (format === 'csv') {
+            builder.properties(true).hiddenProperties(true);
+        }
+        const matrix = builder.build();
+        return { kind: 'matrix', matrix };
+    });
+}
 //# sourceMappingURL=list.js.map