primitive-admin 1.2.0-alpha.8 → 1.3.0-alpha.0
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 +258 -186
- package/assets/skill/skills/primitive-platform/SKILL.md +103 -29
- package/dist/bin/primitive.js +15 -89
- package/dist/bin/primitive.js.map +1 -1
- package/dist/src/commands/admins.js +80 -17
- package/dist/src/commands/admins.js.map +1 -1
- package/dist/src/commands/agent-sessions.d.ts +129 -0
- package/dist/src/commands/agent-sessions.js +532 -20
- package/dist/src/commands/agent-sessions.js.map +1 -1
- package/dist/src/commands/analytics.js +207 -155
- package/dist/src/commands/analytics.js.map +1 -1
- package/dist/src/commands/apps-children.d.ts +1 -1
- package/dist/src/commands/apps-children.js +56 -145
- package/dist/src/commands/apps-children.js.map +1 -1
- package/dist/src/commands/apps-transitions.d.ts +39 -0
- package/dist/src/commands/apps-transitions.js +198 -0
- package/dist/src/commands/apps-transitions.js.map +1 -0
- package/dist/src/commands/apps.d.ts +17 -0
- package/dist/src/commands/apps.js +108 -3
- package/dist/src/commands/apps.js.map +1 -1
- package/dist/src/commands/auth-sessions.js +2 -0
- package/dist/src/commands/auth-sessions.js.map +1 -1
- package/dist/src/commands/auth.js +138 -44
- package/dist/src/commands/auth.js.map +1 -1
- package/dist/src/commands/blob-buckets.js +2 -0
- package/dist/src/commands/blob-buckets.js.map +1 -1
- package/dist/src/commands/collections.js +318 -256
- package/dist/src/commands/collections.js.map +1 -1
- package/dist/src/commands/comparisons.js +2 -0
- package/dist/src/commands/comparisons.js.map +1 -1
- package/dist/src/commands/config.d.ts +2 -2
- package/dist/src/commands/config.js +59 -33
- 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/database-types.js +13 -313
- package/dist/src/commands/database-types.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.d.ts +15 -0
- package/dist/src/commands/db3-types.js +159 -0
- package/dist/src/commands/db3-types.js.map +1 -0
- package/dist/src/commands/db3.d.ts +24 -0
- package/dist/src/commands/db3.js +1444 -0
- package/dist/src/commands/db3.js.map +1 -0
- package/dist/src/commands/documents.d.ts +110 -10
- package/dist/src/commands/documents.js +1012 -748
- package/dist/src/commands/documents.js.map +1 -1
- package/dist/src/commands/email-templates.js +74 -0
- package/dist/src/commands/email-templates.js.map +1 -1
- package/dist/src/commands/env.js +8 -4
- package/dist/src/commands/env.js.map +1 -1
- package/dist/src/commands/function-trigger-commands.d.ts +28 -0
- package/dist/src/commands/function-trigger-commands.js +341 -0
- package/dist/src/commands/function-trigger-commands.js.map +1 -0
- package/dist/src/commands/functions.js +376 -30
- package/dist/src/commands/functions.js.map +1 -1
- package/dist/src/commands/groups.js +168 -50
- package/dist/src/commands/groups.js.map +1 -1
- package/dist/src/commands/guides.js +7 -5
- package/dist/src/commands/guides.js.map +1 -1
- package/dist/src/commands/hosting.d.ts +8 -0
- package/dist/src/commands/hosting.js +346 -0
- package/dist/src/commands/hosting.js.map +1 -0
- package/dist/src/commands/init.js +129 -38
- package/dist/src/commands/init.js.map +1 -1
- package/dist/src/commands/integrations.js +82 -53
- package/dist/src/commands/integrations.js.map +1 -1
- package/dist/src/commands/llm.js +9 -6
- package/dist/src/commands/llm.js.map +1 -1
- package/dist/src/commands/locks.d.ts +5 -3
- package/dist/src/commands/locks.js +19 -61
- package/dist/src/commands/locks.js.map +1 -1
- package/dist/src/commands/metadata-category-configs.d.ts +2 -2
- package/dist/src/commands/metadata-category-configs.js +4 -2
- 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 +75 -52
- package/dist/src/commands/prompts.js.map +1 -1
- package/dist/src/commands/rate-counters.d.ts +19 -0
- package/dist/src/commands/rate-counters.js +104 -0
- package/dist/src/commands/rate-counters.js.map +1 -0
- package/dist/src/commands/rule-sets.d.ts +1 -1
- package/dist/src/commands/rule-sets.js +2 -1
- 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/scripts.d.ts +9 -17
- package/dist/src/commands/scripts.js +24 -479
- package/dist/src/commands/scripts.js.map +1 -1
- package/dist/src/commands/secrets.js +47 -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/settings.d.ts +12 -9
- package/dist/src/commands/settings.js +31 -79
- package/dist/src/commands/settings.js.map +1 -1
- package/dist/src/commands/skill.js +2 -0
- package/dist/src/commands/skill.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 +519 -554
- package/dist/src/commands/sync.js +3010 -4909
- package/dist/src/commands/sync.js.map +1 -1
- package/dist/src/commands/tokens.js +5 -3
- package/dist/src/commands/tokens.js.map +1 -1
- package/dist/src/commands/transitions.d.ts +54 -0
- package/dist/src/commands/transitions.js +418 -0
- package/dist/src/commands/transitions.js.map +1 -0
- package/dist/src/commands/usage.d.ts +18 -0
- package/dist/src/commands/usage.js +343 -0
- package/dist/src/commands/usage.js.map +1 -0
- 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 +911 -18
- package/dist/src/commands/users.js.map +1 -1
- package/dist/src/commands/vars.js +2 -0
- package/dist/src/commands/vars.js.map +1 -1
- package/dist/src/commands/waitlist.js +39 -4
- package/dist/src/commands/waitlist.js.map +1 -1
- package/dist/src/commands/workflows.d.ts +5 -83
- package/dist/src/commands/workflows.js +57 -2282
- package/dist/src/commands/workflows.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 +1830 -429
- package/dist/src/lib/api-client.js +1025 -546
- package/dist/src/lib/api-client.js.map +1 -1
- package/dist/src/lib/app-settings-descriptor.d.ts +1 -1
- package/dist/src/lib/app-settings-descriptor.js +6 -0
- package/dist/src/lib/app-settings-descriptor.js.map +1 -1
- package/dist/src/lib/auth-fixtures.d.ts +44 -0
- package/dist/src/lib/auth-fixtures.js +61 -0
- package/dist/src/lib/auth-fixtures.js.map +1 -0
- package/dist/src/lib/auth-flow.d.ts +34 -1
- package/dist/src/lib/auth-flow.js +429 -13
- package/dist/src/lib/auth-flow.js.map +1 -1
- package/dist/src/lib/block-layout.d.ts +12 -23
- package/dist/src/lib/block-layout.js +26 -92
- package/dist/src/lib/block-layout.js.map +1 -1
- package/dist/src/lib/block-selector.d.ts +8 -14
- package/dist/src/lib/block-selector.js +8 -19
- package/dist/src/lib/block-selector.js.map +1 -1
- package/dist/src/lib/child-apps-local.d.ts +3 -47
- package/dist/src/lib/child-apps-local.js +11 -73
- package/dist/src/lib/child-apps-local.js.map +1 -1
- package/dist/src/lib/cli-manifest.d.ts +9 -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/collection-export.d.ts +76 -15
- package/dist/src/lib/collection-export.js +116 -23
- package/dist/src/lib/collection-export.js.map +1 -1
- package/dist/src/lib/collection-principal.d.ts +22 -0
- package/dist/src/lib/collection-principal.js +35 -0
- package/dist/src/lib/collection-principal.js.map +1 -0
- package/dist/src/lib/command-groups.d.ts +30 -0
- package/dist/src/lib/command-groups.js +109 -0
- package/dist/src/lib/command-groups.js.map +1 -0
- package/dist/src/lib/command-status.d.ts +147 -0
- package/dist/src/lib/command-status.js +266 -0
- package/dist/src/lib/command-status.js.map +1 -0
- package/dist/src/lib/config-object-descriptor.d.ts +9 -22
- package/dist/src/lib/config-object-descriptor.js +107 -276
- package/dist/src/lib/config-object-descriptor.js.map +1 -1
- package/dist/src/lib/config-surface.d.ts +3 -7
- package/dist/src/lib/config-surface.js +9 -13
- package/dist/src/lib/config-surface.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/credentials-home.d.ts +7 -0
- package/dist/src/lib/credentials-home.js +45 -10
- package/dist/src/lib/credentials-home.js.map +1 -1
- package/dist/src/lib/credentials-lock.d.ts +14 -6
- package/dist/src/lib/credentials-lock.js +90 -10
- package/dist/src/lib/credentials-lock.js.map +1 -1
- package/dist/src/lib/credentials-store.d.ts +123 -70
- package/dist/src/lib/credentials-store.js +358 -113
- package/dist/src/lib/credentials-store.js.map +1 -1
- package/dist/src/lib/custodian.d.ts +8 -0
- package/dist/src/lib/custodian.js +18 -0
- package/dist/src/lib/custodian.js.map +1 -0
- 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 +38 -1
- package/dist/src/lib/db-codegen/dbTypeIR.js +29 -7
- package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
- package/dist/src/lib/db-type-records.d.ts +106 -0
- package/dist/src/lib/db-type-records.js +224 -0
- package/dist/src/lib/db-type-records.js.map +1 -0
- package/dist/src/lib/db3-export.d.ts +287 -0
- package/dist/src/lib/db3-export.js +647 -0
- package/dist/src/lib/db3-export.js.map +1 -0
- package/dist/src/lib/db3-index-output.d.ts +116 -0
- package/dist/src/lib/db3-index-output.js +223 -0
- package/dist/src/lib/db3-index-output.js.map +1 -0
- package/dist/src/lib/db3-type-models.d.ts +134 -0
- package/dist/src/lib/db3-type-models.js +452 -0
- package/dist/src/lib/db3-type-models.js.map +1 -0
- package/dist/src/lib/deprecation.d.ts +2 -2
- package/dist/src/lib/deprecation.js +2 -2
- package/dist/src/lib/document-ingest-artifact.d.ts +13 -0
- package/dist/src/lib/document-ingest-artifact.js +36 -6
- package/dist/src/lib/document-ingest-artifact.js.map +1 -1
- package/dist/src/lib/document-ingest-format2.d.ts +36 -0
- package/dist/src/lib/document-ingest-format2.js +78 -0
- package/dist/src/lib/document-ingest-format2.js.map +1 -0
- package/dist/src/lib/document-ingest-input.d.ts +9 -0
- package/dist/src/lib/document-ingest-input.js +28 -1
- package/dist/src/lib/document-ingest-input.js.map +1 -1
- package/dist/src/lib/document-ingest.d.ts +11 -1
- package/dist/src/lib/document-ingest.js +16 -0
- package/dist/src/lib/document-ingest.js.map +1 -1
- package/dist/src/lib/document-schema-rows.d.ts +42 -0
- package/dist/src/lib/document-schema-rows.js +53 -0
- package/dist/src/lib/document-schema-rows.js.map +1 -0
- 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 +142 -0
- package/dist/src/lib/function-authorize-check.js +311 -0
- package/dist/src/lib/function-authorize-check.js.map +1 -0
- package/dist/src/lib/function-authorize-view.d.ts +27 -0
- package/dist/src/lib/function-authorize-view.js +88 -0
- package/dist/src/lib/function-authorize-view.js.map +1 -0
- package/dist/src/lib/function-bundle.d.ts +27 -5
- package/dist/src/lib/function-bundle.js +142 -7
- package/dist/src/lib/function-bundle.js.map +1 -1
- package/dist/src/lib/function-collect.d.ts +90 -12
- package/dist/src/lib/function-collect.js +482 -12
- package/dist/src/lib/function-collect.js.map +1 -1
- package/dist/src/lib/function-db-types.d.ts +65 -11
- package/dist/src/lib/function-db-types.js +297 -157
- 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-lint.d.ts +57 -0
- package/dist/src/lib/function-lint.js +234 -0
- package/dist/src/lib/function-lint.js.map +1 -0
- package/dist/src/lib/function-log-row.js +21 -2
- package/dist/src/lib/function-log-row.js.map +1 -1
- package/dist/src/lib/function-run.d.ts +13 -21
- package/dist/src/lib/function-run.js +14 -27
- package/dist/src/lib/function-run.js.map +1 -1
- package/dist/src/lib/function-schema-codegen.d.ts +86 -22
- package/dist/src/lib/function-schema-codegen.js +194 -88
- 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 +109 -6
- package/dist/src/lib/function-sync.js +179 -26
- package/dist/src/lib/function-sync.js.map +1 -1
- package/dist/src/lib/function-trigger-listing.d.ts +11 -6
- package/dist/src/lib/function-trigger-listing.js +32 -11
- package/dist/src/lib/function-trigger-listing.js.map +1 -1
- package/dist/src/lib/function-triggers.d.ts +15 -3
- package/dist/src/lib/function-triggers.js +72 -10
- package/dist/src/lib/function-triggers.js.map +1 -1
- package/dist/src/lib/function-typecheck.d.ts +52 -0
- package/dist/src/lib/function-typecheck.js +174 -54
- package/dist/src/lib/function-typecheck.js.map +1 -1
- package/dist/src/lib/function-versions.d.ts +2 -0
- package/dist/src/lib/function-versions.js +1 -0
- package/dist/src/lib/function-versions.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-command-status.d.ts +6 -0
- package/dist/src/lib/generated-command-status.js +469 -0
- package/dist/src/lib/generated-command-status.js.map +1 -0
- package/dist/src/lib/generated-config-surfaces.d.ts +586 -152
- package/dist/src/lib/generated-config-surfaces.js +1919 -1883
- 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/generated-workflow-model-fields.d.ts +20 -0
- package/dist/src/lib/generated-workflow-model-fields.js +53 -0
- package/dist/src/lib/generated-workflow-model-fields.js.map +1 -0
- package/dist/src/lib/hosting-build.d.ts +97 -0
- package/dist/src/lib/hosting-build.js +204 -0
- package/dist/src/lib/hosting-build.js.map +1 -0
- package/dist/src/lib/hosting-client.d.ts +167 -0
- package/dist/src/lib/hosting-client.js +340 -0
- package/dist/src/lib/hosting-client.js.map +1 -0
- package/dist/src/lib/hosting-environments.d.ts +32 -0
- package/dist/src/lib/hosting-environments.js +74 -0
- package/dist/src/lib/hosting-environments.js.map +1 -0
- package/dist/src/lib/hosting-errors.d.ts +30 -0
- package/dist/src/lib/hosting-errors.js +43 -0
- package/dist/src/lib/hosting-errors.js.map +1 -0
- package/dist/src/lib/hosting-token.d.ts +46 -0
- package/dist/src/lib/hosting-token.js +60 -0
- package/dist/src/lib/hosting-token.js.map +1 -0
- package/dist/src/lib/hosting-wait.d.ts +42 -0
- package/dist/src/lib/hosting-wait.js +84 -0
- package/dist/src/lib/hosting-wait.js.map +1 -0
- package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
- package/dist/src/lib/hosting-wfp-upload.js +149 -0
- package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
- package/dist/src/lib/init-assets.d.ts +2 -6
- package/dist/src/lib/init-assets.js +11 -27
- package/dist/src/lib/init-assets.js.map +1 -1
- package/dist/src/lib/init-ios-links.d.ts +11 -7
- package/dist/src/lib/init-ios-links.js +28 -22
- package/dist/src/lib/init-ios-links.js.map +1 -1
- package/dist/src/lib/init-login-note.d.ts +13 -0
- package/dist/src/lib/init-login-note.js +22 -0
- package/dist/src/lib/init-login-note.js.map +1 -0
- package/dist/src/lib/init-schema.d.ts +15 -0
- package/dist/src/lib/init-schema.js +54 -0
- package/dist/src/lib/init-schema.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/invoker-shared-enums.d.ts +35 -0
- package/dist/src/lib/invoker-shared-enums.js +98 -0
- package/dist/src/lib/invoker-shared-enums.js.map +1 -0
- package/dist/src/lib/json-value.d.ts +6 -0
- package/dist/src/lib/json-value.js +13 -0
- package/dist/src/lib/json-value.js.map +1 -0
- package/dist/src/lib/load-routes.d.ts +33 -0
- package/dist/src/lib/load-routes.js +35 -0
- package/dist/src/lib/load-routes.js.map +1 -0
- package/dist/src/lib/log-inspection.d.ts +23 -4
- package/dist/src/lib/log-inspection.js +14 -5
- package/dist/src/lib/log-inspection.js.map +1 -1
- package/dist/src/lib/login-exchange-check.d.ts +18 -0
- package/dist/src/lib/login-exchange-check.js +27 -0
- package/dist/src/lib/login-exchange-check.js.map +1 -0
- package/dist/src/lib/login-scope-lines.d.ts +17 -7
- package/dist/src/lib/login-scope-lines.js +33 -10
- package/dist/src/lib/login-scope-lines.js.map +1 -1
- 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/object-status-filter.d.ts +9 -1
- package/dist/src/lib/object-status-filter.js +9 -1
- package/dist/src/lib/object-status-filter.js.map +1 -1
- package/dist/src/lib/output.d.ts +1 -1
- package/dist/src/lib/output.js +3 -1
- package/dist/src/lib/output.js.map +1 -1
- package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
- package/dist/src/lib/pin-refusal-hint.js +35 -0
- package/dist/src/lib/pin-refusal-hint.js.map +1 -0
- 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 +174 -0
- package/dist/src/lib/primitive-declaration.js +792 -0
- package/dist/src/lib/primitive-declaration.js.map +1 -0
- package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
- package/dist/src/lib/primitive-env-plugin.js +408 -0
- package/dist/src/lib/primitive-env-plugin.js.map +1 -0
- package/dist/src/lib/project-login-apps.d.ts +8 -0
- package/dist/src/lib/project-login-apps.js +27 -0
- package/dist/src/lib/project-login-apps.js.map +1 -0
- package/dist/src/lib/prompt-schema-codegen.d.ts +46 -15
- package/dist/src/lib/prompt-schema-codegen.js +142 -108
- 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 +173 -0
- package/dist/src/lib/prompt-schema-refs.js +478 -0
- package/dist/src/lib/prompt-schema-refs.js.map +1 -0
- package/dist/src/lib/records-verbs.d.ts +79 -0
- package/dist/src/lib/records-verbs.js +45 -0
- package/dist/src/lib/records-verbs.js.map +1 -0
- package/dist/src/lib/register-commands.d.ts +36 -0
- package/dist/src/lib/register-commands.js +37 -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/run-status.d.ts +1 -1
- package/dist/src/lib/run-status.generated.d.ts +2 -2
- package/dist/src/lib/run-status.generated.js +3 -1
- package/dist/src/lib/run-status.generated.js.map +1 -1
- package/dist/src/lib/run-status.js +1 -1
- 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 +227 -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 +218 -0
- package/dist/src/lib/schema-codegen/generated-field-grammar.js +397 -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 +258 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
- package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
- 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/generated-schema-shape.d.ts +27 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
- package/dist/src/lib/schema-codegen/generated-schema-shape.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/naming.d.ts +35 -0
- package/dist/src/lib/schema-codegen/naming.js +83 -0
- package/dist/src/lib/schema-codegen/naming.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 +109 -0
- package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
- package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
- package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
- package/dist/src/lib/schema-codegen/valuesLists.js +144 -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/scope-request.d.ts +23 -11
- package/dist/src/lib/scope-request.js +69 -31
- package/dist/src/lib/scope-request.js.map +1 -1
- package/dist/src/lib/session-scope.d.ts +26 -0
- package/dist/src/lib/session-scope.js +58 -0
- package/dist/src/lib/session-scope.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 +8 -3
- package/dist/src/lib/swift-codegen/agentGenerator.js +76 -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 +169 -51
- package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
- package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
- package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
- 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 +165 -0
- package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
- package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
- package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
- package/dist/src/lib/swift-codegen/swiftKeys.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 +117 -31
- package/dist/src/lib/sync-resource-types.js +197 -189
- 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/template.d.ts +39 -3
- package/dist/src/lib/template.js +103 -14
- package/dist/src/lib/template.js.map +1 -1
- package/dist/src/lib/test-case-file-names.d.ts +3 -5
- package/dist/src/lib/test-case-file-names.js +3 -5
- package/dist/src/lib/test-case-file-names.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/test-users.d.ts +25 -0
- package/dist/src/lib/test-users.js +36 -0
- package/dist/src/lib/test-users.js.map +1 -0
- package/dist/src/lib/toml-database-config.d.ts +4 -2
- package/dist/src/lib/toml-database-config.js +11 -6
- 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/transition-warnings.d.ts +21 -0
- package/dist/src/lib/transition-warnings.js +49 -0
- package/dist/src/lib/transition-warnings.js.map +1 -0
- 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/webhook-capture.d.ts +43 -0
- package/dist/src/lib/webhook-capture.js +91 -0
- package/dist/src/lib/webhook-capture.js.map +1 -0
- package/dist/src/lib/webhook-deliver.d.ts +18 -20
- package/dist/src/lib/webhook-deliver.js +34 -89
- package/dist/src/lib/webhook-deliver.js.map +1 -1
- package/dist/src/lib/webhook-test-run.d.ts +32 -0
- package/dist/src/lib/webhook-test-run.js +108 -0
- package/dist/src/lib/webhook-test-run.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/lib/workflow-field-descriptor.d.ts +91 -0
- package/dist/src/lib/workflow-field-descriptor.js +153 -0
- package/dist/src/lib/workflow-field-descriptor.js.map +1 -0
- package/dist/src/types/index.d.ts +20 -65
- package/dist/src/validators.d.ts +7 -55
- package/dist/src/validators.js +7 -53
- package/dist/src/validators.js.map +1 -1
- package/dist/src/vite.d.ts +17 -0
- package/dist/src/vite.js +18 -0
- package/dist/src/vite.js.map +1 -0
- package/package.json +20 -9
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The `collections.json` artifact, and the decisions an import makes from it
|
|
3
|
-
* (#3643).
|
|
3
|
+
* (#3643), on custody and roles (#4731).
|
|
4
4
|
*
|
|
5
5
|
* `documents export-all` / `documents import` carry Yjs state, blobs,
|
|
6
6
|
* permissions and aliases, but nothing about collections: which exist, what
|
|
@@ -18,10 +18,33 @@
|
|
|
18
18
|
*/
|
|
19
19
|
import fs from "node:fs";
|
|
20
20
|
import path from "node:path";
|
|
21
|
-
/**
|
|
21
|
+
/**
|
|
22
|
+
* The only file version this CLI reads or writes. #4731 added custody and
|
|
23
|
+
* roles to it without a new version (DSO4731-14): every field a version-1
|
|
24
|
+
* reader needs (`owner`, a `permission` on every member, `groupType` and
|
|
25
|
+
* `permission` on every grant) is still written, and `custodian`, `settings`
|
|
26
|
+
* and a `role` beside each `permission` are added, so an older CLI still
|
|
27
|
+
* reads a new file and this CLI reads an old one.
|
|
28
|
+
*/
|
|
22
29
|
export const COLLECTION_EXPORT_VERSION = 1;
|
|
23
30
|
/** Its name inside an export directory, beside `manifest.json`. */
|
|
24
31
|
export const COLLECTION_EXPORT_FILENAME = "collections.json";
|
|
32
|
+
/** A collection role, highest first. */
|
|
33
|
+
export const COLLECTION_ROLES = ["owner", "manager", "editor", "contributor", "viewer"];
|
|
34
|
+
function isCollectionRole(value) {
|
|
35
|
+
return typeof value === "string" && COLLECTION_ROLES.includes(value);
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* The role a `permission` reads as when a file records no `role`: the
|
|
39
|
+
* mapping the server's compatibility layer applies to an old client's grant.
|
|
40
|
+
*/
|
|
41
|
+
export function roleForLegacyPermission(permission) {
|
|
42
|
+
return permission === "read-write" ? "editor" : "viewer";
|
|
43
|
+
}
|
|
44
|
+
/** The `permission` a role reads as, written beside it for an older reader. */
|
|
45
|
+
export function permissionForRole(role) {
|
|
46
|
+
return role === "viewer" || role === "contributor" ? "reader" : "read-write";
|
|
47
|
+
}
|
|
25
48
|
/**
|
|
26
49
|
* Resolve the `<path>` an import was given to the file it must read.
|
|
27
50
|
*
|
|
@@ -57,7 +80,8 @@ export function readCollectionExportFile(inputPath) {
|
|
|
57
80
|
throw new Error(`${filePath} declares version ${JSON.stringify(parsed?.version)}; ` +
|
|
58
81
|
`this CLI reads version ${COLLECTION_EXPORT_VERSION} only.`);
|
|
59
82
|
}
|
|
60
|
-
const
|
|
83
|
+
const raw = Array.isArray(parsed.collections) ? parsed.collections : [];
|
|
84
|
+
const collections = raw.map(withRoles);
|
|
61
85
|
const legacyContextIdCount = collections.filter((c) => typeof c?.contextId === "string" && c.contextId !== "").length;
|
|
62
86
|
return {
|
|
63
87
|
version: parsed.version,
|
|
@@ -69,16 +93,55 @@ export function readCollectionExportFile(inputPath) {
|
|
|
69
93
|
};
|
|
70
94
|
}
|
|
71
95
|
/**
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
76
|
-
*
|
|
96
|
+
* One collection as the import reads it, with a `role` on every member and
|
|
97
|
+
* grant. A file written before #4731 records only a `permission`: each reads
|
|
98
|
+
* as the role the server's compatibility layer gives it (`reader` → viewer,
|
|
99
|
+
* `read-write` → editor), except the owner's own `read-write` row, which the
|
|
100
|
+
* server reads as the owner row on a collection with no custodian, and so
|
|
101
|
+
* does this.
|
|
102
|
+
*/
|
|
103
|
+
function withRoles(collection) {
|
|
104
|
+
const preCustody = !collection || !("custodian" in collection);
|
|
105
|
+
const owner = collection?.owner ?? null;
|
|
106
|
+
const isOwner = (m) => owner !== null &&
|
|
107
|
+
((owner.userId && m?.userId === owner.userId) || (owner.email && m?.email === owner.email));
|
|
108
|
+
return {
|
|
109
|
+
...collection,
|
|
110
|
+
custodian: collection?.custodian ?? null,
|
|
111
|
+
owner,
|
|
112
|
+
settings: collection?.settings ?? null,
|
|
113
|
+
members: (Array.isArray(collection?.members) ? collection.members : []).map((m) => {
|
|
114
|
+
const role = isCollectionRole(m?.role)
|
|
115
|
+
? m.role
|
|
116
|
+
: preCustody && m?.permission === "read-write" && isOwner(m)
|
|
117
|
+
? "owner"
|
|
118
|
+
: roleForLegacyPermission(m?.permission);
|
|
119
|
+
return { ...m, role, permission: m?.permission ?? permissionForRole(role) };
|
|
120
|
+
}),
|
|
121
|
+
groups: (Array.isArray(collection?.groups) ? collection.groups : []).map((g) => {
|
|
122
|
+
const role = isCollectionRole(g?.role) ? g.role : roleForLegacyPermission(g?.permission);
|
|
123
|
+
return { ...g, role, permission: g?.permission ?? permissionForRole(role) };
|
|
124
|
+
}),
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
/** The custodian a create sends: `app`, or the owner as `user:<userId>`. */
|
|
128
|
+
export function custodianFor(ownerUserId, appCustody) {
|
|
129
|
+
if (appCustody)
|
|
130
|
+
return "app";
|
|
131
|
+
return ownerUserId ? `user:${ownerUserId}` : null;
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* Which of the custodian and `collectionType` a name match differs on — the
|
|
135
|
+
* fields a merge cannot change (custody moves only by a transfer, and
|
|
136
|
+
* `collections-controller.ts` rejects a type change), so a difference cannot
|
|
137
|
+
* be merged away (F2). A `contextId` an older file still carries is not
|
|
138
|
+
* compared: the platform removed the field (#3926), so it is no difference at
|
|
139
|
+
* all.
|
|
77
140
|
*
|
|
78
141
|
* Returns null when the match is compatible.
|
|
79
142
|
*/
|
|
80
|
-
export function incompatibleField(collection, existing,
|
|
81
|
-
if (existing.
|
|
143
|
+
export function incompatibleField(collection, existing, custodian) {
|
|
144
|
+
if (existing.custodian !== custodian)
|
|
82
145
|
return "owner";
|
|
83
146
|
// The server defaults an unset type to "default", so the file's null and the
|
|
84
147
|
// target's "default" are the same collection type, not a difference.
|
|
@@ -87,6 +150,21 @@ export function incompatibleField(collection, existing, ownerUserId) {
|
|
|
87
150
|
return "collectionType";
|
|
88
151
|
return null;
|
|
89
152
|
}
|
|
153
|
+
/**
|
|
154
|
+
* Whether two grants name the same group. A group is addressed by its id
|
|
155
|
+
* alone: the server stores every new group as type `group` and the
|
|
156
|
+
* migration keeps a public id unique across types, so a recorded grant's
|
|
157
|
+
* deprecated type (`team`) names the target's group of that id whatever type
|
|
158
|
+
* it stored. A platform type (`_col-*`) keeps its exact meaning.
|
|
159
|
+
*/
|
|
160
|
+
export function sameGrantGroup(a, b) {
|
|
161
|
+
if (a.groupId !== b.groupId)
|
|
162
|
+
return false;
|
|
163
|
+
const system = (grant) => String(grant.groupType ?? "").startsWith("_");
|
|
164
|
+
if (system(a) || system(b))
|
|
165
|
+
return a.groupType === b.groupType;
|
|
166
|
+
return true;
|
|
167
|
+
}
|
|
90
168
|
/**
|
|
91
169
|
* Compare a recorded grant with the target's.
|
|
92
170
|
*
|
|
@@ -99,17 +177,15 @@ export function incompatibleField(collection, existing, ownerUserId) {
|
|
|
99
177
|
* used to report such a grant instead of changing it (F3).
|
|
100
178
|
*/
|
|
101
179
|
export function grantDisposition(wanted, targetGrants) {
|
|
102
|
-
const existing = targetGrants.find((g) => g
|
|
180
|
+
const existing = targetGrants.find((g) => sameGrantGroup(g, wanted));
|
|
103
181
|
if (!existing)
|
|
104
182
|
return "grant";
|
|
105
|
-
return existing.
|
|
106
|
-
? "already-applied"
|
|
107
|
-
: "update";
|
|
183
|
+
return existing.role === wanted.role ? "already-applied" : "update";
|
|
108
184
|
}
|
|
109
|
-
/** The line a
|
|
110
|
-
export function grantUpdateLine(groupLabel,
|
|
111
|
-
return (`${groupLabel}: ${
|
|
112
|
-
`(the
|
|
185
|
+
/** The line a role change is announced with, named from and to. */
|
|
186
|
+
export function grantUpdateLine(groupLabel, existingRole, wantedRole) {
|
|
187
|
+
return (`${groupLabel}: ${existingRole} → ${wantedRole} ` +
|
|
188
|
+
`(the role the export records)`);
|
|
113
189
|
}
|
|
114
190
|
/**
|
|
115
191
|
* What a server refusal reads as in a per-item problem.
|
|
@@ -170,7 +246,8 @@ export function planCollection(collection, resolution, options) {
|
|
|
170
246
|
problem: { kind: "collection", id: collection.name, reason },
|
|
171
247
|
};
|
|
172
248
|
}
|
|
173
|
-
|
|
249
|
+
const custodian = custodianFor(resolution.ownerUserId, Boolean(resolution.appCustody));
|
|
250
|
+
if (!custodian) {
|
|
174
251
|
const reason = resolution.ownerReason ??
|
|
175
252
|
`its owner could not be resolved in the target app`;
|
|
176
253
|
return {
|
|
@@ -189,14 +266,15 @@ export function planCollection(collection, resolution, options) {
|
|
|
189
266
|
return {
|
|
190
267
|
...base,
|
|
191
268
|
action: "create",
|
|
192
|
-
|
|
269
|
+
custodian,
|
|
270
|
+
...(resolution.ownerUserId && !resolution.appCustody ? { ownerUserId: resolution.ownerUserId } : {}),
|
|
193
271
|
};
|
|
194
272
|
}
|
|
195
273
|
// A name match is checked for compatibility WHETHER OR NOT --overwrite was
|
|
196
274
|
// given: none of these fields can be changed after creation, so an
|
|
197
275
|
// incompatible match can never become the collection the file describes, and
|
|
198
276
|
// reporting it under --dry-run is the point (F2).
|
|
199
|
-
const field = incompatibleField(collection, existing,
|
|
277
|
+
const field = incompatibleField(collection, existing, custodian);
|
|
200
278
|
if (field) {
|
|
201
279
|
const reason = `a collection named "${collection.name}" already exists in the target ` +
|
|
202
280
|
`(${existing.collectionId}) with a different ${field}, which cannot be ` +
|
|
@@ -221,7 +299,8 @@ export function planCollection(collection, resolution, options) {
|
|
|
221
299
|
...base,
|
|
222
300
|
action: "merge",
|
|
223
301
|
targetCollectionId: existing.collectionId,
|
|
224
|
-
|
|
302
|
+
custodian,
|
|
303
|
+
...(resolution.ownerUserId && !resolution.appCustody ? { ownerUserId: resolution.ownerUserId } : {}),
|
|
225
304
|
};
|
|
226
305
|
}
|
|
227
306
|
/**
|
|
@@ -257,13 +336,27 @@ export function groupTargetsByName(rows) {
|
|
|
257
336
|
const matches = byName.get(row.name) ?? [];
|
|
258
337
|
matches.push({
|
|
259
338
|
collectionId: row.collectionId,
|
|
260
|
-
|
|
339
|
+
custodian: rowCustodian(row),
|
|
261
340
|
collectionType: row.collectionType ?? null,
|
|
262
341
|
});
|
|
263
342
|
byName.set(row.name, matches);
|
|
264
343
|
}
|
|
265
344
|
return byName;
|
|
266
345
|
}
|
|
346
|
+
/**
|
|
347
|
+
* The custodian a listing row records. A legacy row written before custody
|
|
348
|
+
* has none; its creator holds the owner row, so it reads as theirs — the
|
|
349
|
+
* server's own reading of such a row.
|
|
350
|
+
*/
|
|
351
|
+
export function rowCustodian(row) {
|
|
352
|
+
if (typeof row.custodian === "string" && row.custodian.length > 0)
|
|
353
|
+
return row.custodian;
|
|
354
|
+
return row.createdBy ? `user:${row.createdBy}` : "app";
|
|
355
|
+
}
|
|
356
|
+
/** The userId a `user:<userId>` custodian names; null for `app`. */
|
|
357
|
+
export function custodianUserId(custodian) {
|
|
358
|
+
return custodian.startsWith("user:") ? custodian.slice("user:".length) : null;
|
|
359
|
+
}
|
|
267
360
|
export function emptyImportSummary() {
|
|
268
361
|
return {
|
|
269
362
|
created: 0,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"collection-export.js","sourceRoot":"","sources":["../../../src/lib/collection-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B
|
|
1
|
+
{"version":3,"file":"collection-export.js","sourceRoot":"","sources":["../../../src/lib/collection-export.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A collection member as the CLI names it: a user id, or `group:<group-id>`,
|
|
3
|
+
* and its role on the collection's five-rung ladder.
|
|
4
|
+
*/
|
|
5
|
+
/** Collection roles, highest first. */
|
|
6
|
+
export declare const COLLECTION_ROLES: readonly ["owner", "manager", "editor", "contributor", "viewer"];
|
|
7
|
+
/** A collection role. */
|
|
8
|
+
export type CollectionRole = (typeof COLLECTION_ROLES)[number];
|
|
9
|
+
/** A member as the member routes take it in a body. */
|
|
10
|
+
export type CollectionPrincipalBody = {
|
|
11
|
+
userId: string;
|
|
12
|
+
} | {
|
|
13
|
+
groupId: string;
|
|
14
|
+
};
|
|
15
|
+
/**
|
|
16
|
+
* Parse `<user-id>` or `group:<group-id>`. Throws, naming the expected
|
|
17
|
+
* shape, for an empty value, an empty group id, or one carrying a
|
|
18
|
+
* separator.
|
|
19
|
+
*/
|
|
20
|
+
export declare function parseCollectionPrincipal(value: string): CollectionPrincipalBody;
|
|
21
|
+
/** Parse a role, or throw naming the five. */
|
|
22
|
+
export declare function parseCollectionRole(value: string): CollectionRole;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A collection member as the CLI names it: a user id, or `group:<group-id>`,
|
|
3
|
+
* and its role on the collection's five-rung ladder.
|
|
4
|
+
*/
|
|
5
|
+
/** Collection roles, highest first. */
|
|
6
|
+
export const COLLECTION_ROLES = ["owner", "manager", "editor", "contributor", "viewer"];
|
|
7
|
+
const GROUP_PREFIX = "group:";
|
|
8
|
+
const SEPARATORS = /[\s#/?%]/;
|
|
9
|
+
/**
|
|
10
|
+
* Parse `<user-id>` or `group:<group-id>`. Throws, naming the expected
|
|
11
|
+
* shape, for an empty value, an empty group id, or one carrying a
|
|
12
|
+
* separator.
|
|
13
|
+
*/
|
|
14
|
+
export function parseCollectionPrincipal(value) {
|
|
15
|
+
const shape = 'A member is a user id or "group:<group-id>"';
|
|
16
|
+
if (typeof value !== "string" || value.length === 0)
|
|
17
|
+
throw new Error(`${shape}.`);
|
|
18
|
+
if (value.startsWith(GROUP_PREFIX)) {
|
|
19
|
+
const groupId = value.slice(GROUP_PREFIX.length);
|
|
20
|
+
if (groupId.length === 0 || SEPARATORS.test(groupId)) {
|
|
21
|
+
throw new Error(`"${value}" does not name a group: ${shape}.`);
|
|
22
|
+
}
|
|
23
|
+
return { groupId };
|
|
24
|
+
}
|
|
25
|
+
if (SEPARATORS.test(value))
|
|
26
|
+
throw new Error(`"${value}" is not a principal: ${shape}.`);
|
|
27
|
+
return { userId: value };
|
|
28
|
+
}
|
|
29
|
+
/** Parse a role, or throw naming the five. */
|
|
30
|
+
export function parseCollectionRole(value) {
|
|
31
|
+
if (COLLECTION_ROLES.includes(value))
|
|
32
|
+
return value;
|
|
33
|
+
throw new Error(`Unknown role "${value}": the role is one of ${COLLECTION_ROLES.join(", ")}.`);
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=collection-principal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collection-principal.js","sourceRoot":"","sources":["../../../src/lib/collection-principal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAU,CAAC;AAQjG,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,MAAM,KAAK,GAAG,6CAA6C,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAClF,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,4BAA4B,KAAK,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,KAAK,GAAG,CAAC,CAAC;IACxF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAuB,CAAC;IAC5F,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,yBAAyB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjG,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Every command group the `primitive` CLI registers, with no status table
|
|
3
|
+
* applied: the declarations-only tree.
|
|
4
|
+
*
|
|
5
|
+
* `registerAllCommands` (register-commands.ts) builds the tree the bin and
|
|
6
|
+
* the tests read: these groups, then the generated status table, then the
|
|
7
|
+
* production prune. `pnpm api-status` builds its tree here instead, reads
|
|
8
|
+
* what each command declares (`declaredCommandStatuses`) and generates the
|
|
9
|
+
* table from it, so this module must never import the table it generates.
|
|
10
|
+
*/
|
|
11
|
+
import type { Command } from "commander";
|
|
12
|
+
/** What {@link registerCommandGroups} accepts. */
|
|
13
|
+
export interface RegisterCommandGroupsOptions {
|
|
14
|
+
/**
|
|
15
|
+
* Whether `config pull|diff|push` reconcile the experimental families.
|
|
16
|
+
* Defaults to this build's flag (`EXPERIMENTAL_APIS`). The commands
|
|
17
|
+
* registered are the same either way.
|
|
18
|
+
*/
|
|
19
|
+
experimental?: boolean;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Register every command group on `program`, init first, then logically
|
|
23
|
+
* grouped. The order is the order `primitive --help` lists them in. No
|
|
24
|
+
* status table is applied and nothing is pruned.
|
|
25
|
+
*
|
|
26
|
+
* @param program The root commander `Command`.
|
|
27
|
+
* @param options Whether the config verbs reconcile the experimental families.
|
|
28
|
+
* @returns The same `program`, with every group registered.
|
|
29
|
+
*/
|
|
30
|
+
export declare function registerCommandGroups(program: Command, options?: RegisterCommandGroupsOptions): Command;
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Every command group the `primitive` CLI registers, with no status table
|
|
3
|
+
* applied: the declarations-only tree.
|
|
4
|
+
*
|
|
5
|
+
* `registerAllCommands` (register-commands.ts) builds the tree the bin and
|
|
6
|
+
* the tests read: these groups, then the generated status table, then the
|
|
7
|
+
* production prune. `pnpm api-status` builds its tree here instead, reads
|
|
8
|
+
* what each command declares (`declaredCommandStatuses`) and generates the
|
|
9
|
+
* table from it, so this module must never import the table it generates.
|
|
10
|
+
*/
|
|
11
|
+
import { EXPERIMENTAL_APIS } from "./generated-build-flags.js";
|
|
12
|
+
import { registerInitCommand } from "../commands/init.js";
|
|
13
|
+
import { registerAuthCommands } from "../commands/auth.js";
|
|
14
|
+
import { registerAppsCommands } from "../commands/apps.js";
|
|
15
|
+
import { registerUsersCommands } from "../commands/users.js";
|
|
16
|
+
import { registerUserPropertiesCommands } from "../commands/user-properties.js";
|
|
17
|
+
import { registerSchemasCommands } from "../commands/schemas.js";
|
|
18
|
+
import { registerWaitlistCommands } from "../commands/waitlist.js";
|
|
19
|
+
import { registerIntegrationsCommands } from "../commands/integrations.js";
|
|
20
|
+
import { registerConnectionsCommands } from "../commands/connections.js";
|
|
21
|
+
import { registerSessionsCommands } from "../commands/sessions.js";
|
|
22
|
+
import { registerAgentSessionsCommands } from "../commands/agent-sessions.js";
|
|
23
|
+
import { registerLocksCommands } from "../commands/locks.js";
|
|
24
|
+
import { registerRateCountersCommands } from "../commands/rate-counters.js";
|
|
25
|
+
import { registerTransitionsCommands } from "../commands/transitions.js";
|
|
26
|
+
import { registerMetadataCommands } from "../commands/metadata.js";
|
|
27
|
+
import { registerPromptsCommands } from "../commands/prompts.js";
|
|
28
|
+
import { registerFunctionsCommands } from "../commands/functions.js";
|
|
29
|
+
import { registerAdminsCommands } from "../commands/admins.js";
|
|
30
|
+
import { registerAnalyticsCommands } from "../commands/analytics.js";
|
|
31
|
+
import { registerUsageCommands } from "../commands/usage.js";
|
|
32
|
+
import { registerHostingCommands } from "../commands/hosting.js";
|
|
33
|
+
import { registerConfigSyncCommands } from "../commands/sync.js";
|
|
34
|
+
import { registerConfigCommands } from "../commands/config.js";
|
|
35
|
+
import { registerComparisonsCommands } from "../commands/comparisons.js";
|
|
36
|
+
import { registerTokensCommands } from "../commands/tokens.js";
|
|
37
|
+
import { registerDatabasesCommands } from "../commands/databases.js";
|
|
38
|
+
import { registerGroupsCommands } from "../commands/groups.js";
|
|
39
|
+
import { registerRuleSetsCommands } from "../commands/rule-sets.js";
|
|
40
|
+
import { registerDatabaseTypeConfigsCommands } from "../commands/database-type-configs.js";
|
|
41
|
+
import { registerGuidesCommands } from "../commands/guides.js";
|
|
42
|
+
import { registerDocumentsCommands } from "../commands/documents.js";
|
|
43
|
+
import { registerDb3Commands } from "../commands/db3.js";
|
|
44
|
+
import { registerDb3TypesCommands } from "../commands/db3-types.js";
|
|
45
|
+
import { registerEmailTemplatesCommands } from "../commands/email-templates.js";
|
|
46
|
+
import { registerCollectionsCommands } from "../commands/collections.js";
|
|
47
|
+
import { registerMetadataCategoryConfigsCommands } from "../commands/metadata-category-configs.js";
|
|
48
|
+
import { registerSkillCommands } from "../commands/skill.js";
|
|
49
|
+
import { registerSecretsCommands } from "../commands/secrets.js";
|
|
50
|
+
import { registerVarsCommands } from "../commands/vars.js";
|
|
51
|
+
import { registerBlobBucketsCommands } from "../commands/blob-buckets.js";
|
|
52
|
+
import { registerEnvCommands } from "../commands/env.js";
|
|
53
|
+
/**
|
|
54
|
+
* Register every command group on `program`, init first, then logically
|
|
55
|
+
* grouped. The order is the order `primitive --help` lists them in. No
|
|
56
|
+
* status table is applied and nothing is pruned.
|
|
57
|
+
*
|
|
58
|
+
* @param program The root commander `Command`.
|
|
59
|
+
* @param options Whether the config verbs reconcile the experimental families.
|
|
60
|
+
* @returns The same `program`, with every group registered.
|
|
61
|
+
*/
|
|
62
|
+
export function registerCommandGroups(program, options = {}) {
|
|
63
|
+
const experimental = options.experimental ?? EXPERIMENTAL_APIS;
|
|
64
|
+
registerInitCommand(program);
|
|
65
|
+
registerEnvCommands(program);
|
|
66
|
+
registerAuthCommands(program);
|
|
67
|
+
registerAppsCommands(program);
|
|
68
|
+
registerUsersCommands(program);
|
|
69
|
+
registerUserPropertiesCommands(program);
|
|
70
|
+
registerSchemasCommands(program);
|
|
71
|
+
registerWaitlistCommands(program);
|
|
72
|
+
registerIntegrationsCommands(program);
|
|
73
|
+
registerConnectionsCommands(program);
|
|
74
|
+
registerSessionsCommands(program);
|
|
75
|
+
registerAgentSessionsCommands(program);
|
|
76
|
+
registerLocksCommands(program);
|
|
77
|
+
registerRateCountersCommands(program);
|
|
78
|
+
registerTransitionsCommands(program);
|
|
79
|
+
registerMetadataCommands(program);
|
|
80
|
+
registerPromptsCommands(program);
|
|
81
|
+
registerFunctionsCommands(program);
|
|
82
|
+
registerAdminsCommands(program);
|
|
83
|
+
registerAnalyticsCommands(program);
|
|
84
|
+
registerUsageCommands(program);
|
|
85
|
+
registerHostingCommands(program);
|
|
86
|
+
// One noun owns the TOML configuration tree (issue #2759): `config` carries
|
|
87
|
+
// the local authoring verbs and the server-reconciling verbs that used to be
|
|
88
|
+
// the `sync` group, so the group is created once and handed on.
|
|
89
|
+
registerConfigSyncCommands(registerConfigCommands(program), { experimental });
|
|
90
|
+
registerComparisonsCommands(program);
|
|
91
|
+
registerTokensCommands(program);
|
|
92
|
+
registerDatabasesCommands(program);
|
|
93
|
+
registerGroupsCommands(program);
|
|
94
|
+
registerRuleSetsCommands(program);
|
|
95
|
+
registerDatabaseTypeConfigsCommands(program);
|
|
96
|
+
registerGuidesCommands(program);
|
|
97
|
+
registerDocumentsCommands(program);
|
|
98
|
+
registerDb3Commands(program);
|
|
99
|
+
registerDb3TypesCommands(program);
|
|
100
|
+
registerEmailTemplatesCommands(program);
|
|
101
|
+
registerCollectionsCommands(program);
|
|
102
|
+
registerMetadataCategoryConfigsCommands(program);
|
|
103
|
+
registerSkillCommands(program);
|
|
104
|
+
registerSecretsCommands(program);
|
|
105
|
+
registerVarsCommands(program);
|
|
106
|
+
registerBlobBucketsCommands(program);
|
|
107
|
+
return program;
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=command-groups.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-groups.js","sourceRoot":"","sources":["../../../src/lib/command-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,mCAAmC,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,uCAAuC,EAAE,MAAM,0CAA0C,CAAC;AACnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAYzD;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,UAAwC,EAAE;IAChG,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,iBAAiB,CAAC;IAC/D,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACxC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACtC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACvC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACtC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,4EAA4E;IAC5E,6EAA6E;IAC7E,gEAAgE;IAChE,0BAA0B,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9E,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,mCAAmC,CAAC,OAAO,CAAC,CAAC;IAC7C,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACxC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,uCAAuC,CAAC,OAAO,CAAC,CAAC;IACjD,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A command's API status: how stable the operations behind it are, and
|
|
3
|
+
* whether it is deprecated.
|
|
4
|
+
*
|
|
5
|
+
* Every command's status is a row of the generated table
|
|
6
|
+
* `generated-command-status.ts`, which `registerAllCommands` copies onto the
|
|
7
|
+
* tree ({@link applyCommandStatusTable}) and the `help --json` manifest emits
|
|
8
|
+
* as `status`. `pnpm api-status --write` generates the rows: a command that
|
|
9
|
+
* calls an operation takes the status derived from its calls; one that calls
|
|
10
|
+
* none takes what {@link commandStatus} declares on it, else on its nearest
|
|
11
|
+
* ancestor, so a family's local commands are declared once on their noun.
|
|
12
|
+
*
|
|
13
|
+
* A request the command issues only under a named flag, selector value or
|
|
14
|
+
* local file of one family is a variant: the operation map lists it as
|
|
15
|
+
* `<command>#<variant> via <helper>`, and the generated row carries that
|
|
16
|
+
* variant's status under `variants`. A request the command issues on every
|
|
17
|
+
* run is never a variant, whatever its arguments. Variants are not inherited.
|
|
18
|
+
*
|
|
19
|
+
* Declare a status only on a noun, a container or a command that reaches no
|
|
20
|
+
* operation, and never with `variants`: `pnpm api-status --check` fails a
|
|
21
|
+
* declaration on a command that derives one. A command that must stay less
|
|
22
|
+
* stable than it derives records it in the operation map's
|
|
23
|
+
* `reasons.cli["<command>"].declared`.
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* const widgets = program.command("widgets").description("Manage widgets");
|
|
27
|
+
* commandStatus(widgets, { stability: "beta" });
|
|
28
|
+
*/
|
|
29
|
+
import type { Command } from "commander";
|
|
30
|
+
/** The stability levels a command may declare, most stable first. */
|
|
31
|
+
export declare const COMMAND_STABILITY_LEVELS: readonly ["production", "beta", "experimental"];
|
|
32
|
+
/** One of {@link COMMAND_STABILITY_LEVELS}. */
|
|
33
|
+
export type CommandStability = (typeof COMMAND_STABILITY_LEVELS)[number];
|
|
34
|
+
/** The declared status of one variant of a command. */
|
|
35
|
+
export interface CommandVariantStatus {
|
|
36
|
+
stability: CommandStability;
|
|
37
|
+
deprecated: boolean;
|
|
38
|
+
}
|
|
39
|
+
/** A command's declared status, as the manifest emits it. */
|
|
40
|
+
export interface CommandStatus {
|
|
41
|
+
stability: CommandStability;
|
|
42
|
+
deprecated: boolean;
|
|
43
|
+
/** Per-variant statuses, keyed by the operation map's `#variant` name. */
|
|
44
|
+
variants?: Record<string, CommandVariantStatus>;
|
|
45
|
+
}
|
|
46
|
+
/** What {@link commandStatus} accepts: `deprecated` defaults to false. */
|
|
47
|
+
export interface CommandStatusDeclaration {
|
|
48
|
+
stability: CommandStability;
|
|
49
|
+
deprecated?: boolean;
|
|
50
|
+
variants?: Record<string, {
|
|
51
|
+
stability: CommandStability;
|
|
52
|
+
deprecated?: boolean;
|
|
53
|
+
}>;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Declare `cmd`'s status. A second call replaces the first.
|
|
57
|
+
*
|
|
58
|
+
* @param cmd The command, as returned by `.command(...)`, or a noun whose
|
|
59
|
+
* commands all share the status.
|
|
60
|
+
* @param status Its stability, `deprecated: true` when it is deprecated, and
|
|
61
|
+
* the status of each variant it declares.
|
|
62
|
+
* @returns `cmd`, so a registration can chain it.
|
|
63
|
+
* @throws When a level is not production, beta or experimental, or a variant
|
|
64
|
+
* name is not letters, digits, `-` and `_`.
|
|
65
|
+
*/
|
|
66
|
+
export declare function commandStatus(cmd: Command, status: CommandStatusDeclaration): Command;
|
|
67
|
+
/**
|
|
68
|
+
* The status declared on `cmd` itself, or `undefined` when none was.
|
|
69
|
+
*
|
|
70
|
+
* @param cmd A registered command.
|
|
71
|
+
*/
|
|
72
|
+
export declare function statusOf(cmd: Command): CommandStatus | undefined;
|
|
73
|
+
/**
|
|
74
|
+
* The status `cmd` has: its own declaration, variants included, else the
|
|
75
|
+
* nearest ancestor's stability and deprecation (never its variants), else
|
|
76
|
+
* `undefined` (production, not deprecated).
|
|
77
|
+
*
|
|
78
|
+
* @param cmd A registered command.
|
|
79
|
+
*/
|
|
80
|
+
export declare function effectiveStatus(cmd: Command): CommandStatus | undefined;
|
|
81
|
+
/**
|
|
82
|
+
* Declare the status of `parent`'s direct subcommand `name`, for a
|
|
83
|
+
* registration chain too long to wrap in {@link commandStatus}. Call it after
|
|
84
|
+
* the subcommand is registered.
|
|
85
|
+
*
|
|
86
|
+
* @param parent The command the subcommand was registered on.
|
|
87
|
+
* @param name The subcommand's name.
|
|
88
|
+
* @param status As {@link commandStatus} takes it.
|
|
89
|
+
* @returns The subcommand.
|
|
90
|
+
* @throws When `parent` has no subcommand `name`, or as {@link commandStatus}.
|
|
91
|
+
*/
|
|
92
|
+
export declare function subcommandStatus(parent: Command, name: string, status: CommandStatusDeclaration): Command;
|
|
93
|
+
/** What a command declares, as {@link declaredCommandStatuses} reports it. */
|
|
94
|
+
export interface DeclaredCommandStatus {
|
|
95
|
+
/** The command's own `commandStatus()` declaration, variants included. */
|
|
96
|
+
own?: CommandStatus;
|
|
97
|
+
/** The nearest declaring ancestor's stability and deprecation. */
|
|
98
|
+
inherited?: CommandVariantStatus;
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* What every command under `program` declares, before any table is applied:
|
|
102
|
+
* its own `commandStatus()` declaration and its nearest declaring ancestor's
|
|
103
|
+
* stability and deprecation. `pnpm api-status` plans the generated status
|
|
104
|
+
* table from it.
|
|
105
|
+
*
|
|
106
|
+
* @example
|
|
107
|
+
* declaredCommandStatuses(program)["users query"];
|
|
108
|
+
* // { inherited: { stability: "production", deprecated: false } }
|
|
109
|
+
*
|
|
110
|
+
* @param program The root command, after every group is registered.
|
|
111
|
+
* @returns The declarations by command path (`"config push"`); a command
|
|
112
|
+
* with neither has an empty entry.
|
|
113
|
+
* @throws When {@link applyCommandStatusTable} already ran on `program`.
|
|
114
|
+
*/
|
|
115
|
+
export declare function declaredCommandStatuses(program: Command): Record<string, DeclaredCommandStatus>;
|
|
116
|
+
/**
|
|
117
|
+
* Give every command under `program` its row of the generated status table,
|
|
118
|
+
* so {@link effectiveStatus}, the `help --json` manifest and
|
|
119
|
+
* {@link pruneExperimentalCommands} read it. A row replaces the command's own
|
|
120
|
+
* declaration; a row for a path the tree lacks is ignored.
|
|
121
|
+
*
|
|
122
|
+
* @param program The root command, after every group is registered.
|
|
123
|
+
* @param table The rows by command path (`COMMAND_STATUS`).
|
|
124
|
+
* @param options `strict` (a production build): a command with no row throws
|
|
125
|
+
* before any row is applied. Otherwise it keeps its declared chain.
|
|
126
|
+
* @throws Under `strict`, naming the first command with no row.
|
|
127
|
+
*/
|
|
128
|
+
export declare function applyCommandStatusTable(program: Command, table: Readonly<Record<string, CommandStatus>>, options: {
|
|
129
|
+
strict: boolean;
|
|
130
|
+
}): void;
|
|
131
|
+
/**
|
|
132
|
+
* Remove every experimental command from `program`'s tree, for a production
|
|
133
|
+
* build: a command whose {@link effectiveStatus} is experimental goes, with
|
|
134
|
+
* everything under it. An experimental noun that has a beta or production
|
|
135
|
+
* descendant stays as that descendant's container and takes the least stable
|
|
136
|
+
* status among its remaining commands, so the tree reads no experimental
|
|
137
|
+
* status anywhere. A noun left with no subcommand and no action of its own
|
|
138
|
+
* goes too.
|
|
139
|
+
*
|
|
140
|
+
* @example
|
|
141
|
+
* // metadata (experimental) keeps `report` (beta) and becomes beta itself.
|
|
142
|
+
* pruneExperimentalCommands(program); // ["metadata delete", "metadata get", …]
|
|
143
|
+
*
|
|
144
|
+
* @param program The root command, after every group is registered.
|
|
145
|
+
* @returns The paths of the removed commands, root name excluded, sorted.
|
|
146
|
+
*/
|
|
147
|
+
export declare function pruneExperimentalCommands(program: Command): string[];
|