@apify/actor-utils 0.1.2 → 0.1.3-beta.1

package/dist/src/type-utils/unreachable.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Asserts that a code path is unreachable, enabling exhaustiveness checks.
+ *
+ * Pass a value of type `never` to this function to let the TypeScript compiler
+ * verify that all cases of a union have been handled. If a new variant is added
+ * to the union but not handled, the call becomes a compile-time error. At
+ * runtime, reaching this function throws an `Error`.
+ *
+ * @param x - The value that should be of type `never` at this point.
+ * @throws {Error} Always throws, since this code should never be reached.
+ *
+ * @example
+ * ```ts
+ * type Shape = 'circle' | 'square';
+ *
+ * function area(shape: Shape): number {
+ *     switch (shape) {
+ *         case 'circle':
+ *             return Math.PI;
+ *         case 'square':
+ *             return 1;
+ *         default:
+ *             // Compile-time error here if a new Shape variant is unhandled.
+ *             return unreachable(shape);
+ *     }
+ * }
+ * ```
+ */
+export declare function unreachable(x: never): never;
+//# sourceMappingURL=unreachable.d.ts.map

package/dist/src/type-utils/unreachable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreachable.d.ts","sourceRoot":"","sources":["../../../src/type-utils/unreachable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE3C"}

package/dist/src/type-utils/unreachable.js

@@ -0,0 +1,32 @@
+/**
+ * Asserts that a code path is unreachable, enabling exhaustiveness checks.
+ *
+ * Pass a value of type `never` to this function to let the TypeScript compiler
+ * verify that all cases of a union have been handled. If a new variant is added
+ * to the union but not handled, the call becomes a compile-time error. At
+ * runtime, reaching this function throws an `Error`.
+ *
+ * @param x - The value that should be of type `never` at this point.
+ * @throws {Error} Always throws, since this code should never be reached.
+ *
+ * @example
+ * ```ts
+ * type Shape = 'circle' | 'square';
+ *
+ * function area(shape: Shape): number {
+ *     switch (shape) {
+ *         case 'circle':
+ *             return Math.PI;
+ *         case 'square':
+ *             return 1;
+ *         default:
+ *             // Compile-time error here if a new Shape variant is unhandled.
+ *             return unreachable(shape);
+ *     }
+ * }
+ * ```
+ */
+export function unreachable(x) {
+    throw new Error(`unreachable: ${x}`);
+}
+//# sourceMappingURL=unreachable.js.map

package/dist/src/type-utils/unreachable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreachable.js","sourceRoot":"","sources":["../../../src/type-utils/unreachable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,WAAW,CAAC,CAAQ;IAChC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/package.json

@@ -1,63 +1,74 @@
 {
-    "name": "@apify/actor-utils",
-    "version": "0.1.2",
-    "type": "module",
-    "description": "Wrapper around Actor.pushData that survives dataset schema-validation failures by stripping offending fields and retrying. Callers pass the actual push function as pushFn.",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/apify/apify-actor-utils.git"
+  "name": "@apify/actor-utils",
+  "version": "0.1.3-beta.1",
+  "type": "module",
+  "description": "Wrapper around Actor.pushData that survives dataset schema-validation failures by stripping offending fields and retrying. Callers pass the actual push function as pushFn.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/apify/apify-actor-utils.git"
+  },
+  "engines": {
+    "node": ">=22.6.0"
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
-    "engines": {
-        "node": ">=22.6.0"
+    "./qc-logger": {
+      "types": "./dist/src/qc-logger/index.d.ts",
+      "default": "./dist/src/qc-logger/index.js"
     },
-    "types": "./dist/index.d.ts",
-    "main": "./dist/index.js",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist/index.js",
-        "dist/index.js.map",
-        "dist/index.d.ts",
-        "dist/index.d.ts.map",
-        "dist/src"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "typecheck": "tsc --noEmit",
-        "lint": "eslint",
-        "lint:fix": "eslint --fix",
-        "format": "prettier --write .",
-        "format:check": "prettier --check .",
-        "test": "tsc && node --test dist/test/*.test.js",
-        "check:pushdata": "node scripts/check-pushdata.mjs",
-        "check-unused": "knip",
-        "ci": "npm run typecheck && npm run lint && npm run format:check && npm run check:pushdata && npm test",
-        "probe": "node scripts/probe-errors.mjs",
-        "prepare": "husky .husky || true"
-    },
-    "lint-staged": {
-        "*.js": "eslint",
-        "*.ts": "eslint",
-        "*.mjs": "eslint"
-    },
-    "devDependencies": {
-        "@apify/eslint-config": "^1.2.0",
-        "@apify/tsconfig": "^0.1.2",
-        "@types/node": "^25.9.1",
-        "apify-client": "^2.10.0",
-        "eslint": "^9.39.4",
-        "eslint-config-prettier": "^10.1.8",
-        "globals": "^17.7.0",
-        "husky": "^9.1.7",
-        "knip": "^5.88.1",
-        "lint-staged": "^15.5.2",
-        "prettier": "^3.9.4",
-        "typescript": "^6.0.3",
-        "typescript-eslint": "^8.62.1"
-    },
-    "license": "ISC"
+    "./type-utils": {
+      "types": "./dist/src/type-utils/index.d.ts",
+      "default": "./dist/src/type-utils/index.js"
+    }
+  },
+  "files": [
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/index.d.ts",
+    "dist/index.d.ts.map",
+    "dist/src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "tsc && node --test dist/test/*.test.js",
+    "check:pushdata": "node scripts/check-pushdata.mjs",
+    "check-unused": "knip",
+    "ci": "npm run typecheck && npm run lint && npm run format:check && npm run check:pushdata && npm test",
+    "probe": "node scripts/probe-errors.mjs",
+    "prepare": "husky .husky || true"
+  },
+  "lint-staged": {
+    "*.js": "eslint",
+    "*.ts": "eslint",
+    "*.mjs": "eslint"
+  },
+  "devDependencies": {
+    "@apify/eslint-config": "^1.2.0",
+    "@apify/tsconfig": "^0.1.2",
+    "@types/node": "^25.9.1",
+    "apify-client": "^2.10.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.7.0",
+    "husky": "^9.1.7",
+    "knip": "^5.88.1",
+    "lint-staged": "^15.5.2",
+    "prettier": "^3.9.4",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1"
+  },
+  "license": "ISC",
+  "peerDependencies": {
+    "@apify/log": "^2.5.44"
+  }
 }