@justscale/core 0.1.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/LICENSE +21 -0
- package/README.md +261 -0
- package/bin/just.js +34 -0
- package/dist/app.d.ts +56 -0
- package/dist/app.d.ts.map +1 -0
- package/dist/app.js +182 -0
- package/dist/app.js.map +1 -0
- package/dist/builder/build-context.d.ts +8 -0
- package/dist/builder/build-context.d.ts.map +1 -0
- package/dist/builder/build-context.js +4 -0
- package/dist/builder/build-context.js.map +1 -0
- package/dist/builder/builder.d.ts +60 -0
- package/dist/builder/builder.d.ts.map +1 -0
- package/dist/builder/builder.js +72 -0
- package/dist/builder/builder.js.map +1 -0
- package/dist/builder/create-builder.d.ts +36 -0
- package/dist/builder/create-builder.d.ts.map +1 -0
- package/dist/builder/create-builder.js +66 -0
- package/dist/builder/create-builder.js.map +1 -0
- package/dist/builder/execute.d.ts +37 -0
- package/dist/builder/execute.d.ts.map +1 -0
- package/dist/builder/execute.js +62 -0
- package/dist/builder/execute.js.map +1 -0
- package/dist/builder/feature-builder.d.ts +147 -0
- package/dist/builder/feature-builder.d.ts.map +1 -0
- package/dist/builder/feature-builder.js +138 -0
- package/dist/builder/feature-builder.js.map +1 -0
- package/dist/builder/index.d.ts +35 -0
- package/dist/builder/index.d.ts.map +1 -0
- package/dist/builder/index.js +37 -0
- package/dist/builder/index.js.map +1 -0
- package/dist/builder/plugin.d.ts +90 -0
- package/dist/builder/plugin.d.ts.map +1 -0
- package/dist/builder/plugin.js +101 -0
- package/dist/builder/plugin.js.map +1 -0
- package/dist/builder/plugins/query.d.ts +31 -0
- package/dist/builder/plugins/query.d.ts.map +1 -0
- package/dist/builder/plugins/query.js +42 -0
- package/dist/builder/plugins/query.js.map +1 -0
- package/dist/builder/plugins/validation.d.ts +12 -0
- package/dist/builder/plugins/validation.d.ts.map +1 -0
- package/dist/builder/plugins/validation.js +12 -0
- package/dist/builder/plugins/validation.js.map +1 -0
- package/dist/builder/sort.d.ts +27 -0
- package/dist/builder/sort.d.ts.map +1 -0
- package/dist/builder/sort.js +210 -0
- package/dist/builder/sort.js.map +1 -0
- package/dist/builder/stop.d.ts +24 -0
- package/dist/builder/stop.d.ts.map +1 -0
- package/dist/builder/stop.js +27 -0
- package/dist/builder/stop.js.map +1 -0
- package/dist/builder/test/permits-type-spike.d.ts +8 -0
- package/dist/builder/test/permits-type-spike.d.ts.map +1 -0
- package/dist/builder/test/permits-type-spike.js +117 -0
- package/dist/builder/test/permits-type-spike.js.map +1 -0
- package/dist/builder/types.d.ts +678 -0
- package/dist/builder/types.d.ts.map +1 -0
- package/dist/builder/types.js +98 -0
- package/dist/builder/types.js.map +1 -0
- package/dist/builder/validation.d.ts +101 -0
- package/dist/builder/validation.d.ts.map +1 -0
- package/dist/builder/validation.js +335 -0
- package/dist/builder/validation.js.map +1 -0
- package/dist/cli/adapter.d.ts +23 -0
- package/dist/cli/adapter.d.ts.map +1 -0
- package/dist/cli/adapter.js +26 -0
- package/dist/cli/adapter.js.map +1 -0
- package/dist/cli/args.d.ts +150 -0
- package/dist/cli/args.d.ts.map +1 -0
- package/dist/cli/args.js +172 -0
- package/dist/cli/args.js.map +1 -0
- package/dist/cli/assemble.d.ts +20 -0
- package/dist/cli/assemble.d.ts.map +1 -0
- package/dist/cli/assemble.js +55 -0
- package/dist/cli/assemble.js.map +1 -0
- package/dist/cli/bin/main.d.ts +26 -0
- package/dist/cli/bin/main.d.ts.map +1 -0
- package/dist/cli/bin/main.js +475 -0
- package/dist/cli/bin/main.js.map +1 -0
- package/dist/cli/build/migrations-plugin.d.ts +21 -0
- package/dist/cli/build/migrations-plugin.d.ts.map +1 -0
- package/dist/cli/build/migrations-plugin.js +41 -0
- package/dist/cli/build/migrations-plugin.js.map +1 -0
- package/dist/cli/build/process-plugin.d.ts +29 -0
- package/dist/cli/build/process-plugin.d.ts.map +1 -0
- package/dist/cli/build/process-plugin.js +66 -0
- package/dist/cli/build/process-plugin.js.map +1 -0
- package/dist/cli/builder/create-cli-builder.d.ts +42 -0
- package/dist/cli/builder/create-cli-builder.d.ts.map +1 -0
- package/dist/cli/builder/create-cli-builder.js +104 -0
- package/dist/cli/builder/create-cli-builder.js.map +1 -0
- package/dist/cli/builder/index.d.ts +8 -0
- package/dist/cli/builder/index.d.ts.map +1 -0
- package/dist/cli/builder/index.js +7 -0
- package/dist/cli/builder/index.js.map +1 -0
- package/dist/cli/builder/types.d.ts +113 -0
- package/dist/cli/builder/types.d.ts.map +1 -0
- package/dist/cli/builder/types.js +7 -0
- package/dist/cli/builder/types.js.map +1 -0
- package/dist/cli/cluster.d.ts +8 -0
- package/dist/cli/cluster.d.ts.map +1 -0
- package/dist/cli/cluster.js +145 -0
- package/dist/cli/cluster.js.map +1 -0
- package/dist/cli/current-app.d.ts +36 -0
- package/dist/cli/current-app.d.ts.map +1 -0
- package/dist/cli/current-app.js +21 -0
- package/dist/cli/current-app.js.map +1 -0
- package/dist/cli/define-app.d.ts +35 -0
- package/dist/cli/define-app.d.ts.map +1 -0
- package/dist/cli/define-app.js +79 -0
- package/dist/cli/define-app.js.map +1 -0
- package/dist/cli/define-main.d.ts +33 -0
- package/dist/cli/define-main.d.ts.map +1 -0
- package/dist/cli/define-main.js +67 -0
- package/dist/cli/define-main.js.map +1 -0
- package/dist/cli/define-project.d.ts +93 -0
- package/dist/cli/define-project.d.ts.map +1 -0
- package/dist/cli/define-project.js +85 -0
- package/dist/cli/define-project.js.map +1 -0
- package/dist/cli/dev-server.d.ts +20 -0
- package/dist/cli/dev-server.d.ts.map +1 -0
- package/dist/cli/dev-server.js +131 -0
- package/dist/cli/dev-server.js.map +1 -0
- package/dist/cli/discovery.d.ts +29 -0
- package/dist/cli/discovery.d.ts.map +1 -0
- package/dist/cli/discovery.js +142 -0
- package/dist/cli/discovery.js.map +1 -0
- package/dist/cli/factory.d.ts +43 -0
- package/dist/cli/factory.d.ts.map +1 -0
- package/dist/cli/factory.js +52 -0
- package/dist/cli/factory.js.map +1 -0
- package/dist/cli/generators/ai.d.ts +3 -0
- package/dist/cli/generators/ai.d.ts.map +1 -0
- package/dist/cli/generators/ai.js +65 -0
- package/dist/cli/generators/ai.js.map +1 -0
- package/dist/cli/generators/ci.d.ts +5 -0
- package/dist/cli/generators/ci.d.ts.map +1 -0
- package/dist/cli/generators/ci.js +102 -0
- package/dist/cli/generators/ci.js.map +1 -0
- package/dist/cli/generators/detect.d.ts +15 -0
- package/dist/cli/generators/detect.d.ts.map +1 -0
- package/dist/cli/generators/detect.js +75 -0
- package/dist/cli/generators/detect.js.map +1 -0
- package/dist/cli/generators/ide.d.ts +3 -0
- package/dist/cli/generators/ide.d.ts.map +1 -0
- package/dist/cli/generators/ide.js +179 -0
- package/dist/cli/generators/ide.js.map +1 -0
- package/dist/cli/generators/index.d.ts +5 -0
- package/dist/cli/generators/index.d.ts.map +1 -0
- package/dist/cli/generators/index.js +5 -0
- package/dist/cli/generators/index.js.map +1 -0
- package/dist/cli/index.d.ts +81 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +88 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/io.d.ts +131 -0
- package/dist/cli/io.d.ts.map +1 -0
- package/dist/cli/io.js +373 -0
- package/dist/cli/io.js.map +1 -0
- package/dist/cli/mcp/server.d.ts +23 -0
- package/dist/cli/mcp/server.d.ts.map +1 -0
- package/dist/cli/mcp/server.js +148 -0
- package/dist/cli/mcp/server.js.map +1 -0
- package/dist/cli/parser.d.ts +106 -0
- package/dist/cli/parser.d.ts.map +1 -0
- package/dist/cli/parser.js +520 -0
- package/dist/cli/parser.js.map +1 -0
- package/dist/cli/runner.d.ts +75 -0
- package/dist/cli/runner.d.ts.map +1 -0
- package/dist/cli/runner.js +422 -0
- package/dist/cli/runner.js.map +1 -0
- package/dist/cli/service.d.ts +61 -0
- package/dist/cli/service.d.ts.map +1 -0
- package/dist/cli/service.js +95 -0
- package/dist/cli/service.js.map +1 -0
- package/dist/cli/types.d.ts +47 -0
- package/dist/cli/types.d.ts.map +1 -0
- package/dist/cli/types.js +20 -0
- package/dist/cli/types.js.map +1 -0
- package/dist/cli/wizard.d.ts +11 -0
- package/dist/cli/wizard.d.ts.map +1 -0
- package/dist/cli/wizard.js +2 -0
- package/dist/cli/wizard.js.map +1 -0
- package/dist/cli/workspace-controller.d.ts +36 -0
- package/dist/cli/workspace-controller.d.ts.map +1 -0
- package/dist/cli/workspace-controller.js +896 -0
- package/dist/cli/workspace-controller.js.map +1 -0
- package/dist/cluster/client.d.ts +101 -0
- package/dist/cluster/client.d.ts.map +1 -0
- package/dist/cluster/client.js +256 -0
- package/dist/cluster/client.js.map +1 -0
- package/dist/cluster/cluster.d.ts +82 -0
- package/dist/cluster/cluster.d.ts.map +1 -0
- package/dist/cluster/cluster.js +27 -0
- package/dist/cluster/cluster.js.map +1 -0
- package/dist/cluster/coordinator/cluster-node.model.d.ts +14 -0
- package/dist/cluster/coordinator/cluster-node.model.d.ts.map +1 -0
- package/dist/cluster/coordinator/cluster-node.model.js +15 -0
- package/dist/cluster/coordinator/cluster-node.model.js.map +1 -0
- package/dist/cluster/coordinator/cluster-signals.d.ts +45 -0
- package/dist/cluster/coordinator/cluster-signals.d.ts.map +1 -0
- package/dist/cluster/coordinator/cluster-signals.js +24 -0
- package/dist/cluster/coordinator/cluster-signals.js.map +1 -0
- package/dist/cluster/coordinator/coordinator.process.d.ts +21 -0
- package/dist/cluster/coordinator/coordinator.process.d.ts.map +1 -0
- package/dist/cluster/coordinator/coordinator.process.js +221 -0
- package/dist/cluster/coordinator/coordinator.process.js.map +1 -0
- package/dist/cluster/coordinator/index.d.ts +13 -0
- package/dist/cluster/coordinator/index.d.ts.map +1 -0
- package/dist/cluster/coordinator/index.js +13 -0
- package/dist/cluster/coordinator/index.js.map +1 -0
- package/dist/cluster/coordinator/node-lifecycle.d.ts +31 -0
- package/dist/cluster/coordinator/node-lifecycle.d.ts.map +1 -0
- package/dist/cluster/coordinator/node-lifecycle.js +178 -0
- package/dist/cluster/coordinator/node-lifecycle.js.map +1 -0
- package/dist/cluster/index.d.ts +45 -0
- package/dist/cluster/index.d.ts.map +1 -0
- package/dist/cluster/index.js +57 -0
- package/dist/cluster/index.js.map +1 -0
- package/dist/cluster/protocol.d.ts +204 -0
- package/dist/cluster/protocol.d.ts.map +1 -0
- package/dist/cluster/protocol.js +274 -0
- package/dist/cluster/protocol.js.map +1 -0
- package/dist/cluster/scheduled-task/builder.d.ts +24 -0
- package/dist/cluster/scheduled-task/builder.d.ts.map +1 -0
- package/dist/cluster/scheduled-task/builder.js +63 -0
- package/dist/cluster/scheduled-task/builder.js.map +1 -0
- package/dist/cluster/scheduled-task/factory.d.ts +76 -0
- package/dist/cluster/scheduled-task/factory.d.ts.map +1 -0
- package/dist/cluster/scheduled-task/factory.js +64 -0
- package/dist/cluster/scheduled-task/factory.js.map +1 -0
- package/dist/cluster/scheduled-task/index.d.ts +43 -0
- package/dist/cluster/scheduled-task/index.d.ts.map +1 -0
- package/dist/cluster/scheduled-task/index.js +45 -0
- package/dist/cluster/scheduled-task/index.js.map +1 -0
- package/dist/cluster/scheduled-task/transport.d.ts +12 -0
- package/dist/cluster/scheduled-task/transport.d.ts.map +1 -0
- package/dist/cluster/scheduled-task/transport.js +146 -0
- package/dist/cluster/scheduled-task/transport.js.map +1 -0
- package/dist/cluster/scheduled-task/types.d.ts +89 -0
- package/dist/cluster/scheduled-task/types.d.ts.map +1 -0
- package/dist/cluster/scheduled-task/types.js +7 -0
- package/dist/cluster/scheduled-task/types.js.map +1 -0
- package/dist/cluster/server.d.ts +87 -0
- package/dist/cluster/server.d.ts.map +1 -0
- package/dist/cluster/server.js +290 -0
- package/dist/cluster/server.js.map +1 -0
- package/dist/cluster/transport.d.ts +86 -0
- package/dist/cluster/transport.d.ts.map +1 -0
- package/dist/cluster/transport.js +138 -0
- package/dist/cluster/transport.js.map +1 -0
- package/dist/core/container-hooks.d.ts +22 -0
- package/dist/core/container-hooks.d.ts.map +1 -0
- package/dist/core/container-hooks.js +29 -0
- package/dist/core/container-hooks.js.map +1 -0
- package/dist/core/container-reflection.d.ts +71 -0
- package/dist/core/container-reflection.d.ts.map +1 -0
- package/dist/core/container-reflection.js +60 -0
- package/dist/core/container-reflection.js.map +1 -0
- package/dist/core/context.d.ts +146 -0
- package/dist/core/context.d.ts.map +1 -0
- package/dist/core/context.js +155 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/contribution.d.ts +152 -0
- package/dist/core/contribution.d.ts.map +1 -0
- package/dist/core/contribution.js +213 -0
- package/dist/core/contribution.js.map +1 -0
- package/dist/core/controller.contextual.d.ts +193 -0
- package/dist/core/controller.contextual.d.ts.map +1 -0
- package/dist/core/controller.contextual.js +459 -0
- package/dist/core/controller.contextual.js.map +1 -0
- package/dist/core/controller.d.ts +510 -0
- package/dist/core/controller.d.ts.map +1 -0
- package/dist/core/controller.js +411 -0
- package/dist/core/controller.js.map +1 -0
- package/dist/core/controller.procedure.d.ts +147 -0
- package/dist/core/controller.procedure.d.ts.map +1 -0
- package/dist/core/controller.procedure.js +115 -0
- package/dist/core/controller.procedure.js.map +1 -0
- package/dist/core/disposable.d.ts +126 -0
- package/dist/core/disposable.d.ts.map +1 -0
- package/dist/core/disposable.js +179 -0
- package/dist/core/disposable.js.map +1 -0
- package/dist/core/hmr.d.ts +83 -0
- package/dist/core/hmr.d.ts.map +1 -0
- package/dist/core/hmr.js +211 -0
- package/dist/core/hmr.js.map +1 -0
- package/dist/core/index.d.ts +17 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +25 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/internal/routes.d.ts +26 -0
- package/dist/core/internal/routes.d.ts.map +1 -0
- package/dist/core/internal/routes.js +48 -0
- package/dist/core/internal/routes.js.map +1 -0
- package/dist/core/lifecycle-impl.d.ts +45 -0
- package/dist/core/lifecycle-impl.d.ts.map +1 -0
- package/dist/core/lifecycle-impl.js +102 -0
- package/dist/core/lifecycle-impl.js.map +1 -0
- package/dist/core/lifecycle.d.ts +86 -0
- package/dist/core/lifecycle.d.ts.map +1 -0
- package/dist/core/lifecycle.js +38 -0
- package/dist/core/lifecycle.js.map +1 -0
- package/dist/core/logger.d.ts +282 -0
- package/dist/core/logger.d.ts.map +1 -0
- package/dist/core/logger.js +368 -0
- package/dist/core/logger.js.map +1 -0
- package/dist/core/middleware.d.ts +108 -0
- package/dist/core/middleware.d.ts.map +1 -0
- package/dist/core/middleware.js +60 -0
- package/dist/core/middleware.js.map +1 -0
- package/dist/core/openapi-methods.d.ts +61 -0
- package/dist/core/openapi-methods.d.ts.map +1 -0
- package/dist/core/openapi-methods.js +53 -0
- package/dist/core/openapi-methods.js.map +1 -0
- package/dist/core/plugin.d.ts +209 -0
- package/dist/core/plugin.d.ts.map +1 -0
- package/dist/core/plugin.js +36 -0
- package/dist/core/plugin.js.map +1 -0
- package/dist/core/scope-bridge.d.ts +19 -0
- package/dist/core/scope-bridge.d.ts.map +1 -0
- package/dist/core/scope-bridge.js +34 -0
- package/dist/core/scope-bridge.js.map +1 -0
- package/dist/core/service.d.ts +429 -0
- package/dist/core/service.d.ts.map +1 -0
- package/dist/core/service.js +875 -0
- package/dist/core/service.js.map +1 -0
- package/dist/features/channel/backend.d.ts +98 -0
- package/dist/features/channel/backend.d.ts.map +1 -0
- package/dist/features/channel/backend.js +75 -0
- package/dist/features/channel/backend.js.map +1 -0
- package/dist/features/channel/channel.d.ts +18 -0
- package/dist/features/channel/channel.d.ts.map +1 -0
- package/dist/features/channel/channel.js +219 -0
- package/dist/features/channel/channel.js.map +1 -0
- package/dist/features/channel/channels.d.ts +87 -0
- package/dist/features/channel/channels.d.ts.map +1 -0
- package/dist/features/channel/channels.js +252 -0
- package/dist/features/channel/channels.js.map +1 -0
- package/dist/features/channel/feature.d.ts +40 -0
- package/dist/features/channel/feature.d.ts.map +1 -0
- package/dist/features/channel/feature.js +44 -0
- package/dist/features/channel/feature.js.map +1 -0
- package/dist/features/channel/index.d.ts +41 -0
- package/dist/features/channel/index.d.ts.map +1 -0
- package/dist/features/channel/index.js +41 -0
- package/dist/features/channel/index.js.map +1 -0
- package/dist/features/channel/types.d.ts +165 -0
- package/dist/features/channel/types.d.ts.map +1 -0
- package/dist/features/channel/types.js +10 -0
- package/dist/features/channel/types.js.map +1 -0
- package/dist/features/config/cli/config-controller.d.ts +77 -0
- package/dist/features/config/cli/config-controller.d.ts.map +1 -0
- package/dist/features/config/cli/config-controller.js +209 -0
- package/dist/features/config/cli/config-controller.js.map +1 -0
- package/dist/features/config/cli/index.d.ts +9 -0
- package/dist/features/config/cli/index.d.ts.map +1 -0
- package/dist/features/config/cli/index.js +9 -0
- package/dist/features/config/cli/index.js.map +1 -0
- package/dist/features/config/cli/profile-controller.d.ts +87 -0
- package/dist/features/config/cli/profile-controller.d.ts.map +1 -0
- package/dist/features/config/cli/profile-controller.js +223 -0
- package/dist/features/config/cli/profile-controller.js.map +1 -0
- package/dist/features/config/cli/utils.d.ts +14 -0
- package/dist/features/config/cli/utils.d.ts.map +1 -0
- package/dist/features/config/cli/utils.js +29 -0
- package/dist/features/config/cli/utils.js.map +1 -0
- package/dist/features/config/config-of.d.ts +36 -0
- package/dist/features/config/config-of.d.ts.map +1 -0
- package/dist/features/config/config-of.js +36 -0
- package/dist/features/config/config-of.js.map +1 -0
- package/dist/features/config/config-service.d.ts +54 -0
- package/dist/features/config/config-service.d.ts.map +1 -0
- package/dist/features/config/config-service.js +184 -0
- package/dist/features/config/config-service.js.map +1 -0
- package/dist/features/config/create-config.d.ts +21 -0
- package/dist/features/config/create-config.d.ts.map +1 -0
- package/dist/features/config/create-config.js +16 -0
- package/dist/features/config/create-config.js.map +1 -0
- package/dist/features/config/define-config-partial.d.ts +13 -0
- package/dist/features/config/define-config-partial.d.ts.map +1 -0
- package/dist/features/config/define-config-partial.js +19 -0
- package/dist/features/config/define-config-partial.js.map +1 -0
- package/dist/features/config/env-service.d.ts +54 -0
- package/dist/features/config/env-service.d.ts.map +1 -0
- package/dist/features/config/env-service.js +115 -0
- package/dist/features/config/env-service.js.map +1 -0
- package/dist/features/config/file-watcher.d.ts +13 -0
- package/dist/features/config/file-watcher.d.ts.map +1 -0
- package/dist/features/config/file-watcher.js +98 -0
- package/dist/features/config/file-watcher.js.map +1 -0
- package/dist/features/config/index.d.ts +21 -0
- package/dist/features/config/index.d.ts.map +1 -0
- package/dist/features/config/index.js +24 -0
- package/dist/features/config/index.js.map +1 -0
- package/dist/features/config/profile-service.d.ts +59 -0
- package/dist/features/config/profile-service.d.ts.map +1 -0
- package/dist/features/config/profile-service.js +114 -0
- package/dist/features/config/profile-service.js.map +1 -0
- package/dist/features/config/types.d.ts +38 -0
- package/dist/features/config/types.d.ts.map +1 -0
- package/dist/features/config/types.js +17 -0
- package/dist/features/config/types.js.map +1 -0
- package/dist/features/contract/contract.d.ts +264 -0
- package/dist/features/contract/contract.d.ts.map +1 -0
- package/dist/features/contract/contract.js +183 -0
- package/dist/features/contract/contract.js.map +1 -0
- package/dist/features/contract/index.d.ts +2 -0
- package/dist/features/contract/index.d.ts.map +1 -0
- package/dist/features/contract/index.js +2 -0
- package/dist/features/contract/index.js.map +1 -0
- package/dist/features/env/contribute.d.ts +70 -0
- package/dist/features/env/contribute.d.ts.map +1 -0
- package/dist/features/env/contribute.js +195 -0
- package/dist/features/env/contribute.js.map +1 -0
- package/dist/features/environment/create-environment.d.ts +58 -0
- package/dist/features/environment/create-environment.d.ts.map +1 -0
- package/dist/features/environment/create-environment.js +22 -0
- package/dist/features/environment/create-environment.js.map +1 -0
- package/dist/features/environment/index.d.ts +12 -0
- package/dist/features/environment/index.d.ts.map +1 -0
- package/dist/features/environment/index.js +10 -0
- package/dist/features/environment/index.js.map +1 -0
- package/dist/features/environment/load.d.ts +59 -0
- package/dist/features/environment/load.d.ts.map +1 -0
- package/dist/features/environment/load.js +117 -0
- package/dist/features/environment/load.js.map +1 -0
- package/dist/features/environment/types.d.ts +165 -0
- package/dist/features/environment/types.d.ts.map +1 -0
- package/dist/features/environment/types.js +18 -0
- package/dist/features/environment/types.js.map +1 -0
- package/dist/features/feature-flags/create-feature-flag-provider.d.ts +21 -0
- package/dist/features/feature-flags/create-feature-flag-provider.d.ts.map +1 -0
- package/dist/features/feature-flags/create-feature-flag-provider.js +16 -0
- package/dist/features/feature-flags/create-feature-flag-provider.js.map +1 -0
- package/dist/features/feature-flags/define-feature-flag-partial.d.ts +20 -0
- package/dist/features/feature-flags/define-feature-flag-partial.d.ts.map +1 -0
- package/dist/features/feature-flags/define-feature-flag-partial.js +26 -0
- package/dist/features/feature-flags/define-feature-flag-partial.js.map +1 -0
- package/dist/features/feature-flags/feature-flag-of.d.ts +16 -0
- package/dist/features/feature-flags/feature-flag-of.d.ts.map +1 -0
- package/dist/features/feature-flags/feature-flag-of.js +16 -0
- package/dist/features/feature-flags/feature-flag-of.js.map +1 -0
- package/dist/features/feature-flags/feature-flag-service.d.ts +22 -0
- package/dist/features/feature-flags/feature-flag-service.d.ts.map +1 -0
- package/dist/features/feature-flags/feature-flag-service.js +112 -0
- package/dist/features/feature-flags/feature-flag-service.js.map +1 -0
- package/dist/features/feature-flags/index.d.ts +15 -0
- package/dist/features/feature-flags/index.d.ts.map +1 -0
- package/dist/features/feature-flags/index.js +12 -0
- package/dist/features/feature-flags/index.js.map +1 -0
- package/dist/features/feature-flags/types.d.ts +30 -0
- package/dist/features/feature-flags/types.d.ts.map +1 -0
- package/dist/features/feature-flags/types.js +8 -0
- package/dist/features/feature-flags/types.js.map +1 -0
- package/dist/features/index.d.ts +6 -0
- package/dist/features/index.d.ts.map +1 -0
- package/dist/features/index.js +7 -0
- package/dist/features/index.js.map +1 -0
- package/dist/features/lock/index.d.ts +4 -0
- package/dist/features/lock/index.d.ts.map +1 -0
- package/dist/features/lock/index.js +4 -0
- package/dist/features/lock/index.js.map +1 -0
- package/dist/features/lock/lock-service.d.ts +74 -0
- package/dist/features/lock/lock-service.d.ts.map +1 -0
- package/dist/features/lock/lock-service.js +210 -0
- package/dist/features/lock/lock-service.js.map +1 -0
- package/dist/features/lock/memory.d.ts +60 -0
- package/dist/features/lock/memory.d.ts.map +1 -0
- package/dist/features/lock/memory.js +194 -0
- package/dist/features/lock/memory.js.map +1 -0
- package/dist/features/lock/types.d.ts +151 -0
- package/dist/features/lock/types.d.ts.map +1 -0
- package/dist/features/lock/types.js +17 -0
- package/dist/features/lock/types.js.map +1 -0
- package/dist/features/memory/index.d.ts +18 -0
- package/dist/features/memory/index.d.ts.map +1 -0
- package/dist/features/memory/index.js +18 -0
- package/dist/features/memory/index.js.map +1 -0
- package/dist/features/memory/lock-feature.d.ts +21 -0
- package/dist/features/memory/lock-feature.d.ts.map +1 -0
- package/dist/features/memory/lock-feature.js +24 -0
- package/dist/features/memory/lock-feature.js.map +1 -0
- package/dist/features/secrets/create-secret-provider.d.ts +31 -0
- package/dist/features/secrets/create-secret-provider.d.ts.map +1 -0
- package/dist/features/secrets/create-secret-provider.js +26 -0
- package/dist/features/secrets/create-secret-provider.js.map +1 -0
- package/dist/features/secrets/define-secret-partial.d.ts +16 -0
- package/dist/features/secrets/define-secret-partial.d.ts.map +1 -0
- package/dist/features/secrets/define-secret-partial.js +26 -0
- package/dist/features/secrets/define-secret-partial.js.map +1 -0
- package/dist/features/secrets/index.d.ts +17 -0
- package/dist/features/secrets/index.d.ts.map +1 -0
- package/dist/features/secrets/index.js +14 -0
- package/dist/features/secrets/index.js.map +1 -0
- package/dist/features/secrets/secret-of.d.ts +19 -0
- package/dist/features/secrets/secret-of.d.ts.map +1 -0
- package/dist/features/secrets/secret-of.js +21 -0
- package/dist/features/secrets/secret-of.js.map +1 -0
- package/dist/features/secrets/secret-service.d.ts +21 -0
- package/dist/features/secrets/secret-service.d.ts.map +1 -0
- package/dist/features/secrets/secret-service.js +28 -0
- package/dist/features/secrets/secret-service.js.map +1 -0
- package/dist/features/secrets/types.d.ts +30 -0
- package/dist/features/secrets/types.d.ts.map +1 -0
- package/dist/features/secrets/types.js +8 -0
- package/dist/features/secrets/types.js.map +1 -0
- package/dist/features/vault/env-var-vault.d.ts +24 -0
- package/dist/features/vault/env-var-vault.d.ts.map +1 -0
- package/dist/features/vault/env-var-vault.js +43 -0
- package/dist/features/vault/env-var-vault.js.map +1 -0
- package/dist/features/vault/hardcoded-vault.d.ts +34 -0
- package/dist/features/vault/hardcoded-vault.d.ts.map +1 -0
- package/dist/features/vault/hardcoded-vault.js +46 -0
- package/dist/features/vault/hardcoded-vault.js.map +1 -0
- package/dist/features/vault/hashicorp-vault.d.ts +32 -0
- package/dist/features/vault/hashicorp-vault.d.ts.map +1 -0
- package/dist/features/vault/hashicorp-vault.js +69 -0
- package/dist/features/vault/hashicorp-vault.js.map +1 -0
- package/dist/features/vault/index.d.ts +13 -0
- package/dist/features/vault/index.d.ts.map +1 -0
- package/dist/features/vault/index.js +12 -0
- package/dist/features/vault/index.js.map +1 -0
- package/dist/features/vault/kubernetes-vault.d.ts +27 -0
- package/dist/features/vault/kubernetes-vault.d.ts.map +1 -0
- package/dist/features/vault/kubernetes-vault.js +51 -0
- package/dist/features/vault/kubernetes-vault.js.map +1 -0
- package/dist/features/vault/types.d.ts +41 -0
- package/dist/features/vault/types.d.ts.map +1 -0
- package/dist/features/vault/types.js +21 -0
- package/dist/features/vault/types.js.map +1 -0
- package/dist/index.d.ts +78 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +48 -0
- package/dist/index.js.map +1 -0
- package/dist/justscale.d.ts +63 -0
- package/dist/justscale.d.ts.map +1 -0
- package/dist/justscale.js +501 -0
- package/dist/justscale.js.map +1 -0
- package/dist/kernel/adapter.d.ts +9 -0
- package/dist/kernel/adapter.d.ts.map +1 -0
- package/dist/kernel/adapter.js +2 -0
- package/dist/kernel/adapter.js.map +1 -0
- package/dist/kernel/kernel.d.ts +15 -0
- package/dist/kernel/kernel.d.ts.map +1 -0
- package/dist/kernel/kernel.js +134 -0
- package/dist/kernel/kernel.js.map +1 -0
- package/dist/models/access.d.ts +26 -0
- package/dist/models/access.d.ts.map +1 -0
- package/dist/models/access.js +126 -0
- package/dist/models/access.js.map +1 -0
- package/dist/models/apply-types-config.d.ts +52 -0
- package/dist/models/apply-types-config.d.ts.map +1 -0
- package/dist/models/apply-types-config.js +47 -0
- package/dist/models/apply-types-config.js.map +1 -0
- package/dist/models/define-model.d.ts +249 -0
- package/dist/models/define-model.d.ts.map +1 -0
- package/dist/models/define-model.js +388 -0
- package/dist/models/define-model.js.map +1 -0
- package/dist/models/field.d.ts +309 -0
- package/dist/models/field.d.ts.map +1 -0
- package/dist/models/field.js +312 -0
- package/dist/models/field.js.map +1 -0
- package/dist/models/in-memory/condition-evaluator.d.ts +53 -0
- package/dist/models/in-memory/condition-evaluator.d.ts.map +1 -0
- package/dist/models/in-memory/condition-evaluator.js +593 -0
- package/dist/models/in-memory/condition-evaluator.js.map +1 -0
- package/dist/models/in-memory/in-memory-model.d.ts +89 -0
- package/dist/models/in-memory/in-memory-model.d.ts.map +1 -0
- package/dist/models/in-memory/in-memory-model.js +101 -0
- package/dist/models/in-memory/in-memory-model.js.map +1 -0
- package/dist/models/in-memory/in-memory-repository.d.ts +208 -0
- package/dist/models/in-memory/in-memory-repository.d.ts.map +1 -0
- package/dist/models/in-memory/in-memory-repository.js +618 -0
- package/dist/models/in-memory/in-memory-repository.js.map +1 -0
- package/dist/models/in-memory/in-memory-scheduled-task.repository.d.ts +92 -0
- package/dist/models/in-memory/in-memory-scheduled-task.repository.d.ts.map +1 -0
- package/dist/models/in-memory/in-memory-scheduled-task.repository.js +395 -0
- package/dist/models/in-memory/in-memory-scheduled-task.repository.js.map +1 -0
- package/dist/models/in-memory/index.d.ts +35 -0
- package/dist/models/in-memory/index.d.ts.map +1 -0
- package/dist/models/in-memory/index.js +36 -0
- package/dist/models/in-memory/index.js.map +1 -0
- package/dist/models/index.d.ts +52 -0
- package/dist/models/index.d.ts.map +1 -0
- package/dist/models/index.js +86 -0
- package/dist/models/index.js.map +1 -0
- package/dist/models/model-name-registry.d.ts +16 -0
- package/dist/models/model-name-registry.d.ts.map +1 -0
- package/dist/models/model-name-registry.js +19 -0
- package/dist/models/model-name-registry.js.map +1 -0
- package/dist/models/model.d.ts +15 -0
- package/dist/models/model.d.ts.map +1 -0
- package/dist/models/model.js +114 -0
- package/dist/models/model.js.map +1 -0
- package/dist/models/model.repository.d.ts +318 -0
- package/dist/models/model.repository.d.ts.map +1 -0
- package/dist/models/model.repository.js +146 -0
- package/dist/models/model.repository.js.map +1 -0
- package/dist/models/observable.d.ts +15 -0
- package/dist/models/observable.d.ts.map +1 -0
- package/dist/models/observable.js +64 -0
- package/dist/models/observable.js.map +1 -0
- package/dist/models/proxy.d.ts +5 -0
- package/dist/models/proxy.d.ts.map +1 -0
- package/dist/models/proxy.js +407 -0
- package/dist/models/proxy.js.map +1 -0
- package/dist/models/query.d.ts +574 -0
- package/dist/models/query.d.ts.map +1 -0
- package/dist/models/query.js +701 -0
- package/dist/models/query.js.map +1 -0
- package/dist/models/reference/reference.d.ts +229 -0
- package/dist/models/reference/reference.d.ts.map +1 -0
- package/dist/models/reference/reference.js +331 -0
- package/dist/models/reference/reference.js.map +1 -0
- package/dist/models/reference/transient-ref.d.ts +123 -0
- package/dist/models/reference/transient-ref.d.ts.map +1 -0
- package/dist/models/reference/transient-ref.js +152 -0
- package/dist/models/reference/transient-ref.js.map +1 -0
- package/dist/models/repository.d.ts +53 -0
- package/dist/models/repository.d.ts.map +1 -0
- package/dist/models/repository.js +37 -0
- package/dist/models/repository.js.map +1 -0
- package/dist/models/scheduled-task/index.d.ts +13 -0
- package/dist/models/scheduled-task/index.d.ts.map +1 -0
- package/dist/models/scheduled-task/index.js +12 -0
- package/dist/models/scheduled-task/index.js.map +1 -0
- package/dist/models/scheduled-task/scheduled-task.d.ts +73 -0
- package/dist/models/scheduled-task/scheduled-task.d.ts.map +1 -0
- package/dist/models/scheduled-task/scheduled-task.js +95 -0
- package/dist/models/scheduled-task/scheduled-task.js.map +1 -0
- package/dist/models/scheduled-task/scheduled-task.repository.d.ts +150 -0
- package/dist/models/scheduled-task/scheduled-task.repository.d.ts.map +1 -0
- package/dist/models/scheduled-task/scheduled-task.repository.js +40 -0
- package/dist/models/scheduled-task/scheduled-task.repository.js.map +1 -0
- package/dist/models/stream.d.ts +139 -0
- package/dist/models/stream.d.ts.map +1 -0
- package/dist/models/stream.js +153 -0
- package/dist/models/stream.js.map +1 -0
- package/dist/models/symbols.d.ts +73 -0
- package/dist/models/symbols.d.ts.map +1 -0
- package/dist/models/symbols.js +97 -0
- package/dist/models/symbols.js.map +1 -0
- package/dist/models/types.d.ts +291 -0
- package/dist/models/types.d.ts.map +1 -0
- package/dist/models/types.js +50 -0
- package/dist/models/types.js.map +1 -0
- package/dist/models/watch.d.ts +27 -0
- package/dist/models/watch.d.ts.map +1 -0
- package/dist/models/watch.js +124 -0
- package/dist/models/watch.js.map +1 -0
- package/dist/models/zod-ref.d.ts +46 -0
- package/dist/models/zod-ref.d.ts.map +1 -0
- package/dist/models/zod-ref.js +31 -0
- package/dist/models/zod-ref.js.map +1 -0
- package/dist/process/builtin-serializers.d.ts +19 -0
- package/dist/process/builtin-serializers.d.ts.map +1 -0
- package/dist/process/builtin-serializers.js +213 -0
- package/dist/process/builtin-serializers.js.map +1 -0
- package/dist/process/cluster-plugin.d.ts +129 -0
- package/dist/process/cluster-plugin.d.ts.map +1 -0
- package/dist/process/cluster-plugin.js +175 -0
- package/dist/process/cluster-plugin.js.map +1 -0
- package/dist/process/createProcess.d.ts +67 -0
- package/dist/process/createProcess.d.ts.map +1 -0
- package/dist/process/createProcess.js +111 -0
- package/dist/process/createProcess.js.map +1 -0
- package/dist/process/define-signals.d.ts +113 -0
- package/dist/process/define-signals.d.ts.map +1 -0
- package/dist/process/define-signals.js +222 -0
- package/dist/process/define-signals.js.map +1 -0
- package/dist/process/delay-controller.d.ts +35 -0
- package/dist/process/delay-controller.d.ts.map +1 -0
- package/dist/process/delay-controller.js +55 -0
- package/dist/process/delay-controller.js.map +1 -0
- package/dist/process/index.d.ts +38 -0
- package/dist/process/index.d.ts.map +1 -0
- package/dist/process/index.js +47 -0
- package/dist/process/index.js.map +1 -0
- package/dist/process/primitives.d.ts +393 -0
- package/dist/process/primitives.d.ts.map +1 -0
- package/dist/process/primitives.js +325 -0
- package/dist/process/primitives.js.map +1 -0
- package/dist/process/serialization.d.ts +58 -0
- package/dist/process/serialization.d.ts.map +1 -0
- package/dist/process/serialization.js +220 -0
- package/dist/process/serialization.js.map +1 -0
- package/dist/process/stream-utils.d.ts +123 -0
- package/dist/process/stream-utils.d.ts.map +1 -0
- package/dist/process/stream-utils.js +247 -0
- package/dist/process/stream-utils.js.map +1 -0
- package/dist/process/testing/clock.d.ts +115 -0
- package/dist/process/testing/clock.d.ts.map +1 -0
- package/dist/process/testing/clock.js +166 -0
- package/dist/process/testing/clock.js.map +1 -0
- package/dist/process/testing/index.d.ts +9 -0
- package/dist/process/testing/index.d.ts.map +1 -0
- package/dist/process/testing/index.js +9 -0
- package/dist/process/testing/index.js.map +1 -0
- package/dist/process/testing.d.ts +50 -0
- package/dist/process/testing.d.ts.map +1 -0
- package/dist/process/testing.js +59 -0
- package/dist/process/testing.js.map +1 -0
- package/dist/process/types.d.ts +540 -0
- package/dist/process/types.d.ts.map +1 -0
- package/dist/process/types.js +21 -0
- package/dist/process/types.js.map +1 -0
- package/dist/queue/index.d.ts +2 -0
- package/dist/queue/index.d.ts.map +1 -0
- package/dist/queue/index.js +2 -0
- package/dist/queue/index.js.map +1 -0
- package/dist/queue/queue.d.ts +34 -0
- package/dist/queue/queue.d.ts.map +1 -0
- package/dist/queue/queue.js +108 -0
- package/dist/queue/queue.js.map +1 -0
- package/dist/runtime/process/compiled.d.ts +56 -0
- package/dist/runtime/process/compiled.d.ts.map +1 -0
- package/dist/runtime/process/compiled.js +221 -0
- package/dist/runtime/process/compiled.js.map +1 -0
- package/dist/runtime/process/executor.d.ts +279 -0
- package/dist/runtime/process/executor.d.ts.map +1 -0
- package/dist/runtime/process/executor.js +1941 -0
- package/dist/runtime/process/executor.js.map +1 -0
- package/dist/runtime/process/factory.d.ts +72 -0
- package/dist/runtime/process/factory.d.ts.map +1 -0
- package/dist/runtime/process/factory.js +78 -0
- package/dist/runtime/process/factory.js.map +1 -0
- package/dist/runtime/process/freeze.d.ts +5 -0
- package/dist/runtime/process/freeze.d.ts.map +1 -0
- package/dist/runtime/process/freeze.js +94 -0
- package/dist/runtime/process/freeze.js.map +1 -0
- package/dist/runtime/process/scheduled-task-timer.d.ts +52 -0
- package/dist/runtime/process/scheduled-task-timer.d.ts.map +1 -0
- package/dist/runtime/process/scheduled-task-timer.js +104 -0
- package/dist/runtime/process/scheduled-task-timer.js.map +1 -0
- package/dist/runtime/process/signal-bus.d.ts +186 -0
- package/dist/runtime/process/signal-bus.d.ts.map +1 -0
- package/dist/runtime/process/signal-bus.js +256 -0
- package/dist/runtime/process/signal-bus.js.map +1 -0
- package/dist/runtime/process/state-serializer.d.ts +30 -0
- package/dist/runtime/process/state-serializer.d.ts.map +1 -0
- package/dist/runtime/process/state-serializer.js +244 -0
- package/dist/runtime/process/state-serializer.js.map +1 -0
- package/dist/runtime/process/storage.d.ts +96 -0
- package/dist/runtime/process/storage.d.ts.map +1 -0
- package/dist/runtime/process/storage.js +165 -0
- package/dist/runtime/process/storage.js.map +1 -0
- package/dist/runtime/process/timer-scheduler.d.ts +115 -0
- package/dist/runtime/process/timer-scheduler.d.ts.map +1 -0
- package/dist/runtime/process/timer-scheduler.js +192 -0
- package/dist/runtime/process/timer-scheduler.js.map +1 -0
- package/dist/runtime/process/trace.d.ts +17 -0
- package/dist/runtime/process/trace.d.ts.map +1 -0
- package/dist/runtime/process/trace.js +26 -0
- package/dist/runtime/process/trace.js.map +1 -0
- package/dist/runtime/protobuf/encoding/index.d.ts +26 -0
- package/dist/runtime/protobuf/encoding/index.d.ts.map +1 -0
- package/dist/runtime/protobuf/encoding/index.js +30 -0
- package/dist/runtime/protobuf/encoding/index.js.map +1 -0
- package/dist/runtime/protobuf/encoding/reader.d.ts +182 -0
- package/dist/runtime/protobuf/encoding/reader.d.ts.map +1 -0
- package/dist/runtime/protobuf/encoding/reader.js +353 -0
- package/dist/runtime/protobuf/encoding/reader.js.map +1 -0
- package/dist/runtime/protobuf/encoding/varint.d.ts +67 -0
- package/dist/runtime/protobuf/encoding/varint.d.ts.map +1 -0
- package/dist/runtime/protobuf/encoding/varint.js +117 -0
- package/dist/runtime/protobuf/encoding/varint.js.map +1 -0
- package/dist/runtime/protobuf/encoding/wire-types.d.ts +62 -0
- package/dist/runtime/protobuf/encoding/wire-types.d.ts.map +1 -0
- package/dist/runtime/protobuf/encoding/wire-types.js +103 -0
- package/dist/runtime/protobuf/encoding/wire-types.js.map +1 -0
- package/dist/runtime/protobuf/encoding/writer.d.ts +147 -0
- package/dist/runtime/protobuf/encoding/writer.d.ts.map +1 -0
- package/dist/runtime/protobuf/encoding/writer.js +214 -0
- package/dist/runtime/protobuf/encoding/writer.js.map +1 -0
- package/dist/runtime/protobuf/index.d.ts +3 -0
- package/dist/runtime/protobuf/index.d.ts.map +1 -0
- package/dist/runtime/protobuf/index.js +3 -0
- package/dist/runtime/protobuf/index.js.map +1 -0
- package/dist/runtime/protobuf/serialized.d.ts +48 -0
- package/dist/runtime/protobuf/serialized.d.ts.map +1 -0
- package/dist/runtime/protobuf/serialized.js +517 -0
- package/dist/runtime/protobuf/serialized.js.map +1 -0
- package/package.json +209 -0
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* State serializer for durable process vars.
|
|
3
|
+
*
|
|
4
|
+
* Wraps non-JSON types (Map, Set, Date, BigInt, undefined) with type tags
|
|
5
|
+
* so they survive JSONB round-trips. Uses `__$type` as the tag key to avoid
|
|
6
|
+
* collisions with user data.
|
|
7
|
+
*
|
|
8
|
+
* Types implementing the Processable protocol (Symbol.process) get automatic
|
|
9
|
+
* custom serialization. The `__types` metadata map tracks which variables
|
|
10
|
+
* used Processable descriptors, enabling correct deserialization via the
|
|
11
|
+
* runtime type registry.
|
|
12
|
+
*/
|
|
13
|
+
import { getProcessDescriptor, findProcessDescriptor } from '../../process/serialization.js';
|
|
14
|
+
import { PERSISTENT, ADAPTER_KEY } from '../../models/symbols.js';
|
|
15
|
+
import { MODEL_NAME } from '../../models/define-model.js';
|
|
16
|
+
import { getModelByName } from '../../models/model-name-registry.js';
|
|
17
|
+
import { Reference } from '../../models/reference/reference.js';
|
|
18
|
+
const TAG = '__$type';
|
|
19
|
+
const TYPES_KEY = '__$processTypes';
|
|
20
|
+
function isTagged(value) {
|
|
21
|
+
return (typeof value === 'object' &&
|
|
22
|
+
value !== null &&
|
|
23
|
+
TAG in value &&
|
|
24
|
+
typeof value[TAG] === 'string');
|
|
25
|
+
}
|
|
26
|
+
function serializeValue(value) {
|
|
27
|
+
if (value === undefined) {
|
|
28
|
+
return { [TAG]: 'undefined' };
|
|
29
|
+
}
|
|
30
|
+
if (value === null) {
|
|
31
|
+
return null;
|
|
32
|
+
}
|
|
33
|
+
if (typeof value === 'bigint') {
|
|
34
|
+
return { [TAG]: 'BigInt', v: value.toString() };
|
|
35
|
+
}
|
|
36
|
+
if (typeof value === 'function') {
|
|
37
|
+
console.warn('[state-serializer] Functions cannot be serialized — replacing with null');
|
|
38
|
+
return null;
|
|
39
|
+
}
|
|
40
|
+
if (value instanceof Uint8Array) {
|
|
41
|
+
return { [TAG]: 'Uint8Array', v: uint8ArrayToBase64(value) };
|
|
42
|
+
}
|
|
43
|
+
// Persistent entities collapse to References — never store stale entity data in process state.
|
|
44
|
+
if (typeof value === 'object' && value !== null && value[PERSISTENT]) {
|
|
45
|
+
const id = value[ADAPTER_KEY];
|
|
46
|
+
const modelName = value.constructor?.[MODEL_NAME];
|
|
47
|
+
if (id) {
|
|
48
|
+
return { [TAG]: 'PersistentRef', id, ...(modelName ? { m: modelName } : {}) };
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
// Check Processable protocol for nested values (Date, Map, Set, Reference, custom types).
|
|
52
|
+
// This handles nested Processable values inside arrays, objects, and other structures.
|
|
53
|
+
// Top-level vars are handled separately by serializeState().
|
|
54
|
+
if (typeof value === 'object' && !Array.isArray(value)) {
|
|
55
|
+
const descriptor = findProcessDescriptor(value);
|
|
56
|
+
if (descriptor) {
|
|
57
|
+
const serialized = descriptor.serialize(value);
|
|
58
|
+
return { [TAG]: 'P', n: descriptor.name, v: serializeValue(serialized) };
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
// Legacy fallbacks for Date, Map, Set when builtin-serializers is not imported.
|
|
62
|
+
// When builtins ARE imported, the Processable check above handles these.
|
|
63
|
+
if (value instanceof Date) {
|
|
64
|
+
return { [TAG]: 'Date', v: value.getTime() };
|
|
65
|
+
}
|
|
66
|
+
if (value instanceof Map) {
|
|
67
|
+
const entries = [];
|
|
68
|
+
for (const [k, v] of value) {
|
|
69
|
+
entries.push([serializeValue(k), serializeValue(v)]);
|
|
70
|
+
}
|
|
71
|
+
return { [TAG]: 'Map', v: entries };
|
|
72
|
+
}
|
|
73
|
+
if (value instanceof Set) {
|
|
74
|
+
const items = [];
|
|
75
|
+
for (const item of value) {
|
|
76
|
+
items.push(serializeValue(item));
|
|
77
|
+
}
|
|
78
|
+
return { [TAG]: 'Set', v: items };
|
|
79
|
+
}
|
|
80
|
+
if (Array.isArray(value)) {
|
|
81
|
+
return value.map(serializeValue);
|
|
82
|
+
}
|
|
83
|
+
if (typeof value === 'object') {
|
|
84
|
+
const result = {};
|
|
85
|
+
for (const key of Object.keys(value)) {
|
|
86
|
+
result[key] = serializeValue(value[key]);
|
|
87
|
+
}
|
|
88
|
+
return result;
|
|
89
|
+
}
|
|
90
|
+
// string, number, boolean
|
|
91
|
+
return value;
|
|
92
|
+
}
|
|
93
|
+
function uint8ArrayToBase64(bytes) {
|
|
94
|
+
let binary = '';
|
|
95
|
+
for (let i = 0; i < bytes.length; i++) {
|
|
96
|
+
binary += String.fromCharCode(bytes[i]);
|
|
97
|
+
}
|
|
98
|
+
return btoa(binary);
|
|
99
|
+
}
|
|
100
|
+
function base64ToUint8Array(base64) {
|
|
101
|
+
const binary = atob(base64);
|
|
102
|
+
const bytes = new Uint8Array(binary.length);
|
|
103
|
+
for (let i = 0; i < binary.length; i++) {
|
|
104
|
+
bytes[i] = binary.charCodeAt(i);
|
|
105
|
+
}
|
|
106
|
+
return bytes;
|
|
107
|
+
}
|
|
108
|
+
function deserializeValue(value) {
|
|
109
|
+
if (value === null) {
|
|
110
|
+
return null;
|
|
111
|
+
}
|
|
112
|
+
if (Array.isArray(value)) {
|
|
113
|
+
return value.map(deserializeValue);
|
|
114
|
+
}
|
|
115
|
+
if (typeof value === 'object') {
|
|
116
|
+
if (isTagged(value)) {
|
|
117
|
+
switch (value[TAG]) {
|
|
118
|
+
case 'undefined':
|
|
119
|
+
return undefined;
|
|
120
|
+
case 'BigInt':
|
|
121
|
+
return BigInt(value.v);
|
|
122
|
+
case 'Date':
|
|
123
|
+
return new Date(value.v);
|
|
124
|
+
case 'Uint8Array':
|
|
125
|
+
return base64ToUint8Array(value.v);
|
|
126
|
+
case 'Map': {
|
|
127
|
+
const entries = value.v;
|
|
128
|
+
return new Map(entries.map(([k, v]) => [deserializeValue(k), deserializeValue(v)]));
|
|
129
|
+
}
|
|
130
|
+
case 'Set': {
|
|
131
|
+
const items = value.v;
|
|
132
|
+
return new Set(items.map(deserializeValue));
|
|
133
|
+
}
|
|
134
|
+
case 'PersistentRef': {
|
|
135
|
+
// Persistent entity collapsed to a Reference
|
|
136
|
+
const { id, m } = value;
|
|
137
|
+
if (m) {
|
|
138
|
+
const model = getModelByName(m);
|
|
139
|
+
if (model)
|
|
140
|
+
return model.ref(id);
|
|
141
|
+
}
|
|
142
|
+
return new Reference(id);
|
|
143
|
+
}
|
|
144
|
+
case 'P': {
|
|
145
|
+
// Nested Processable value — look up descriptor by name
|
|
146
|
+
const name = value.n;
|
|
147
|
+
const descriptor = getProcessDescriptor(name);
|
|
148
|
+
if (descriptor) {
|
|
149
|
+
const rawValue = deserializeValue(value.v);
|
|
150
|
+
return descriptor.deserialize(rawValue);
|
|
151
|
+
}
|
|
152
|
+
console.warn(`[state-serializer] No registered ProcessDescriptor for '${name}' — ` +
|
|
153
|
+
'falling back to raw value');
|
|
154
|
+
return deserializeValue(value.v);
|
|
155
|
+
}
|
|
156
|
+
default:
|
|
157
|
+
// Unknown tag — treat as plain object (user data that happens to have __$type)
|
|
158
|
+
break;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
const result = {};
|
|
162
|
+
for (const key of Object.keys(value)) {
|
|
163
|
+
result[key] = deserializeValue(value[key]);
|
|
164
|
+
}
|
|
165
|
+
return result;
|
|
166
|
+
}
|
|
167
|
+
// string, number, boolean
|
|
168
|
+
return value;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Deep-serialize process vars for JSONB storage.
|
|
172
|
+
* Non-JSON types are wrapped with `{__$type, v}` tags.
|
|
173
|
+
*
|
|
174
|
+
* Variables whose values implement Processable (Symbol.process) are
|
|
175
|
+
* serialized using their custom descriptor. A `__types` metadata map
|
|
176
|
+
* is added to track which variables used Processable serialization.
|
|
177
|
+
*/
|
|
178
|
+
export function serializeState(vars) {
|
|
179
|
+
const result = {};
|
|
180
|
+
let types;
|
|
181
|
+
for (const key of Object.keys(vars)) {
|
|
182
|
+
// Skip internal metadata keys
|
|
183
|
+
if (key === TYPES_KEY)
|
|
184
|
+
continue;
|
|
185
|
+
const value = vars[key];
|
|
186
|
+
const descriptor = findProcessDescriptor(value);
|
|
187
|
+
if (descriptor) {
|
|
188
|
+
// Processable type — use custom serializer
|
|
189
|
+
let serialized;
|
|
190
|
+
try {
|
|
191
|
+
serialized = descriptor.serialize(value);
|
|
192
|
+
}
|
|
193
|
+
catch (err) {
|
|
194
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
195
|
+
throw new Error(`[Processable] encode failed at path "vars.${key}": ${msg}`, { cause: err });
|
|
196
|
+
}
|
|
197
|
+
// Wrap the result through serializeValue to handle Uint8Array etc.
|
|
198
|
+
result[key] = serializeValue(serialized);
|
|
199
|
+
types ??= {};
|
|
200
|
+
types[key] = descriptor.name;
|
|
201
|
+
}
|
|
202
|
+
else {
|
|
203
|
+
result[key] = serializeValue(value);
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
if (types) {
|
|
207
|
+
result[TYPES_KEY] = types;
|
|
208
|
+
}
|
|
209
|
+
return result;
|
|
210
|
+
}
|
|
211
|
+
/**
|
|
212
|
+
* Deep-deserialize process vars from JSONB storage.
|
|
213
|
+
* Reconstructs tagged types back to their native JS equivalents.
|
|
214
|
+
*
|
|
215
|
+
* If `__types` metadata is present, variables are deserialized using
|
|
216
|
+
* their registered Processable descriptors from the type registry.
|
|
217
|
+
*/
|
|
218
|
+
export function deserializeState(vars) {
|
|
219
|
+
const result = {};
|
|
220
|
+
const types = vars[TYPES_KEY];
|
|
221
|
+
for (const key of Object.keys(vars)) {
|
|
222
|
+
if (key === TYPES_KEY)
|
|
223
|
+
continue;
|
|
224
|
+
if (types && key in types) {
|
|
225
|
+
// Processable type — look up descriptor by name
|
|
226
|
+
const descriptor = getProcessDescriptor(types[key]);
|
|
227
|
+
if (descriptor) {
|
|
228
|
+
// First deserialize the storage form (e.g. base64 → Uint8Array)
|
|
229
|
+
const rawValue = deserializeValue(vars[key]);
|
|
230
|
+
result[key] = descriptor.deserialize(rawValue);
|
|
231
|
+
}
|
|
232
|
+
else {
|
|
233
|
+
console.warn(`[state-serializer] No registered ProcessDescriptor for '${types[key]}' — ` +
|
|
234
|
+
`falling back to JSON deserialization for var '${key}'`);
|
|
235
|
+
result[key] = deserializeValue(vars[key]);
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
else {
|
|
239
|
+
result[key] = deserializeValue(vars[key]);
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
return result;
|
|
243
|
+
}
|
|
244
|
+
//# sourceMappingURL=state-serializer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"state-serializer.js","sourceRoot":"","sources":["../../../src/runtime/process/state-serializer.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @justscale/process - Process Storage
|
|
3
|
+
*
|
|
4
|
+
* Abstraction for persisting process state.
|
|
5
|
+
*/
|
|
6
|
+
import type { ProcessState, ProcessStatus } from '../../process/types.js';
|
|
7
|
+
/**
|
|
8
|
+
* Abstract storage interface for process state persistence.
|
|
9
|
+
*
|
|
10
|
+
* Implementations:
|
|
11
|
+
* - InMemoryProcessStorage (testing/development)
|
|
12
|
+
* - PgProcessStorage (production - in @justscale/postgres)
|
|
13
|
+
*/
|
|
14
|
+
export interface ProcessStorage {
|
|
15
|
+
/** Save or update process state */
|
|
16
|
+
save(state: ProcessState): Promise<void>;
|
|
17
|
+
/** Load process state by instance ID. Returns null if not found. */
|
|
18
|
+
load(instanceId: string): Promise<ProcessState | null>;
|
|
19
|
+
/** Delete a process state */
|
|
20
|
+
delete(instanceId: string): Promise<void>;
|
|
21
|
+
/** Mark process as completed with result */
|
|
22
|
+
complete(instanceId: string, result: unknown): Promise<void>;
|
|
23
|
+
/** Mark process as failed with error */
|
|
24
|
+
fail(instanceId: string, error: string): Promise<void>;
|
|
25
|
+
/** Find processes by process definition ID */
|
|
26
|
+
findByProcessId(processId: string): AsyncIterable<ProcessState>;
|
|
27
|
+
/** Find processes by status */
|
|
28
|
+
findByStatus(status: ProcessStatus): AsyncIterable<ProcessState>;
|
|
29
|
+
/** Find processes waiting for a specific signal */
|
|
30
|
+
findWaitingForSignal(signal: string, identity: Record<string, string>): AsyncIterable<ProcessState>;
|
|
31
|
+
/** Find processes with expired timers */
|
|
32
|
+
findExpiredTimers(before: Date): AsyncIterable<ProcessState>;
|
|
33
|
+
}
|
|
34
|
+
declare const AbstractProcessStorage_base: import("../../core/service.js").AbstractClass<ProcessStorage>;
|
|
35
|
+
/**
|
|
36
|
+
* Abstract ProcessStorage for dependency injection.
|
|
37
|
+
*
|
|
38
|
+
* Use this as a DI token. Implementations (InMemory, Postgres) provide this.
|
|
39
|
+
*
|
|
40
|
+
* @example
|
|
41
|
+
* ```typescript
|
|
42
|
+
* // Use InMemory (auto-provides AbstractProcessStorage)
|
|
43
|
+
* .add(InMemoryProcessStorage)
|
|
44
|
+
*
|
|
45
|
+
* // Or use Postgres feature
|
|
46
|
+
* .add(PostgresProcessFeature)
|
|
47
|
+
* ```
|
|
48
|
+
*/
|
|
49
|
+
export declare abstract class AbstractProcessStorage extends AbstractProcessStorage_base {
|
|
50
|
+
}
|
|
51
|
+
/** Return type for createInMemoryProcessStorage */
|
|
52
|
+
export type InMemoryProcessStorageInstance = ProcessStorage & {
|
|
53
|
+
/** Clear all stored processes */
|
|
54
|
+
clear(): void;
|
|
55
|
+
/** Get count of processes */
|
|
56
|
+
readonly size: number;
|
|
57
|
+
/** Get stats by status */
|
|
58
|
+
getStats(): Record<ProcessStatus, number>;
|
|
59
|
+
};
|
|
60
|
+
/**
|
|
61
|
+
* Create an in-memory process storage instance.
|
|
62
|
+
*
|
|
63
|
+
* Use this function for testing or when you need a direct instance.
|
|
64
|
+
* For DI, use `InMemoryProcessStorage` service instead.
|
|
65
|
+
*
|
|
66
|
+
* @example
|
|
67
|
+
* ```typescript
|
|
68
|
+
* // Direct instantiation for testing
|
|
69
|
+
* const storage = createInMemoryProcessStorage()
|
|
70
|
+
* storage.save(state)
|
|
71
|
+
* storage.clear()
|
|
72
|
+
* ```
|
|
73
|
+
*/
|
|
74
|
+
export declare function createInMemoryProcessStorage(): InMemoryProcessStorageInstance;
|
|
75
|
+
declare const InMemoryProcessStorage_base: import("../../core/service.js").Service<InMemoryProcessStorageInstance, {}>;
|
|
76
|
+
/**
|
|
77
|
+
* In-memory process storage service for DI.
|
|
78
|
+
*
|
|
79
|
+
* Not suitable for production - state is lost on restart.
|
|
80
|
+
*
|
|
81
|
+
* @example
|
|
82
|
+
* ```typescript
|
|
83
|
+
* // For DI - auto-provides AbstractProcessStorage
|
|
84
|
+
* JustScale()
|
|
85
|
+
* .add(InMemoryProcessStorage)
|
|
86
|
+
* .add(ProcessExecutor)
|
|
87
|
+
* .build()
|
|
88
|
+
*
|
|
89
|
+
* // For testing - use createInMemoryProcessStorage() instead
|
|
90
|
+
* const storage = createInMemoryProcessStorage()
|
|
91
|
+
* ```
|
|
92
|
+
*/
|
|
93
|
+
export declare class InMemoryProcessStorage extends InMemoryProcessStorage_base {
|
|
94
|
+
}
|
|
95
|
+
export {};
|
|
96
|
+
//# sourceMappingURL=storage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/runtime/process/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAO1E;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAG7B,mCAAmC;IACnC,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExC,oEAAoE;IACpE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAEtD,6BAA6B;IAC7B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAIzC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5D,wCAAwC;IACxC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAItD,8CAA8C;IAC9C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;IAE/D,+BAA+B;IAC/B,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;IAEhE,mDAAmD;IACnD,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;IAEnG,yCAAyC;IACzC,iBAAiB,CAAC,MAAM,EAAE,IAAI,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;CAC7D;;AAMD;;;;;;;;;;;;;GAaG;AACH,8BAAsB,sBAAuB,SAAQ,2BAAwD;CAAG;AAMhH,mDAAmD;AACnD,MAAM,MAAM,8BAA8B,GAAG,cAAc,GAAG;IAC5D,iCAAiC;IACjC,KAAK,IAAI,IAAI,CAAA;IACb,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,QAAQ,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;CAC1C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,IAAI,8BAA8B,CAwH7E;;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAuB,SAAQ,2BAI1C;CAAG"}
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @justscale/process - Process Storage
|
|
3
|
+
*
|
|
4
|
+
* Abstraction for persisting process state.
|
|
5
|
+
*/
|
|
6
|
+
import { defineAbstract, defineService } from '../../core/service.js';
|
|
7
|
+
// ============================================================================
|
|
8
|
+
// Abstract Class for DI
|
|
9
|
+
// ============================================================================
|
|
10
|
+
/**
|
|
11
|
+
* Abstract ProcessStorage for dependency injection.
|
|
12
|
+
*
|
|
13
|
+
* Use this as a DI token. Implementations (InMemory, Postgres) provide this.
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* ```typescript
|
|
17
|
+
* // Use InMemory (auto-provides AbstractProcessStorage)
|
|
18
|
+
* .add(InMemoryProcessStorage)
|
|
19
|
+
*
|
|
20
|
+
* // Or use Postgres feature
|
|
21
|
+
* .add(PostgresProcessFeature)
|
|
22
|
+
* ```
|
|
23
|
+
*/
|
|
24
|
+
export class AbstractProcessStorage extends defineAbstract('AbstractProcessStorage') {
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Create an in-memory process storage instance.
|
|
28
|
+
*
|
|
29
|
+
* Use this function for testing or when you need a direct instance.
|
|
30
|
+
* For DI, use `InMemoryProcessStorage` service instead.
|
|
31
|
+
*
|
|
32
|
+
* @example
|
|
33
|
+
* ```typescript
|
|
34
|
+
* // Direct instantiation for testing
|
|
35
|
+
* const storage = createInMemoryProcessStorage()
|
|
36
|
+
* storage.save(state)
|
|
37
|
+
* storage.clear()
|
|
38
|
+
* ```
|
|
39
|
+
*/
|
|
40
|
+
export function createInMemoryProcessStorage() {
|
|
41
|
+
const processes = new Map();
|
|
42
|
+
function matchesIdentity(stateIdentity, queryIdentity) {
|
|
43
|
+
for (const [key, value] of Object.entries(queryIdentity)) {
|
|
44
|
+
if (stateIdentity[key] !== value)
|
|
45
|
+
return false;
|
|
46
|
+
}
|
|
47
|
+
return true;
|
|
48
|
+
}
|
|
49
|
+
return {
|
|
50
|
+
async save(state) {
|
|
51
|
+
state.updatedAt = new Date();
|
|
52
|
+
processes.set(state.instanceId, structuredClone(state));
|
|
53
|
+
},
|
|
54
|
+
async load(instanceId) {
|
|
55
|
+
const state = processes.get(instanceId);
|
|
56
|
+
return state ? structuredClone(state) : null;
|
|
57
|
+
},
|
|
58
|
+
async delete(instanceId) {
|
|
59
|
+
processes.delete(instanceId);
|
|
60
|
+
},
|
|
61
|
+
async complete(instanceId, result) {
|
|
62
|
+
const state = processes.get(instanceId);
|
|
63
|
+
if (state) {
|
|
64
|
+
state.status = 'completed';
|
|
65
|
+
state.result = result;
|
|
66
|
+
state.completedAt = new Date();
|
|
67
|
+
state.updatedAt = new Date();
|
|
68
|
+
}
|
|
69
|
+
},
|
|
70
|
+
async fail(instanceId, error) {
|
|
71
|
+
const state = processes.get(instanceId);
|
|
72
|
+
if (state) {
|
|
73
|
+
state.status = 'failed';
|
|
74
|
+
state.error = error;
|
|
75
|
+
state.completedAt = new Date();
|
|
76
|
+
state.updatedAt = new Date();
|
|
77
|
+
}
|
|
78
|
+
},
|
|
79
|
+
async *findByProcessId(processId) {
|
|
80
|
+
for (const state of processes.values()) {
|
|
81
|
+
if (state.processId === processId) {
|
|
82
|
+
yield structuredClone(state);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
async *findByStatus(status) {
|
|
87
|
+
for (const state of processes.values()) {
|
|
88
|
+
if (state.status === status) {
|
|
89
|
+
yield structuredClone(state);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
},
|
|
93
|
+
async *findWaitingForSignal(signal, identity) {
|
|
94
|
+
for (const state of processes.values()) {
|
|
95
|
+
if (state.status !== 'suspended')
|
|
96
|
+
continue;
|
|
97
|
+
const waiting = state.variables['__waitingForSignal'];
|
|
98
|
+
if (waiting !== signal)
|
|
99
|
+
continue;
|
|
100
|
+
// Check identity match
|
|
101
|
+
const stateIdentity = state.variables['__signalIdentity'];
|
|
102
|
+
if (stateIdentity && !matchesIdentity(stateIdentity, identity))
|
|
103
|
+
continue;
|
|
104
|
+
yield structuredClone(state);
|
|
105
|
+
}
|
|
106
|
+
},
|
|
107
|
+
async *findExpiredTimers(before) {
|
|
108
|
+
for (const state of processes.values()) {
|
|
109
|
+
if (state.status !== 'suspended')
|
|
110
|
+
continue;
|
|
111
|
+
for (const timer of state.timers) {
|
|
112
|
+
if (timer.expiresAt <= before) {
|
|
113
|
+
yield structuredClone(state);
|
|
114
|
+
break;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
},
|
|
119
|
+
// === Testing Utilities ===
|
|
120
|
+
clear() {
|
|
121
|
+
processes.clear();
|
|
122
|
+
},
|
|
123
|
+
get size() {
|
|
124
|
+
return processes.size;
|
|
125
|
+
},
|
|
126
|
+
getStats() {
|
|
127
|
+
const stats = {
|
|
128
|
+
pending: 0,
|
|
129
|
+
running: 0,
|
|
130
|
+
suspended: 0,
|
|
131
|
+
completed: 0,
|
|
132
|
+
failed: 0,
|
|
133
|
+
cancelled: 0,
|
|
134
|
+
};
|
|
135
|
+
for (const state of processes.values()) {
|
|
136
|
+
stats[state.status]++;
|
|
137
|
+
}
|
|
138
|
+
return stats;
|
|
139
|
+
},
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* In-memory process storage service for DI.
|
|
144
|
+
*
|
|
145
|
+
* Not suitable for production - state is lost on restart.
|
|
146
|
+
*
|
|
147
|
+
* @example
|
|
148
|
+
* ```typescript
|
|
149
|
+
* // For DI - auto-provides AbstractProcessStorage
|
|
150
|
+
* JustScale()
|
|
151
|
+
* .add(InMemoryProcessStorage)
|
|
152
|
+
* .add(ProcessExecutor)
|
|
153
|
+
* .build()
|
|
154
|
+
*
|
|
155
|
+
* // For testing - use createInMemoryProcessStorage() instead
|
|
156
|
+
* const storage = createInMemoryProcessStorage()
|
|
157
|
+
* ```
|
|
158
|
+
*/
|
|
159
|
+
export class InMemoryProcessStorage extends defineService({
|
|
160
|
+
inject: {},
|
|
161
|
+
provides: [AbstractProcessStorage],
|
|
162
|
+
factory: createInMemoryProcessStorage,
|
|
163
|
+
}) {
|
|
164
|
+
}
|
|
165
|
+
//# sourceMappingURL=storage.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/runtime/process/storage.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @justscale/process - Timer Scheduler
|
|
3
|
+
*
|
|
4
|
+
* Abstraction for scheduling and managing process timers.
|
|
5
|
+
*/
|
|
6
|
+
/**
|
|
7
|
+
* A scheduled timer.
|
|
8
|
+
*/
|
|
9
|
+
export interface ScheduledTimer {
|
|
10
|
+
/** Unique timer ID */
|
|
11
|
+
id: string;
|
|
12
|
+
/** Process instance ID */
|
|
13
|
+
instanceId: string;
|
|
14
|
+
/** When the timer expires */
|
|
15
|
+
expiresAt: Date;
|
|
16
|
+
/** For races, the branch ID */
|
|
17
|
+
branchId?: string;
|
|
18
|
+
/** When the timer was scheduled */
|
|
19
|
+
scheduledAt: Date;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Result when a timer fires.
|
|
23
|
+
*/
|
|
24
|
+
export interface TimerFired {
|
|
25
|
+
/** Timer that fired */
|
|
26
|
+
timerId: string;
|
|
27
|
+
/** Process instance to resume */
|
|
28
|
+
instanceId: string;
|
|
29
|
+
/** For races, which branch won */
|
|
30
|
+
branchId?: string;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Abstract timer scheduler for managing process delays.
|
|
34
|
+
*
|
|
35
|
+
* Implementations:
|
|
36
|
+
* - InMemoryTimerScheduler (testing/development - uses setTimeout)
|
|
37
|
+
* - PgTimerScheduler (production - uses pg_cron or polling)
|
|
38
|
+
*/
|
|
39
|
+
export interface TimerScheduler {
|
|
40
|
+
/**
|
|
41
|
+
* Schedule a timer to fire at a specific time.
|
|
42
|
+
* Returns timer ID for cancellation.
|
|
43
|
+
*/
|
|
44
|
+
schedule(instanceId: string, expiresAt: Date, branchId?: string): Promise<string>;
|
|
45
|
+
/**
|
|
46
|
+
* Cancel a scheduled timer.
|
|
47
|
+
*/
|
|
48
|
+
cancel(timerId: string): Promise<void>;
|
|
49
|
+
/**
|
|
50
|
+
* Cancel all timers for a process instance.
|
|
51
|
+
*/
|
|
52
|
+
cancelAll(instanceId: string): Promise<void>;
|
|
53
|
+
/**
|
|
54
|
+
* Register a callback for when timers fire.
|
|
55
|
+
*/
|
|
56
|
+
onFire(callback: (fired: TimerFired) => void): () => void;
|
|
57
|
+
/**
|
|
58
|
+
* Receive an externally-fired timer event.
|
|
59
|
+
* Used by scheduled task transport to inject fired timers.
|
|
60
|
+
*/
|
|
61
|
+
receiveFire(fired: TimerFired): void;
|
|
62
|
+
/**
|
|
63
|
+
* Check for and fire any expired timers.
|
|
64
|
+
* For polling-based implementations.
|
|
65
|
+
*/
|
|
66
|
+
checkExpired(now?: Date): Promise<TimerFired[]>;
|
|
67
|
+
/**
|
|
68
|
+
* Start the scheduler (begin processing timers).
|
|
69
|
+
*/
|
|
70
|
+
start(): void;
|
|
71
|
+
/**
|
|
72
|
+
* Stop the scheduler.
|
|
73
|
+
*/
|
|
74
|
+
stop(): void;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* In-memory timer scheduler using setTimeout.
|
|
78
|
+
*
|
|
79
|
+
* Suitable for testing and single-node development.
|
|
80
|
+
* Not suitable for production - timers lost on restart.
|
|
81
|
+
*/
|
|
82
|
+
export declare class InMemoryTimerScheduler implements TimerScheduler {
|
|
83
|
+
private static readonly TIMEOUT_MAX_MS;
|
|
84
|
+
private timers;
|
|
85
|
+
private timeoutHandles;
|
|
86
|
+
private fireCallbacks;
|
|
87
|
+
private nextId;
|
|
88
|
+
private running;
|
|
89
|
+
private generateId;
|
|
90
|
+
schedule(instanceId: string, expiresAt: Date, branchId?: string): Promise<string>;
|
|
91
|
+
cancel(timerId: string): Promise<void>;
|
|
92
|
+
cancelAll(instanceId: string): Promise<void>;
|
|
93
|
+
onFire(callback: (fired: TimerFired) => void): () => void;
|
|
94
|
+
receiveFire(fired: TimerFired): void;
|
|
95
|
+
checkExpired(now?: Date): Promise<TimerFired[]>;
|
|
96
|
+
start(): void;
|
|
97
|
+
stop(): void;
|
|
98
|
+
private scheduleTimeout;
|
|
99
|
+
private notifyFire;
|
|
100
|
+
/** Clear all timers */
|
|
101
|
+
clear(): void;
|
|
102
|
+
/** Clear all timers without removing fire callbacks (for test cleanup between tests) */
|
|
103
|
+
clearTimers(): void;
|
|
104
|
+
/** Get timer count */
|
|
105
|
+
get timerCount(): number;
|
|
106
|
+
/** Get pending timer count (alias for timerCount) */
|
|
107
|
+
get pendingCount(): number;
|
|
108
|
+
/** Advance time and fire expired timers (for testing) */
|
|
109
|
+
advanceTo(time: Date): Promise<TimerFired[]>;
|
|
110
|
+
/** Fire the next timer immediately (for testing) */
|
|
111
|
+
fireNext(): void;
|
|
112
|
+
/** Get all timers (for debugging) */
|
|
113
|
+
getTimers(): ScheduledTimer[];
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=timer-scheduler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"timer-scheduler.d.ts","sourceRoot":"","sources":["../../../src/runtime/process/timer-scheduler.ts"],"names":[],"mappings":"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"}
|