@void/deploy-core 0.23.0 → 0.25.0

package/README.md

@@ -1,18 +1,7 @@
 # @void/deploy-core
 
-Shared deployment contracts for the Void SDK and hosted Void platform.
+Shared deployment contracts for Void runtimes and deployment adapters. Includes manifests, progress events, routing rules, resource plans, and SQL and Durable Object migration metadata.
 
-This package owns the wire types exchanged by the `void` CLI and the managed
-platform, including deployment manifests, progress events, assets, routing
-rules, queues, append-only Durable Object migration planning and metadata, normalized upload artifacts, runtime
-manifest validation, and provider-neutral resource planning. It has no
-dependency on either deployment target and must remain usable from Node.js and
-Cloudflare Workers.
+This package works in Node.js and Cloudflare Workers. Applications normally use the `void` CLI rather than these contracts directly.
 
-SQL migration tokenization, classification, and canonical hash inputs are shared
-here. Each target supplies its hashing implementation and independently validates
-submitted plans; CLI execution policy stays in the CLI.
-
-The package also defines the adapter boundary implemented by deployment
-targets. Target-specific orchestration belongs in `void` or `platform/`, not
-here.
+See [Deployment](https://void.cloud/guide/deployment) for deploying an app and [Platform Development](https://void.cloud/guide/platform-development) for working on a runtime or adapter.

package/dist/index.d.mts

@@ -169,6 +169,10 @@ export declare function createDeployUploadPayload(artifact: DeployArtifact, meta
 //#region src/canonical-json.d.ts
 export declare function canonicalJson(value: unknown): string;
 //#endregion
+//#region src/is-record.d.ts
+/** Narrow object-shaped input without accepting null or arrays. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//#endregion
 //#region src/sql-tokenize.d.ts
 /**
  * Char-by-char SQL tokenizer shared by the destructive-SQL guard
@@ -432,6 +436,8 @@ export type DeployEvent = {
   event: "heartbeat";
   deploymentId?: string;
   step: string;
+  status?: "queued" | "running" | "recovering";
+  recoveryAt?: string;
 } | {
   event: "asset_upload";
   total: number;

package/dist/index.mjs

@@ -407,6 +407,12 @@ function canonicalJson(value) {
 	throw new TypeError(`Unsupported canonical JSON value: ${typeof value}`);
 }
 //#endregion
+//#region src/is-record.ts
+/** Narrow object-shaped input without accepting null or arrays. */
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/sql-tokenize.ts
 function* tokenizeSql(sql) {
 	const sqlLength = sql.length;
@@ -682,4 +688,4 @@ function isSandboxRegistryImage(image) {
 	return /^registry\.cloudflare\.com\/[^/@\s]+\/[^@\s]+@sha256:[a-f\d]{64}$/.test(image);
 }
 //#endregion
-export { DEPLOY_ARTIFACT_VERSION, MANIFEST_REDIRECT_RULE_STATUSES, MAX_REVALIDATE_QUERY_ALLOWLIST_ENTRIES, MAX_ROUTING_RULES, MIGRATION_CLASSIFIER_VERSION, SUPPORTED_MANIFEST_VERSIONS, UNSPLIT_MULTI_STATEMENT_PRAGMA, appendSqliteClassMigration, canonicalJson, canonicalSql, classifySqlMigration, createDeployArtifact, createDeployIntent, createDeployResourcePlan, createDeployUploadPayload, getMigrationPlanHashInput, hasStandalonePragma, isSandboxRegistryImage, isSingleStatement, planWebSocketMigrations, tokenizeSql, validateManifestShape };
+export { DEPLOY_ARTIFACT_VERSION, MANIFEST_REDIRECT_RULE_STATUSES, MAX_REVALIDATE_QUERY_ALLOWLIST_ENTRIES, MAX_ROUTING_RULES, MIGRATION_CLASSIFIER_VERSION, SUPPORTED_MANIFEST_VERSIONS, UNSPLIT_MULTI_STATEMENT_PRAGMA, appendSqliteClassMigration, canonicalJson, canonicalSql, classifySqlMigration, createDeployArtifact, createDeployIntent, createDeployResourcePlan, createDeployUploadPayload, getMigrationPlanHashInput, hasStandalonePragma, isRecord, isSandboxRegistryImage, isSingleStatement, planWebSocketMigrations, tokenizeSql, validateManifestShape };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/deploy-core",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/voidzero-dev/void.git",