feat(actor): adds actor types generation (#1000)

<details>
  <summary>"backlog"</summary>

- [ ] [can optionally be done] language: the language to generate the
types for (currently only TypeScript, but ideally structure the code in
a way where we can easily add in new languages). char: l
- [ ] [optional, nice to have, can be for future work]
[input/output/dataset/key-value-store]-schema: path to a specific schema
to generate types for
- [ ] [don't implement this until we discuss it] add-to-ignore: whether
the cli should add the generated files to files like .prettierignore or
the biome config, default: false.


</details>

### Draft summary
`apify actor generate-schema-types --help`
```
Generate TypeScript types from Actor schemas.

USAGE
  $ actor generate-schema-types [path] [--all-optional] [-o <value>] [--strict]

ARGUMENTS
  path  Optional path to the input schema file. If not provided, searches default locations.

FLAGS
      --all-optional    Mark all properties as optional in generated types.
  -o, --output=<value>  Directory where the generated files should be outputted. Defaults to src/.generated/actor/ to stay within the typical tsconfig rootDir.
      --strict          Whether generated interfaces should be strict (no index signature [key: string]: unknown).

DESCRIPTION
  Generate TypeScript types from Actor schemas.

  Generates types from the input schema and, when no custom path is provided,
  also from the dataset schema defined in '.actor/actor.json' under "storages.dataset".

  Reads the input schema from one of these locations (in priority order):
    1. Object in '.actor/actor.json' under "input" key
    2. JSON file path in '.actor/actor.json' "input" key
    3. .actor/INPUT_SCHEMA.json
    4. INPUT_SCHEMA.json

  Optionally specify custom schema path to use.
```

TO DO:
- [x] [slack-feedback] mention in docs that default output path is `src`
due to tsconfig
- [x] [slack-feedback] `actor generate-schema` ->
`generate-schema-types` to keep consistency with `actor
validate-schema`?
- [x] [slack-feedback] do not export the individual fields, not useful
as you can do Input['field']
- this must be done manually, `json-schema-to-typescript` does not
support this
- [x] [slack-feedback] inline primitive types to make it less verbose
(the comments above inlined fields still display in editor)
- this must be done manually, `json-schema-to-typescript` does not
support this
 - [x] output types 
 - [x] key-value-store types 
- [x] how to resolve unknown[] problem? (_As long as the items: { type:
string } propagates to string[] type, let's just go that way_.)
 
 
 feedback from @B4nan 
          
Must fix
- [x] Verify biome-ignore-all actually works or remove it
- [x] Handle Promise.all failure gracefully — partial success should
still produce output
  Should fix
- [x] Extract schema transform functions to src/lib/schema-transforms.ts
  - [x] Add unit tests for stripTitles 
  - [x] Handle missing JSON Schema keywords in stripTitles 

  Nice to have
- [x] ~~Reduce deep clone overhead~~ lets address this with
#1000 (comment)
  - [x] Deduplicate readOutputSchema logic 
  - [x] Clean up import style, unused defaults

Author: l2ysho

.gitignore

@@ -12,6 +12,7 @@ _mytests
 .idea
 .zed
 docs/changelog.md
+.generated
 
 # Yarn files
 .yarn/install-state.gz

docs/reference.md

@@ -419,22 +419,26 @@ DESCRIPTION
   Manages runtime data operations inside of a running Actor.
 
 SUBCOMMANDS
-  actor set-value         Sets or removes record into the
-                          default key-value store associated with the Actor run.
-  actor push-data         Saves data to Actor's run
-                          default dataset.
-  actor get-value         Gets a value from the default
-                          key-value store associated with the Actor run.
-  actor get-public-url    Get an HTTP URL that allows
-                          public access to a key-value store item.
-  actor get-input         Gets the Actor input value from
-                          the default key-value store associated with the Actor
-                          run.
-  actor charge            Charge for a specific event in
-                          the pay-per-event Actor run.
-  actor calculate-memory  Calculates the Actor’s dynamic
-                          memory usage based on a memory expression from
-                          actor.json, input data, and run options.
+  actor set-value              Sets or removes record
+                               into the default key-value store associated with
+                               the Actor run.
+  actor push-data              Saves data to Actor's
+                               run default dataset.
+  actor get-value              Gets a value from the
+                               default key-value store associated with the Actor
+                               run.
+  actor get-public-url         Get an HTTP URL that
+                               allows public access to a key-value store item.
+  actor get-input              Gets the Actor input
+                               value from the default key-value store associated
+                               with the Actor run.
+  actor charge                 Charge for a specific
+                               event in the pay-per-event Actor run.
+  actor calculate-memory       Calculates the Actor’s
+                               dynamic memory usage based on a memory expression
+                               from actor.json, input data, and run options.
+  actor generate-schema-types  Generate TypeScript
+                               types from Actor schemas.
 ```
 
 ##### `apify actor calculate-memory`
@@ -491,6 +495,42 @@ FLAGS
                                  charging without actually charging
 ```
 
+##### `apify actor generate-schema-types`
+
+```sh
+DESCRIPTION
+  Generate TypeScript types from Actor schemas.
+
+  Generates types from the input schema and, when no custom path is provided,
+  also from the dataset schema defined in '.actor/actor.json' under 
+  "storages.dataset".
+
+  Reads the input schema from one of these locations (in priority order):
+    1. Object in '.actor/actor.json' under "input" key
+    2. JSON file path in '.actor/actor.json' "input" key
+    3. .actor/INPUT_SCHEMA.json
+    4. INPUT_SCHEMA.json
+
+  Optionally specify custom schema path to use.
+
+USAGE
+  $ apify actor generate-schema-types [path]
+                                      [--all-optional] [-o <value>] [--strict]
+
+ARGUMENTS
+  path  Optional path to the input schema file. If not provided, searches
+        default locations.
+
+FLAGS
+      --all-optional    Mark all properties as optional in
+                        generated types.
+  -o, --output=<value>  Directory where the generated files
+                        should be outputted. Defaults to src/.generated/actor/ to
+                        stay within the typical tsconfig rootDir.
+      --strict          Whether generated interfaces should be
+                        strict (no index signature [key: string]: unknown).
+```
+
 ##### `apify actor get-input`
 
 ```sh

package.json

@@ -100,7 +100,7 @@
         "istextorbinary": "~9.5.0",
         "jju": "~1.4.0",
         "js-levenshtein": "^1.1.6",
-        "lodash.clonedeep": "^4.5.0",
+        "json-schema-to-typescript": "^15.0.4",
         "mime": "~4.1.0",
         "open": "~11.0.0",
         "rimraf": "~6.1.0",
@@ -127,7 +127,6 @@
         "@types/express": "^5.0.0",
         "@types/jju": "^1.4.5",
         "@types/js-levenshtein": "^1",
-        "@types/lodash.clonedeep": "^4",
         "@types/mime": "^4.0.0",
         "@types/node": "^24.0.0",
         "@types/semver": "^7.5.8",

scripts/generate-cli-docs.ts

@@ -34,6 +34,7 @@ const categories: Record<string, CommandsInCategory[]> = {
 		{ command: Commands.actor },
 		{ command: Commands.actorCalculateMemory },
 		{ command: Commands.actorCharge },
+		{ command: Commands.actorGenerateSchemaTypes },
 		{ command: Commands.actorGetInput },
 		{ command: Commands.actorGetPublicUrl },
 		{ command: Commands.actorGetValue },

src/commands/_register.ts

@@ -2,6 +2,7 @@ import type { BuiltApifyCommand } from '../lib/command-framework/apify-command.j
 import { ActorIndexCommand } from './actor/_index.js';
 import { ActorCalculateMemoryCommand } from './actor/calculate-memory.js';
 import { ActorChargeCommand } from './actor/charge.js';
+import { ActorGenerateSchemaTypesCommand } from './actor/generate-schema-types.js';
 import { ActorGetInputCommand } from './actor/get-input.js';
 import { ActorGetPublicUrlCommand } from './actor/get-public-url.js';
 import { ActorGetValueCommand } from './actor/get-value.js';
@@ -77,6 +78,7 @@ export const actorCommands = [
 	ActorGetInputCommand,
 	ActorChargeCommand,
 	ActorCalculateMemoryCommand,
+	ActorGenerateSchemaTypesCommand,
 
 	// top-level
 	HelpCommand,

src/commands/actor/_index.ts

@@ -1,6 +1,7 @@
 import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
 import { ActorCalculateMemoryCommand } from './calculate-memory.js';
 import { ActorChargeCommand } from './charge.js';
+import { ActorGenerateSchemaTypesCommand } from './generate-schema-types.js';
 import { ActorGetInputCommand } from './get-input.js';
 import { ActorGetPublicUrlCommand } from './get-public-url.js';
 import { ActorGetValueCommand } from './get-value.js';
@@ -21,6 +22,7 @@ export class ActorIndexCommand extends ApifyCommand<typeof ActorIndexCommand> {
 		ActorGetInputCommand,
 		ActorChargeCommand,
 		ActorCalculateMemoryCommand,
+		ActorGenerateSchemaTypesCommand,
 	];
 
 	async run() {