scrapely 1.2.25 → 1.2.26

package/dist/actor.d.ts

@@ -22,7 +22,17 @@ import { ChargingManager, type ChargeOptions as ChargingChargeOptions, type Char
 /** Options for a multi-event charged push (`Actor.pushData(row, { charges })`). */
 export interface PushDataChargeOptions {
     /** Events per row, e.g. `{ result: 1, page: 3 }` (per batch with `chargePer: 'batch'`). */
-    charges: Record<string, number>;
+    charges?: Record<string, number>;
+    /** One event per row (same as `pushData(item, eventName)`); not together with `charges`. */
+    eventName?: string;
+    /**
+     * Push to this named dataset (name, or a Dataset from `Actor.openDataset`) instead of the
+     * default one, with the same charge-first semantics, e.g.
+     * `pushData(rows, { eventName: 'comment', dataset: \`comments-${runId}\` })`. Rows of a named
+     * dataset carry no implicit default-dataset-item event and are not gated by the default
+     * dataset's spending-limit safety net; charged pushes store only the rows that were charged.
+     */
+    dataset?: string | Dataset;
     /**
      * 'row' (default): `charges` for every row. 'batch': once for the whole push, e.g.
      * `pushData(pageRows, { charges: { document: 1 }, chargePer: 'batch' })`: all rows are

package/dist/actor.js

@@ -520,14 +520,41 @@ class Actor {
     async pushData(item, eventNameOrOptions) {
         Actor._ensureActorInit('pushData');
         if (eventNameOrOptions !== undefined && typeof eventNameOrOptions === 'object') {
+            const opts = eventNameOrOptions;
             const { Dataset } = await import('crawlee');
-            const dataset = await Dataset.open();
-            return (0, charging_js_2.pushDataWithCharges)({
+            const dataset = opts.dataset === undefined
+                ? await Dataset.open()
+                : typeof opts.dataset === 'string' ? await Dataset.open(opts.dataset) : opts.dataset;
+            const isDefaultDataset = dataset.id === this.config.get('defaultDatasetId');
+            if (opts.charges !== undefined) {
+                if (opts.eventName !== undefined)
+                    throw new Error('Pass either eventName or charges, not both');
+                return (0, charging_js_2.pushDataWithCharges)({
+                    chargingManager: this.chargingManager,
+                    items: item,
+                    charges: opts.charges,
+                    chargePer: opts.chargePer ?? 'row',
+                    isDefaultDataset,
+                    pushFn: async (rows) => { await dataset.pushData(rows); },
+                });
+            }
+            if (opts.chargePer !== undefined && opts.chargePer !== 'row')
+                throw new Error("chargePer needs charges: {...}");
+            if (isDefaultDataset)
+                return this.pushData(item, opts.eventName);
+            if (opts.eventName === 'apify-default-dataset-item' || opts.eventName === 'scrapely-default-dataset-item') {
+                throw new Error(`Cannot charge for synthetic event '${opts.eventName}' manually`);
+            }
+            if (opts.eventName === undefined) {
+                // A plain push to a named dataset: not gated by the default dataset's safety net.
+                await dataset.pushData(item);
+                return;
+            }
+            return (0, charging_js_1.pushDataAndCharge)({
                 chargingManager: this.chargingManager,
                 items: item,
-                charges: eventNameOrOptions.charges,
-                chargePer: eventNameOrOptions.chargePer ?? 'row',
-                isDefaultDataset: dataset.id === this.config.get('defaultDatasetId'),
+                eventName: opts.eventName,
+                isDefaultDataset: false,
                 pushFn: async (rows) => { await dataset.pushData(rows); },
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "scrapely",
-    "version": "1.2.25",
+    "version": "1.2.26",
     "description": "Scrapely SDK for building JavaScript and TypeScript Actors",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",