primitive-admin 1.2.0-alpha.14 → 1.2.0-alpha.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +102 -78
- package/assets/skill/skills/primitive-platform/SKILL.md +87 -23
- package/dist/bin/primitive.js +11 -82
- package/dist/bin/primitive.js.map +1 -1
- package/dist/src/commands/admins.js +79 -17
- package/dist/src/commands/admins.js.map +1 -1
- package/dist/src/commands/agent-sessions.js +2 -0
- package/dist/src/commands/agent-sessions.js.map +1 -1
- package/dist/src/commands/analytics.js +183 -12
- package/dist/src/commands/analytics.js.map +1 -1
- package/dist/src/commands/apps-children.js +2 -0
- package/dist/src/commands/apps-children.js.map +1 -1
- package/dist/src/commands/apps.js +19 -2
- package/dist/src/commands/apps.js.map +1 -1
- package/dist/src/commands/auth.js +11 -1
- package/dist/src/commands/auth.js.map +1 -1
- package/dist/src/commands/collections.js +13 -0
- package/dist/src/commands/collections.js.map +1 -1
- package/dist/src/commands/config.d.ts +1 -1
- package/dist/src/commands/config.js +40 -9
- package/dist/src/commands/config.js.map +1 -1
- package/dist/src/commands/connections.js +2 -0
- package/dist/src/commands/connections.js.map +1 -1
- package/dist/src/commands/database-type-configs.js +5 -3
- package/dist/src/commands/database-type-configs.js.map +1 -1
- package/dist/src/commands/databases.js +6 -4
- package/dist/src/commands/databases.js.map +1 -1
- package/dist/src/commands/db3-types.js +2 -0
- package/dist/src/commands/db3-types.js.map +1 -1
- package/dist/src/commands/db3.d.ts +12 -0
- package/dist/src/commands/db3.js +343 -24
- package/dist/src/commands/db3.js.map +1 -1
- package/dist/src/commands/documents.d.ts +52 -12
- package/dist/src/commands/documents.js +120 -29
- package/dist/src/commands/documents.js.map +1 -1
- package/dist/src/commands/email-templates.js +72 -0
- package/dist/src/commands/email-templates.js.map +1 -1
- package/dist/src/commands/functions.js +47 -10
- package/dist/src/commands/functions.js.map +1 -1
- package/dist/src/commands/groups.js +18 -3
- package/dist/src/commands/groups.js.map +1 -1
- package/dist/src/commands/init.js +7 -1
- package/dist/src/commands/init.js.map +1 -1
- package/dist/src/commands/integrations.js +80 -47
- package/dist/src/commands/integrations.js.map +1 -1
- package/dist/src/commands/metadata-category-configs.js +2 -0
- package/dist/src/commands/metadata-category-configs.js.map +1 -1
- package/dist/src/commands/metadata.js +41 -0
- package/dist/src/commands/metadata.js.map +1 -1
- package/dist/src/commands/prompts.js +73 -47
- package/dist/src/commands/prompts.js.map +1 -1
- package/dist/src/commands/rule-sets.js +2 -0
- package/dist/src/commands/rule-sets.js.map +1 -1
- package/dist/src/commands/schemas.d.ts +15 -0
- package/dist/src/commands/schemas.js +122 -0
- package/dist/src/commands/schemas.js.map +1 -0
- package/dist/src/commands/secrets.js +45 -3
- package/dist/src/commands/secrets.js.map +1 -1
- package/dist/src/commands/sessions.js +2 -0
- package/dist/src/commands/sessions.js.map +1 -1
- package/dist/src/commands/sync-schemas.d.ts +202 -0
- package/dist/src/commands/sync-schemas.js +629 -0
- package/dist/src/commands/sync-schemas.js.map +1 -0
- package/dist/src/commands/sync-user-properties.d.ts +118 -0
- package/dist/src/commands/sync-user-properties.js +276 -0
- package/dist/src/commands/sync-user-properties.js.map +1 -0
- package/dist/src/commands/sync.d.ts +243 -12
- package/dist/src/commands/sync.js +1474 -314
- package/dist/src/commands/sync.js.map +1 -1
- package/dist/src/commands/user-properties.d.ts +14 -0
- package/dist/src/commands/user-properties.js +79 -0
- package/dist/src/commands/user-properties.js.map +1 -0
- package/dist/src/commands/users.js +879 -16
- package/dist/src/commands/users.js.map +1 -1
- package/dist/src/commands/waitlist.js +39 -4
- package/dist/src/commands/waitlist.js.map +1 -1
- package/dist/src/lib/analytics-query.d.ts +58 -0
- package/dist/src/lib/analytics-query.js +134 -0
- package/dist/src/lib/analytics-query.js.map +1 -0
- package/dist/src/lib/api-client.d.ts +748 -95
- package/dist/src/lib/api-client.js +356 -158
- package/dist/src/lib/api-client.js.map +1 -1
- package/dist/src/lib/block-selector.d.ts +9 -15
- package/dist/src/lib/block-selector.js +9 -20
- package/dist/src/lib/block-selector.js.map +1 -1
- package/dist/src/lib/cli-manifest.d.ts +8 -0
- package/dist/src/lib/cli-manifest.js +10 -1
- package/dist/src/lib/cli-manifest.js.map +1 -1
- package/dist/src/lib/cli-version.d.ts +14 -0
- package/dist/src/lib/cli-version.js +38 -0
- package/dist/src/lib/cli-version.js.map +1 -0
- package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
- package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
- package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
- package/dist/src/lib/command-status.d.ts +110 -0
- package/dist/src/lib/command-status.js +184 -0
- package/dist/src/lib/command-status.js.map +1 -0
- package/dist/src/lib/config-object-descriptor.d.ts +6 -0
- package/dist/src/lib/config-object-descriptor.js +71 -0
- package/dist/src/lib/config-object-descriptor.js.map +1 -1
- package/dist/src/lib/config-toml.d.ts +11 -2
- package/dist/src/lib/config-toml.js +25 -2
- package/dist/src/lib/config-toml.js.map +1 -1
- package/dist/src/lib/data-input.d.ts +1 -1
- package/dist/src/lib/data-input.js +1 -1
- package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
- package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
- package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
- package/dist/src/lib/db-codegen/dbTypeIR.d.ts +11 -1
- package/dist/src/lib/db-codegen/dbTypeIR.js +11 -5
- package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
- package/dist/src/lib/db-type-records.d.ts +95 -0
- package/dist/src/lib/db-type-records.js +219 -0
- package/dist/src/lib/db-type-records.js.map +1 -0
- package/dist/src/lib/db3-export.d.ts +51 -14
- package/dist/src/lib/db3-export.js +135 -27
- package/dist/src/lib/db3-export.js.map +1 -1
- package/dist/src/lib/db3-index-output.d.ts +68 -3
- package/dist/src/lib/db3-index-output.js +139 -3
- package/dist/src/lib/db3-index-output.js.map +1 -1
- package/dist/src/lib/db3-type-models.d.ts +39 -7
- package/dist/src/lib/db3-type-models.js +138 -27
- package/dist/src/lib/db3-type-models.js.map +1 -1
- package/dist/src/lib/deprecation.d.ts +2 -2
- package/dist/src/lib/deprecation.js +2 -2
- package/dist/src/lib/experimental-apis.d.ts +36 -0
- package/dist/src/lib/experimental-apis.js +46 -0
- package/dist/src/lib/experimental-apis.js.map +1 -0
- package/dist/src/lib/file-attachment.d.ts +24 -0
- package/dist/src/lib/file-attachment.js +31 -0
- package/dist/src/lib/file-attachment.js.map +1 -0
- package/dist/src/lib/function-authorize-check.d.ts +1 -1
- package/dist/src/lib/function-authorize-check.js +2 -1
- package/dist/src/lib/function-authorize-check.js.map +1 -1
- package/dist/src/lib/function-authorize-view.js +4 -0
- package/dist/src/lib/function-authorize-view.js.map +1 -1
- package/dist/src/lib/function-bundle.d.ts +27 -5
- package/dist/src/lib/function-bundle.js +106 -7
- package/dist/src/lib/function-bundle.js.map +1 -1
- package/dist/src/lib/function-collect.d.ts +2 -0
- package/dist/src/lib/function-collect.js +36 -7
- package/dist/src/lib/function-collect.js.map +1 -1
- package/dist/src/lib/function-db-types.d.ts +57 -40
- package/dist/src/lib/function-db-types.js +246 -285
- package/dist/src/lib/function-db-types.js.map +1 -1
- package/dist/src/lib/function-document-types.d.ts +19 -7
- package/dist/src/lib/function-document-types.js +24 -12
- package/dist/src/lib/function-document-types.js.map +1 -1
- package/dist/src/lib/function-run.d.ts +1 -1
- package/dist/src/lib/function-run.js +1 -1
- package/dist/src/lib/function-run.js.map +1 -1
- package/dist/src/lib/function-schema-codegen.d.ts +58 -18
- package/dist/src/lib/function-schema-codegen.js +85 -74
- package/dist/src/lib/function-schema-codegen.js.map +1 -1
- package/dist/src/lib/function-schema-refs.d.ts +98 -0
- package/dist/src/lib/function-schema-refs.js +177 -0
- package/dist/src/lib/function-schema-refs.js.map +1 -0
- package/dist/src/lib/function-sync.d.ts +38 -4
- package/dist/src/lib/function-sync.js +83 -14
- package/dist/src/lib/function-sync.js.map +1 -1
- package/dist/src/lib/function-typecheck.d.ts +52 -0
- package/dist/src/lib/function-typecheck.js +171 -54
- package/dist/src/lib/function-typecheck.js.map +1 -1
- package/dist/src/lib/generated-build-flags.d.ts +13 -0
- package/dist/src/lib/generated-build-flags.js +14 -0
- package/dist/src/lib/generated-build-flags.js.map +1 -0
- package/dist/src/lib/generated-config-surfaces.d.ts +211 -11
- package/dist/src/lib/generated-config-surfaces.js +579 -69
- package/dist/src/lib/generated-config-surfaces.js.map +1 -1
- package/dist/src/lib/generated-sdk-types.d.ts +1 -1
- package/dist/src/lib/generated-sdk-types.js +1 -1
- package/dist/src/lib/generated-sdk-types.js.map +1 -1
- package/dist/src/lib/integration-test-request.d.ts +54 -0
- package/dist/src/lib/integration-test-request.js +207 -0
- package/dist/src/lib/integration-test-request.js.map +1 -0
- package/dist/src/lib/metadata-report.d.ts +85 -0
- package/dist/src/lib/metadata-report.js +81 -0
- package/dist/src/lib/metadata-report.js.map +1 -0
- package/dist/src/lib/output.d.ts +1 -1
- package/dist/src/lib/output.js +1 -1
- package/dist/src/lib/platform-owned.js +5 -0
- package/dist/src/lib/platform-owned.js.map +1 -1
- package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
- package/dist/src/lib/primitive-declaration-names.js +22 -0
- package/dist/src/lib/primitive-declaration-names.js.map +1 -0
- package/dist/src/lib/primitive-declaration.d.ts +143 -0
- package/dist/src/lib/primitive-declaration.js +658 -0
- package/dist/src/lib/primitive-declaration.js.map +1 -0
- package/dist/src/lib/prompt-schema-codegen.d.ts +36 -12
- package/dist/src/lib/prompt-schema-codegen.js +82 -98
- package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
- package/dist/src/lib/prompt-schema-document.d.ts +35 -0
- package/dist/src/lib/prompt-schema-document.js +92 -0
- package/dist/src/lib/prompt-schema-document.js.map +1 -0
- package/dist/src/lib/prompt-schema-refs.d.ts +164 -0
- package/dist/src/lib/prompt-schema-refs.js +452 -0
- package/dist/src/lib/prompt-schema-refs.js.map +1 -0
- package/dist/src/lib/records-verbs.d.ts +12 -2
- package/dist/src/lib/records-verbs.js +7 -2
- package/dist/src/lib/records-verbs.js.map +1 -1
- package/dist/src/lib/register-commands.d.ts +28 -0
- package/dist/src/lib/register-commands.js +101 -0
- package/dist/src/lib/register-commands.js.map +1 -0
- package/dist/src/lib/retired-imports.d.ts +53 -0
- package/dist/src/lib/retired-imports.js +120 -0
- package/dist/src/lib/retired-imports.js.map +1 -0
- package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
- package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
- package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.js +221 -0
- package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
- package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +209 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js +379 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
- package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
- package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
- package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +129 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +154 -1
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -1
- package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
- package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
- package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
- package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
- package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
- package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
- package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
- package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
- package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
- package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
- package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
- package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
- package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
- package/dist/src/lib/schema-codegen/schemaToTs.d.ts +40 -13
- package/dist/src/lib/schema-codegen/schemaToTs.js +124 -160
- package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -1
- package/dist/src/lib/schema-codegen/valuesLists.d.ts +35 -0
- package/dist/src/lib/schema-codegen/valuesLists.js +128 -0
- package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
- package/dist/src/lib/schema-family-index.d.ts +228 -0
- package/dist/src/lib/schema-family-index.js +813 -0
- package/dist/src/lib/schema-family-index.js.map +1 -0
- package/dist/src/lib/schema-pins.d.ts +82 -0
- package/dist/src/lib/schema-pins.js +198 -0
- package/dist/src/lib/schema-pins.js.map +1 -0
- package/dist/src/lib/schema-preview.d.ts +244 -0
- package/dist/src/lib/schema-preview.js +498 -0
- package/dist/src/lib/schema-preview.js.map +1 -0
- package/dist/src/lib/skill-installer.d.ts +2 -2
- package/dist/src/lib/skill-installer.js +2 -21
- package/dist/src/lib/skill-installer.js.map +1 -1
- package/dist/src/lib/step-run-table.d.ts +1 -2
- package/dist/src/lib/step-run-table.js +1 -2
- package/dist/src/lib/step-run-table.js.map +1 -1
- package/dist/src/lib/swift-codegen/agentGenerator.d.ts +2 -1
- package/dist/src/lib/swift-codegen/agentGenerator.js +24 -22
- package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
- package/dist/src/lib/swift-codegen/banners.js +12 -0
- package/dist/src/lib/swift-codegen/banners.js.map +1 -1
- package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
- package/dist/src/lib/swift-codegen/functionGenerator.js +167 -50
- package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +31 -7
- package/dist/src/lib/swift-codegen/schemaToSwift.js +213 -177
- package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
- package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +45 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js +120 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
- package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
- package/dist/src/lib/sync-resource-types.d.ts +37 -5
- package/dist/src/lib/sync-resource-types.js +53 -5
- package/dist/src/lib/sync-resource-types.js.map +1 -1
- package/dist/src/lib/sync-selectors.d.ts +7 -0
- package/dist/src/lib/sync-selectors.js +22 -2
- package/dist/src/lib/sync-selectors.js.map +1 -1
- package/dist/src/lib/test-runs.d.ts +45 -0
- package/dist/src/lib/test-runs.js +150 -0
- package/dist/src/lib/test-runs.js.map +1 -0
- package/dist/src/lib/toml-database-config.d.ts +2 -1
- package/dist/src/lib/toml-database-config.js +4 -3
- package/dist/src/lib/toml-database-config.js.map +1 -1
- package/dist/src/lib/toml-scalar-edit.js +6 -4
- package/dist/src/lib/toml-scalar-edit.js.map +1 -1
- package/dist/src/lib/user-index.d.ts +80 -0
- package/dist/src/lib/user-index.js +166 -0
- package/dist/src/lib/user-index.js.map +1 -0
- package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
- package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
- package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
- package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
- package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
- package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
- package/dist/src/lib/user-walk.d.ts +31 -0
- package/dist/src/lib/user-walk.js +102 -0
- package/dist/src/lib/user-walk.js.map +1 -0
- package/dist/src/lib/worker-perf-format.d.ts +22 -0
- package/dist/src/lib/worker-perf-format.js +27 -0
- package/dist/src/lib/worker-perf-format.js.map +1 -0
- package/dist/src/types/index.d.ts +13 -34
- package/package.json +5 -3
|
@@ -0,0 +1,475 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GENERATED FILE — DO NOT EDIT BY HAND.
|
|
3
|
+
*
|
|
4
|
+
* Vendored from the canonical server module
|
|
5
|
+
* `src/function-runs/schema-file.ts` — the SAME interpretation the server
|
|
6
|
+
* applies to a function's schemas. The CLI cannot import server `src/`
|
|
7
|
+
* at runtime, so the CLI imports this committed copy instead.
|
|
8
|
+
*
|
|
9
|
+
* Regenerate with:
|
|
10
|
+
* node cli/scripts/gen-schema-descriptor.mjs (runs at CLI prebuild)
|
|
11
|
+
*
|
|
12
|
+
* A CI freshness guard
|
|
13
|
+
* (`cli/scripts/gen-schema-descriptor.mjs --check`, also asserted by
|
|
14
|
+
* `cli/tests/unit/schema-codegen-descriptor-drift-guard.test.ts`) fails if
|
|
15
|
+
* this committed copy does not match the source — see issue #1442 / #998.
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* Shared shapes: a `schemas/<file>.toml` file and its compile.
|
|
19
|
+
*
|
|
20
|
+
* An app declares shapes once, in any number of `primitive/<env>/schemas/`
|
|
21
|
+
* files, each a set of `[defs.<Name>]` tables in the platform's JSON-Schema
|
|
22
|
+
* dialect:
|
|
23
|
+
*
|
|
24
|
+
* [defs.Currency]
|
|
25
|
+
* type = "string"
|
|
26
|
+
* pattern = "^[A-Z]{3}$"
|
|
27
|
+
*
|
|
28
|
+
* [defs.Money]
|
|
29
|
+
* type = "object"
|
|
30
|
+
* [defs.Money.properties.currency]
|
|
31
|
+
* "$ref" = "#/$defs/Currency"
|
|
32
|
+
*
|
|
33
|
+
* Each def is a schema document whose `#/$defs/<Name>` refs name the file's
|
|
34
|
+
* other defs. `compileSchemaFile` compiles each def as a root document that
|
|
35
|
+
* carries only the defs reachable from it, through the same compiler a
|
|
36
|
+
* function schema runs (`compileSchemaRefs`), so a sibling ref inlines, the
|
|
37
|
+
* root `$defs` is dropped once nothing points into it, and a ref that cannot
|
|
38
|
+
* resolve retains nothing but the defs it could have reached. A def may not
|
|
39
|
+
* declare its own root `$defs`: its shared shapes go in the file's `[defs]`.
|
|
40
|
+
*
|
|
41
|
+
* Given a family index (#5533), a def may also ref a def of another file,
|
|
42
|
+
* `"$ref" = "schemas:<file>#/$defs/<Name>"` or `ref = "<file>.<Name>"` and the
|
|
43
|
+
* other forms the ref compiler takes, and the def's compiled form is inlined.
|
|
44
|
+
* A db3 ref in a def must name its projection (`#row` or `#declared`, #5540),
|
|
45
|
+
* because a def is used in input and output positions alike.
|
|
46
|
+
* A family-spelled ref to the file's own def resolves locally, but a cycle
|
|
47
|
+
* through one is refused (`SCHEMA_REF_CYCLE`); a cycle written only with
|
|
48
|
+
* `#/$defs/` refs stays inert.
|
|
49
|
+
*
|
|
50
|
+
* A def may also be written as a field table (#5541), `[defs.Money.fields.amount]`:
|
|
51
|
+
* a def whose root carries a field-table marker key is compiled to the
|
|
52
|
+
* dialect first (`expandSchemaFileFieldTables`), so a raw and a pre-expanded
|
|
53
|
+
* document compile alike.
|
|
54
|
+
*
|
|
55
|
+
* Pure and deterministic, importing only the keyword table, the ref compiler,
|
|
56
|
+
* the field table and the provenance module, so the CLI vendors it
|
|
57
|
+
* (`cli/scripts/gen-schema-descriptor.mjs`) and the push preflight, the push
|
|
58
|
+
* body and the server's recompile all read one compile.
|
|
59
|
+
*/
|
|
60
|
+
import { refusedSchemaKeywords } from "./generated-schema-descriptor.js";
|
|
61
|
+
import { FUNCTION_SCHEMA_REF_AMBIGUOUS, FUNCTION_SCHEMA_REF_RESERVED, FUNCTION_SCHEMA_REF_TOMBSTONED, FUNCTION_SCHEMA_REF_UNRESOLVED, classifySchemaRefs, compileSchemaRefs, schemaFamilyRefsIn, } from "./generated-schema-refs.js";
|
|
62
|
+
import { SCHEMA_CANONICAL_INVALID, canonicalJson, schemaProvenanceOf } from "./generated-schema-provenance.js";
|
|
63
|
+
import { expandSchemaFileFieldTables } from "./generated-field-table.js";
|
|
64
|
+
/** What a file stem may be: lowercase letters, digits, `_` and `-`, at most 64 characters. */
|
|
65
|
+
export const SCHEMA_FILE_STEM = /^[a-z0-9_-]{1,64}$/;
|
|
66
|
+
/** What a def name may be: an identifier. */
|
|
67
|
+
export const SCHEMA_DEF_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
68
|
+
/** The longest def name, in characters. */
|
|
69
|
+
export const SCHEMA_DEF_NAME_MAX_LENGTH = 64;
|
|
70
|
+
/** The most defs one file may declare. */
|
|
71
|
+
export const SCHEMA_FILE_MAX_DEFS = 256;
|
|
72
|
+
/** The largest file source a push takes, in bytes (1 MiB). */
|
|
73
|
+
export const SCHEMA_FILE_MAX_BYTES = 1024 * 1024;
|
|
74
|
+
/** The most bytes a file's defs may compile to together (1 MiB). */
|
|
75
|
+
export const SCHEMA_FILE_COMPILED_MAX_BYTES = 1024 * 1024;
|
|
76
|
+
/** The largest `source` or `compiled` a stored version keeps inline; past it the field is stored as an object (150 KiB). */
|
|
77
|
+
export const SCHEMA_INLINE_LIMIT_BYTES = 150 * 1024;
|
|
78
|
+
/** The file code for each ref compiler refusal a shared ref raises. */
|
|
79
|
+
const SHARED_REF_FILE_CODES = {
|
|
80
|
+
[FUNCTION_SCHEMA_REF_UNRESOLVED]: "SCHEMA_REF_UNRESOLVED",
|
|
81
|
+
[FUNCTION_SCHEMA_REF_AMBIGUOUS]: "SCHEMA_REF_AMBIGUOUS",
|
|
82
|
+
[FUNCTION_SCHEMA_REF_TOMBSTONED]: "SCHEMA_REF_TOMBSTONED",
|
|
83
|
+
[FUNCTION_SCHEMA_REF_RESERVED]: "SCHEMA_REF_RESERVED",
|
|
84
|
+
[SCHEMA_CANONICAL_INVALID]: "SCHEMA_CANONICAL_INVALID",
|
|
85
|
+
};
|
|
86
|
+
/** Is `value` a valid file stem? */
|
|
87
|
+
export function isSchemaFileStem(value) {
|
|
88
|
+
return typeof value === "string" && SCHEMA_FILE_STEM.test(value);
|
|
89
|
+
}
|
|
90
|
+
function isPlainObject(value) {
|
|
91
|
+
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
92
|
+
}
|
|
93
|
+
function hasOwn(value, key) {
|
|
94
|
+
return Object.prototype.hasOwnProperty.call(value, key);
|
|
95
|
+
}
|
|
96
|
+
/** Set `key` as an own data property, so a def named `__proto__` stays a def. */
|
|
97
|
+
function setOwn(target, key, value) {
|
|
98
|
+
Object.defineProperty(target, key, { value, enumerable: true, writable: true, configurable: true });
|
|
99
|
+
}
|
|
100
|
+
function utf8Length(text) {
|
|
101
|
+
return new TextEncoder().encode(text).length;
|
|
102
|
+
}
|
|
103
|
+
function refused(code, path, message, details) {
|
|
104
|
+
return { ok: false, refusal: { code, path, message, ...(details ? { details } : {}) } };
|
|
105
|
+
}
|
|
106
|
+
/** The def a `#/$defs/<Name>[/…]` ref names and the pointer segments below it, or null for any other ref. */
|
|
107
|
+
function localDefTarget(ref) {
|
|
108
|
+
if (!ref.startsWith("#/$defs/"))
|
|
109
|
+
return null;
|
|
110
|
+
const [name, ...below] = ref
|
|
111
|
+
.slice("#/$defs/".length)
|
|
112
|
+
.split("/")
|
|
113
|
+
.map((segment) => segment.replace(/~1/g, "/").replace(/~0/g, "~"));
|
|
114
|
+
return { name, below };
|
|
115
|
+
}
|
|
116
|
+
/** The node `segments` point at below `node`, or undefined when the pointer has no target. */
|
|
117
|
+
function nodeAt(node, segments) {
|
|
118
|
+
let current = node;
|
|
119
|
+
for (const segment of segments) {
|
|
120
|
+
if (Array.isArray(current) && /^(0|[1-9][0-9]*)$/.test(segment))
|
|
121
|
+
current = current[Number(segment)];
|
|
122
|
+
else if (isPlainObject(current) && hasOwn(current, segment))
|
|
123
|
+
current = current[segment];
|
|
124
|
+
else
|
|
125
|
+
return undefined;
|
|
126
|
+
}
|
|
127
|
+
return current;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* The defs a def's compile needs: the transitive closure of the file's defs
|
|
131
|
+
* over `#/$defs/<Name>[/…]` refs, starting from `name` itself (included only
|
|
132
|
+
* when something in the closure refs it), in file order. A ref to a node below
|
|
133
|
+
* a def follows that node too, so the refs it carries reach their defs even
|
|
134
|
+
* when it sits where the def's own scan does not look.
|
|
135
|
+
*/
|
|
136
|
+
export function schemaFileReachableDefs(defs, name) {
|
|
137
|
+
const reached = new Set();
|
|
138
|
+
const scanned = new Set();
|
|
139
|
+
const queue = hasOwn(defs, name) ? [defs[name]] : [];
|
|
140
|
+
while (queue.length > 0) {
|
|
141
|
+
const node = queue.shift();
|
|
142
|
+
if (scanned.has(node))
|
|
143
|
+
continue;
|
|
144
|
+
scanned.add(node);
|
|
145
|
+
for (const { ref } of classifySchemaRefs(node)) {
|
|
146
|
+
const target = localDefTarget(ref);
|
|
147
|
+
if (target === null || !hasOwn(defs, target.name))
|
|
148
|
+
continue;
|
|
149
|
+
if (!reached.has(target.name)) {
|
|
150
|
+
reached.add(target.name);
|
|
151
|
+
queue.push(defs[target.name]);
|
|
152
|
+
}
|
|
153
|
+
if (target.below.length > 0) {
|
|
154
|
+
const pointed = nodeAt(defs[target.name], target.below);
|
|
155
|
+
if (isPlainObject(pointed))
|
|
156
|
+
queue.push(pointed);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return Object.keys(defs).filter((def) => reached.has(def));
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* The first keyword the function push would refuse at or below `node`, over
|
|
164
|
+
* the nodes that push checks: the root, `properties`, `items`, `anyOf` and
|
|
165
|
+
* `oneOf`. A schema-valued `additionalProperties` is refused as it is there.
|
|
166
|
+
*/
|
|
167
|
+
function refusedKeywordIn(node, path) {
|
|
168
|
+
const stack = [{ node, path }];
|
|
169
|
+
while (stack.length > 0) {
|
|
170
|
+
const { node: current, path: at } = stack.pop();
|
|
171
|
+
if (!isPlainObject(current))
|
|
172
|
+
continue;
|
|
173
|
+
for (const keyword of refusedSchemaKeywords()) {
|
|
174
|
+
if (hasOwn(current, keyword))
|
|
175
|
+
return { path: at, keyword };
|
|
176
|
+
}
|
|
177
|
+
if (current.additionalProperties !== undefined && typeof current.additionalProperties !== "boolean") {
|
|
178
|
+
return { path: at, keyword: "additionalProperties" };
|
|
179
|
+
}
|
|
180
|
+
// Last pushed is checked first, so children are checked in document order.
|
|
181
|
+
const children = [];
|
|
182
|
+
if (isPlainObject(current.properties)) {
|
|
183
|
+
for (const [name, child] of Object.entries(current.properties))
|
|
184
|
+
children.push({ node: child, path: `${at}.properties.${name}` });
|
|
185
|
+
}
|
|
186
|
+
if (isPlainObject(current.items))
|
|
187
|
+
children.push({ node: current.items, path: `${at}.items` });
|
|
188
|
+
for (const keyword of ["anyOf", "oneOf"]) {
|
|
189
|
+
if (Array.isArray(current[keyword]))
|
|
190
|
+
current[keyword].forEach((child, index) => children.push({ node: child, path: `${at}.${keyword}[${index}]` }));
|
|
191
|
+
}
|
|
192
|
+
for (let index = children.length - 1; index >= 0; index--)
|
|
193
|
+
stack.push(children[index]);
|
|
194
|
+
}
|
|
195
|
+
return null;
|
|
196
|
+
}
|
|
197
|
+
/** The shape refusal for a parsed file, or null when its shape is one the compile takes. */
|
|
198
|
+
function shapeRefusal(document) {
|
|
199
|
+
if (!isPlainObject(document))
|
|
200
|
+
return refused("SCHEMA_FILE_INVALID", "", "A schemas/ file must be a table of [defs.<Name>] tables.");
|
|
201
|
+
for (const key of Object.keys(document)) {
|
|
202
|
+
if (key !== "defs")
|
|
203
|
+
return refused("SCHEMA_FILE_INVALID", key, `Unknown root key ${JSON.stringify(key)}: a schemas/ file holds only [defs.<Name>] tables.`);
|
|
204
|
+
}
|
|
205
|
+
const defs = document.defs;
|
|
206
|
+
if (!isPlainObject(defs) || Object.keys(defs).length === 0) {
|
|
207
|
+
return refused("SCHEMA_FILE_INVALID", "defs", "A schemas/ file must declare at least one [defs.<Name>] table.");
|
|
208
|
+
}
|
|
209
|
+
const names = Object.keys(defs);
|
|
210
|
+
if (names.length > SCHEMA_FILE_MAX_DEFS) {
|
|
211
|
+
return refused("SCHEMA_FILE_INVALID", "defs", `A schemas/ file may declare at most ${SCHEMA_FILE_MAX_DEFS} defs; this one declares ${names.length}. Split it into more files.`);
|
|
212
|
+
}
|
|
213
|
+
for (const name of names) {
|
|
214
|
+
const path = `defs.${name}`;
|
|
215
|
+
if (!SCHEMA_DEF_NAME.test(name)) {
|
|
216
|
+
return refused("SCHEMA_FILE_INVALID", path, `Def name ${JSON.stringify(name)} must be an identifier: a letter or _, then letters, digits or _.`);
|
|
217
|
+
}
|
|
218
|
+
if (name.length > SCHEMA_DEF_NAME_MAX_LENGTH) {
|
|
219
|
+
return refused("SCHEMA_FILE_INVALID", path, `Def name ${JSON.stringify(name)} is ${name.length} characters; at most ${SCHEMA_DEF_NAME_MAX_LENGTH} are allowed.`);
|
|
220
|
+
}
|
|
221
|
+
const def = defs[name];
|
|
222
|
+
if (!isPlainObject(def))
|
|
223
|
+
return refused("SCHEMA_FILE_INVALID", path, `${path} must be a table: one JSON Schema document.`);
|
|
224
|
+
if (hasOwn(def, "$defs")) {
|
|
225
|
+
return refused("SCHEMA_FILE_INVALID", `${path}.$defs`, "A def may not declare its own $defs: a def's shared shapes go in the file's `[defs]`; `#/$defs/<Other>` inside a def resolves against them.");
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
return null;
|
|
229
|
+
}
|
|
230
|
+
/**
|
|
231
|
+
* The order a family-indexed compile takes the defs in, or the cycle that
|
|
232
|
+
* stops it. A def is compiled after every def of its own file that its
|
|
233
|
+
* compile inlines through a family-spelled ref (in it, or in a def it reaches
|
|
234
|
+
* through `#/$defs/` refs), because that ref inlines the compiled def. A
|
|
235
|
+
* cycle through any family-spelled edge is refused: a family-spelled ref
|
|
236
|
+
* resolves, so the expansion would never end.
|
|
237
|
+
*/
|
|
238
|
+
function familyDefOrder(defs, names, file, index) {
|
|
239
|
+
const own = new Set(names);
|
|
240
|
+
const sharedEdges = new Map();
|
|
241
|
+
const localEdges = new Map();
|
|
242
|
+
for (const name of names) {
|
|
243
|
+
sharedEdges.set(name, [...new Set(schemaFamilyRefsIn(defs[name], index).edges.filter((edge) => edge.file === file && own.has(edge.def)).map((edge) => edge.def))]);
|
|
244
|
+
const local = [];
|
|
245
|
+
for (const { ref } of classifySchemaRefs(defs[name])) {
|
|
246
|
+
const target = localDefTarget(ref);
|
|
247
|
+
if (target && own.has(target.name) && !local.includes(target.name))
|
|
248
|
+
local.push(target.name);
|
|
249
|
+
}
|
|
250
|
+
localEdges.set(name, local);
|
|
251
|
+
}
|
|
252
|
+
// A cycle with a family-spelled edge from → to: a path from `to` back to `from` over every edge.
|
|
253
|
+
for (const from of names) {
|
|
254
|
+
for (const to of sharedEdges.get(from)) {
|
|
255
|
+
const previous = new Map([[to, ""]]);
|
|
256
|
+
const queue = [to];
|
|
257
|
+
while (queue.length > 0 && !previous.has(`\u0000${from}`)) {
|
|
258
|
+
const at = queue.shift();
|
|
259
|
+
for (const next of [...localEdges.get(at), ...sharedEdges.get(at)]) {
|
|
260
|
+
if (next === from) {
|
|
261
|
+
previous.set(`\u0000${from}`, at);
|
|
262
|
+
break;
|
|
263
|
+
}
|
|
264
|
+
if (!previous.has(next)) {
|
|
265
|
+
previous.set(next, at);
|
|
266
|
+
queue.push(next);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
if (to === from || previous.has(`\u0000${from}`)) {
|
|
271
|
+
const path = [from];
|
|
272
|
+
if (to !== from) {
|
|
273
|
+
const back = [];
|
|
274
|
+
for (let at = previous.get(`\u0000${from}`); at !== ""; at = previous.get(at))
|
|
275
|
+
back.push(at);
|
|
276
|
+
path.push(...back.reverse());
|
|
277
|
+
}
|
|
278
|
+
path.push(from);
|
|
279
|
+
return { cycle: path };
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
const deps = new Map();
|
|
284
|
+
for (const name of names) {
|
|
285
|
+
const reached = [name, ...schemaFileReachableDefs(defs, name)];
|
|
286
|
+
deps.set(name, [...new Set(reached.flatMap((def) => sharedEdges.get(def)))]);
|
|
287
|
+
}
|
|
288
|
+
const order = [];
|
|
289
|
+
const done = new Set();
|
|
290
|
+
for (const root of names) {
|
|
291
|
+
const stack = [{ name: root, next: 0 }];
|
|
292
|
+
while (stack.length > 0) {
|
|
293
|
+
const frame = stack[stack.length - 1];
|
|
294
|
+
if (done.has(frame.name)) {
|
|
295
|
+
stack.pop();
|
|
296
|
+
continue;
|
|
297
|
+
}
|
|
298
|
+
const targets = deps.get(frame.name);
|
|
299
|
+
if (frame.next < targets.length) {
|
|
300
|
+
const target = targets[frame.next++];
|
|
301
|
+
if (!done.has(target) && !stack.some((open) => open.name === target))
|
|
302
|
+
stack.push({ name: target, next: 0 });
|
|
303
|
+
continue;
|
|
304
|
+
}
|
|
305
|
+
done.add(frame.name);
|
|
306
|
+
order.push(frame.name);
|
|
307
|
+
stack.pop();
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
return { order };
|
|
311
|
+
}
|
|
312
|
+
/**
|
|
313
|
+
* Compile a parsed `schemas/` file: check its shape and keywords, then
|
|
314
|
+
* compile each def as `{ ...def, $defs: <reachable defs> }`. The compiled
|
|
315
|
+
* defs are counted as they are built, and the file is refused at the def
|
|
316
|
+
* whose compile takes the total past `SCHEMA_FILE_COMPILED_MAX_BYTES`.
|
|
317
|
+
*
|
|
318
|
+
* With `options.families`, a def's refs to other files' defs resolve through
|
|
319
|
+
* the index, its family-spelled refs to the file's own defs resolve locally
|
|
320
|
+
* (those defs are compiled first), and each def's `resolved` carries what its
|
|
321
|
+
* provenance hashes (`schemaFileProvenanceOf`).
|
|
322
|
+
*
|
|
323
|
+
* @example
|
|
324
|
+
* compileSchemaFile({ defs: { Currency: { type: "string" }, Price: { $ref: "#/$defs/Currency" } } });
|
|
325
|
+
* // → { ok: true, names: ["Currency", "Price"], defs: { Currency: { type: "string" }, Price: { type: "string" } }, … }
|
|
326
|
+
*/
|
|
327
|
+
export function compileSchemaFile(document, options = {}) {
|
|
328
|
+
const shape = shapeRefusal(document);
|
|
329
|
+
if (shape)
|
|
330
|
+
return shape;
|
|
331
|
+
const expanded = expandSchemaFileFieldTables(document);
|
|
332
|
+
if (expanded.problems.length > 0) {
|
|
333
|
+
const [first] = expanded.problems;
|
|
334
|
+
return refused("SCHEMA_FILE_INVALID", first.path, `${first.path}: ${first.message}`, { problems: expanded.problems });
|
|
335
|
+
}
|
|
336
|
+
const defs = expanded.document.defs;
|
|
337
|
+
const names = Object.keys(defs);
|
|
338
|
+
for (const name of names) {
|
|
339
|
+
const found = refusedKeywordIn(defs[name], `defs.${name}`);
|
|
340
|
+
if (found) {
|
|
341
|
+
return refused("SCHEMA_DEF_KEYWORD_REFUSED", found.path, `${found.path}.${found.keyword} is not supported: the schema check would not enforce it. Express the bound with a supported keyword.`, { def: name, path: found.path, keyword: found.keyword });
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
const compiled = {};
|
|
345
|
+
const warningsByDef = new Map();
|
|
346
|
+
const resolved = {};
|
|
347
|
+
let families;
|
|
348
|
+
let order = names;
|
|
349
|
+
if (options.families) {
|
|
350
|
+
const file = options.file;
|
|
351
|
+
if (!file)
|
|
352
|
+
throw new Error("compileSchemaFile needs the file's own stem (options.file) with a family index");
|
|
353
|
+
// The file itself, as its own defs compile: a family-spelled ref to one
|
|
354
|
+
// of them inlines it once it is compiled, with no read of the index.
|
|
355
|
+
const self = { names, defs: compiled, resolved };
|
|
356
|
+
const files = new Map(options.families.files);
|
|
357
|
+
files.set(file, self);
|
|
358
|
+
families = { files, ...(options.families.keys ? { keys: options.families.keys } : {}), ...(options.families.db3 ? { db3: options.families.db3 } : {}) };
|
|
359
|
+
const planned = familyDefOrder(defs, names, file, families);
|
|
360
|
+
if ("cycle" in planned) {
|
|
361
|
+
const chain = planned.cycle.map((def) => `schemas:${file}#/$defs/${pointerSegment(def)}`);
|
|
362
|
+
return refused("SCHEMA_REF_CYCLE", `defs.${planned.cycle[0]}`, `defs.${planned.cycle[0]}: a cycle through a family-spelled ref: ${chain.join(" → ")}. ` +
|
|
363
|
+
"A schemas: or ref spelling always resolves, so the expansion would never end (a cycle written only with #/$defs/ refs stays inert). " +
|
|
364
|
+
"Break the cycle, or write the inner ref as \"#/$defs/<Name>\".", { def: planned.cycle[0], chain });
|
|
365
|
+
}
|
|
366
|
+
order = planned.order;
|
|
367
|
+
}
|
|
368
|
+
let compiledBytes = 0;
|
|
369
|
+
for (const name of order) {
|
|
370
|
+
const wrapper = {};
|
|
371
|
+
for (const [key, value] of Object.entries(defs[name]))
|
|
372
|
+
setOwn(wrapper, key, value);
|
|
373
|
+
const reachable = schemaFileReachableDefs(defs, name);
|
|
374
|
+
if (reachable.length > 0) {
|
|
375
|
+
const attached = {};
|
|
376
|
+
for (const def of reachable)
|
|
377
|
+
setOwn(attached, def, defs[def]);
|
|
378
|
+
setOwn(wrapper, "$defs", attached);
|
|
379
|
+
}
|
|
380
|
+
const field = `defs.${name}`;
|
|
381
|
+
// A def has no position of its own (#5540): a db3 ref in it names its projection.
|
|
382
|
+
const result = compileSchemaRefs(wrapper, { field, position: "definition", ...(families ? { families } : {}) });
|
|
383
|
+
if (result.refusal) {
|
|
384
|
+
return refused(SHARED_REF_FILE_CODES[result.refusal.code] ?? "SCHEMA_DEF_COMPILE_REFUSED", field, result.refusal.message, {
|
|
385
|
+
def: name,
|
|
386
|
+
code: result.refusal.code,
|
|
387
|
+
path: result.refusal.path,
|
|
388
|
+
chain: result.refusal.chain,
|
|
389
|
+
});
|
|
390
|
+
}
|
|
391
|
+
// A ref may inline a node the authored check did not walk (one under an
|
|
392
|
+
// annotation map), so the compiled def is checked too.
|
|
393
|
+
const moved = refusedKeywordIn(result.schema, field);
|
|
394
|
+
if (moved) {
|
|
395
|
+
return refused("SCHEMA_DEF_KEYWORD_REFUSED", moved.path, `${moved.path}.${moved.keyword} is not supported once its refs resolve: the schema check would not enforce it. Express the bound with a supported keyword.`, { def: name, path: moved.path, keyword: moved.keyword });
|
|
396
|
+
}
|
|
397
|
+
compiledBytes += utf8Length(JSON.stringify(result.schema));
|
|
398
|
+
if (compiledBytes > SCHEMA_FILE_COMPILED_MAX_BYTES) {
|
|
399
|
+
return refused("SCHEMA_TOO_LARGE", field, `The file's defs compile to more than ${SCHEMA_FILE_COMPILED_MAX_BYTES} bytes together (${compiledBytes} by ${field}). Reference large defs fewer times, or split the file.`, { kind: "compiled", bytes: compiledBytes, limit: SCHEMA_FILE_COMPILED_MAX_BYTES, def: name });
|
|
400
|
+
}
|
|
401
|
+
setOwn(compiled, name, result.schema);
|
|
402
|
+
setOwn(resolved, name, result.resolved);
|
|
403
|
+
warningsByDef.set(name, result.warnings.map((warning) => ({ def: name, ...warning })));
|
|
404
|
+
}
|
|
405
|
+
// Answered in file order, whatever order the defs compiled in.
|
|
406
|
+
const inFileOrder = {};
|
|
407
|
+
const resolvedInFileOrder = {};
|
|
408
|
+
for (const name of names) {
|
|
409
|
+
setOwn(inFileOrder, name, compiled[name]);
|
|
410
|
+
setOwn(resolvedInFileOrder, name, resolved[name]);
|
|
411
|
+
}
|
|
412
|
+
const warnings = names.flatMap((name) => warningsByDef.get(name) ?? []);
|
|
413
|
+
return { ok: true, names, defs: inFileOrder, compiledBytes, warnings, resolved: resolvedInFileOrder };
|
|
414
|
+
}
|
|
415
|
+
/**
|
|
416
|
+
* The provenance a `schemas/` file stores, per def: each def whose compile
|
|
417
|
+
* inlined a ref, mapped to the chain at each inlined pointer with one hash
|
|
418
|
+
* per step. The compile must have run with a family index.
|
|
419
|
+
*/
|
|
420
|
+
export async function schemaFileProvenanceOf(compile) {
|
|
421
|
+
const out = {};
|
|
422
|
+
for (const name of compile.names) {
|
|
423
|
+
const entries = compile.resolved[name] ?? [];
|
|
424
|
+
if (entries.length === 0)
|
|
425
|
+
continue;
|
|
426
|
+
setOwn(out, name, await schemaProvenanceOf(entries));
|
|
427
|
+
}
|
|
428
|
+
return out;
|
|
429
|
+
}
|
|
430
|
+
/**
|
|
431
|
+
* JSON with every object's keys sorted, so two compiles that hold the same
|
|
432
|
+
* values compare equal however their keys were ordered: the RFC 8785
|
|
433
|
+
* canonical JSON provenance hashes are taken over.
|
|
434
|
+
*/
|
|
435
|
+
export function canonicalSchemaJson(value) {
|
|
436
|
+
return canonicalJson(value);
|
|
437
|
+
}
|
|
438
|
+
const SCHEMAS_REF = /^schemas:([^#]+)#\/\$defs\/([^/]+)(?:\/.*)?$/;
|
|
439
|
+
function pointerSegment(segment) {
|
|
440
|
+
return segment.replace(/~/g, "~0").replace(/\//g, "~1");
|
|
441
|
+
}
|
|
442
|
+
/**
|
|
443
|
+
* Every string `$ref` of the form `schemas:<file>#/$defs/<Name>[/…]` anywhere
|
|
444
|
+
* in a parsed document (a function, prompt, agent or `schemas/` file), in
|
|
445
|
+
* document order, with the file it names a valid stem.
|
|
446
|
+
*/
|
|
447
|
+
export function schemaFileRefsIn(document) {
|
|
448
|
+
const found = [];
|
|
449
|
+
// Last pushed is visited first, so entries are pushed in reverse.
|
|
450
|
+
const stack = [{ node: document, pointer: "" }];
|
|
451
|
+
while (stack.length > 0) {
|
|
452
|
+
const { node, pointer } = stack.pop();
|
|
453
|
+
if (Array.isArray(node)) {
|
|
454
|
+
for (let index = node.length - 1; index >= 0; index--)
|
|
455
|
+
stack.push({ node: node[index], pointer: `${pointer}/${index}` });
|
|
456
|
+
continue;
|
|
457
|
+
}
|
|
458
|
+
if (!isPlainObject(node))
|
|
459
|
+
continue;
|
|
460
|
+
if (typeof node.$ref === "string") {
|
|
461
|
+
const match = SCHEMAS_REF.exec(node.$ref);
|
|
462
|
+
if (match && isSchemaFileStem(match[1])) {
|
|
463
|
+
found.push({ pointer, ref: node.$ref, file: match[1], def: match[2].replace(/~1/g, "/").replace(/~0/g, "~") });
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
const entries = Object.entries(node);
|
|
467
|
+
for (let index = entries.length - 1; index >= 0; index--) {
|
|
468
|
+
const [key, child] = entries[index];
|
|
469
|
+
if (child !== null && typeof child === "object")
|
|
470
|
+
stack.push({ node: child, pointer: `${pointer}/${pointerSegment(key)}` });
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
return found;
|
|
474
|
+
}
|
|
475
|
+
//# sourceMappingURL=generated-schema-file.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"generated-schema-file.js","sourceRoot":"","sources":["../../../../src/lib/schema-codegen/generated-schema-file.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GENERATED FILE — DO NOT EDIT BY HAND.
|
|
3
|
+
*
|
|
4
|
+
* Vendored from the canonical server module
|
|
5
|
+
* `src/function-runs/schema-provenance.ts` — the SAME interpretation the server
|
|
6
|
+
* applies to a function's schemas. The CLI cannot import server `src/`
|
|
7
|
+
* at runtime, so the CLI imports this committed copy instead.
|
|
8
|
+
*
|
|
9
|
+
* Regenerate with:
|
|
10
|
+
* node cli/scripts/gen-schema-descriptor.mjs (runs at CLI prebuild)
|
|
11
|
+
*
|
|
12
|
+
* A CI freshness guard
|
|
13
|
+
* (`cli/scripts/gen-schema-descriptor.mjs --check`, also asserted by
|
|
14
|
+
* `cli/tests/unit/schema-codegen-descriptor-drift-guard.test.ts`) fails if
|
|
15
|
+
* this committed copy does not match the source — see issue #1442 / #998.
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* Provenance of a compiled schema: which definitions were inlined where.
|
|
19
|
+
*
|
|
20
|
+
* When a compile inlines a ref, the compiled schema records, for the JSON
|
|
21
|
+
* pointer of each inlined node, the chain of refs inlined there, outermost
|
|
22
|
+
* first, and an `h1:` hash of the compiled definition each step referenced:
|
|
23
|
+
*
|
|
24
|
+
* { "/properties/price": { "chain": [
|
|
25
|
+
* { "ref": "schemas:common#/$defs/Money", "hash": "h1:3f0c…" } ] } }
|
|
26
|
+
*
|
|
27
|
+
* The hash is `h1:` followed by the lowercase hex SHA-256 of the definition's
|
|
28
|
+
* RFC 8785 canonical JSON, so a definition hashes the same wherever it is
|
|
29
|
+
* compiled, and `config diff` can tell a pinned definition from the current
|
|
30
|
+
* one by comparing hashes.
|
|
31
|
+
*
|
|
32
|
+
* Pure and dependency-free, so the CLI vendors it beside the compiler
|
|
33
|
+
* (`cli/scripts/gen-schema-descriptor.mjs`) and both sides compute the same
|
|
34
|
+
* provenance. Hashing reads `globalThis.crypto.subtle`, which Workers and
|
|
35
|
+
* Node 19+ provide.
|
|
36
|
+
*/
|
|
37
|
+
/** The prefix of every provenance hash: the scheme's version. */
|
|
38
|
+
export declare const SCHEMA_PROVENANCE_HASH_PREFIX = "h1:";
|
|
39
|
+
/**
|
|
40
|
+
* The most bytes one compiled schema's provenance may take serialized
|
|
41
|
+
* (160 KiB). Estimated from its entries and chain steps before any hash is
|
|
42
|
+
* computed, so a schema whose refs would record too much is refused cheaply.
|
|
43
|
+
*/
|
|
44
|
+
export declare const SCHEMA_PROVENANCE_LIMIT_BYTES = 163840;
|
|
45
|
+
/** The error code for a value RFC 8785 cannot represent: a lone surrogate. */
|
|
46
|
+
export declare const SCHEMA_CANONICAL_INVALID = "SCHEMA_CANONICAL_INVALID";
|
|
47
|
+
/** One step of a provenance chain: the ref as it resolved, and the hash of what it referenced. */
|
|
48
|
+
export interface SchemaProvenanceStep {
|
|
49
|
+
ref: string;
|
|
50
|
+
hash: string;
|
|
51
|
+
}
|
|
52
|
+
/** The refs inlined at one pointer, outermost first. */
|
|
53
|
+
export interface SchemaProvenanceEntry {
|
|
54
|
+
chain: SchemaProvenanceStep[];
|
|
55
|
+
}
|
|
56
|
+
/** A compiled schema's provenance: inlined pointer → its chain. */
|
|
57
|
+
export type SchemaProvenance = Record<string, SchemaProvenanceEntry>;
|
|
58
|
+
/**
|
|
59
|
+
* One inlined node, as a compile reports it for hashing: the refs of its
|
|
60
|
+
* chain and, per step, either the compiled definition to hash or the hash a
|
|
61
|
+
* stored provenance already records.
|
|
62
|
+
*/
|
|
63
|
+
export interface SchemaProvenanceInput {
|
|
64
|
+
pointer: string;
|
|
65
|
+
chain: readonly string[];
|
|
66
|
+
definitions?: readonly unknown[];
|
|
67
|
+
hashes?: ReadonlyArray<string | undefined>;
|
|
68
|
+
}
|
|
69
|
+
/** A value canonical JSON cannot represent, and where it sits. */
|
|
70
|
+
export declare class SchemaCanonicalError extends Error {
|
|
71
|
+
readonly pointer: string;
|
|
72
|
+
readonly code = "SCHEMA_CANONICAL_INVALID";
|
|
73
|
+
constructor(pointer: string, message: string);
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* RFC 8785 canonical JSON of `value`: object members sorted by the UTF-16
|
|
77
|
+
* code units of their names and written directly (so `"10"` sorts before
|
|
78
|
+
* `"2"`), ES number and string serialization, no whitespace. Values are first
|
|
79
|
+
* mapped the way `JSON.stringify` maps them (`toJSON`, undefined members
|
|
80
|
+
* dropped, non-finite numbers as null). A lone surrogate, in a name or a
|
|
81
|
+
* string, throws `SchemaCanonicalError` naming its pointer.
|
|
82
|
+
*
|
|
83
|
+
* Written with its own stack, so a deep document cannot exhaust the call stack.
|
|
84
|
+
*
|
|
85
|
+
* @example
|
|
86
|
+
* canonicalJson({ b: 1, a: [true, "x"] }); // → '{"a":[true,"x"],"b":1}'
|
|
87
|
+
*/
|
|
88
|
+
export declare function canonicalJson(value: unknown): string;
|
|
89
|
+
/**
|
|
90
|
+
* The provenance hash of a compiled definition: `h1:` and the lowercase hex
|
|
91
|
+
* SHA-256 of its RFC 8785 canonical JSON.
|
|
92
|
+
*
|
|
93
|
+
* @example
|
|
94
|
+
* await provenanceHash({ type: "string" }); // → "h1:" + 64 hex characters
|
|
95
|
+
*/
|
|
96
|
+
export declare function provenanceHash(value: unknown): Promise<string>;
|
|
97
|
+
/**
|
|
98
|
+
* The provenance of a compiled schema from what its compile resolved: each
|
|
99
|
+
* pointer's chain, with every step's hash. A step that carries a hash keeps
|
|
100
|
+
* it; any other is hashed from its definition, once per distinct definition
|
|
101
|
+
* (by identity), so many uses of one definition cost one hash. `options.hash`
|
|
102
|
+
* replaces the hasher.
|
|
103
|
+
*/
|
|
104
|
+
export declare function schemaProvenanceOf(resolved: readonly SchemaProvenanceInput[], options?: {
|
|
105
|
+
hash?: (value: unknown) => Promise<string>;
|
|
106
|
+
}): Promise<SchemaProvenance>;
|
|
107
|
+
/**
|
|
108
|
+
* Would `a` and `b` write the same canonical JSON? Decided structurally, so
|
|
109
|
+
* a value canonical JSON cannot represent (a lone surrogate in a ref-free
|
|
110
|
+
* schema's description, stored as before #5533) compares instead of
|
|
111
|
+
* throwing: equal strings are equal, members in any order, numbers by value.
|
|
112
|
+
*/
|
|
113
|
+
export declare function canonicalJsonEquals(a: unknown, b: unknown): boolean;
|
|
114
|
+
/** Do two provenances record the same chains? Compared as canonical JSON; an absent one equals an empty one. */
|
|
115
|
+
export declare function provenanceEquals(a: SchemaProvenance | null | undefined, b: SchemaProvenance | null | undefined): boolean;
|