@void/deploy-core 0.24.0 → 0.26.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
@@ -243,6 +247,12 @@ type MigrationPlanHashInput = SqlMigrationClassification & {
 export declare function canonicalSql(sql: string): string;
 export declare function hasStandalonePragma(sql: string, pragma: string): boolean;
 export declare function isSingleStatement(sql: string): boolean;
+/**
+ * Split SQL on top-level semicolons, ignoring literals and comments. Returns
+ * null when a statement may contain a compound `BEGIN ... END` body (such as
+ * CREATE TRIGGER), whose inner semicolons cannot be told apart lexically.
+ */
+export declare function splitSqlStatements(sql: string): Array<string> | null;
 /** Classify SQL without imposing the caller's execution policy or hashing implementation. */
 export declare function classifySqlMigration(sql: string): SqlMigrationClassification;
 /** Preserve the classifier-v1 hash preimage; policy markers and warnings are not hashed. */

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;
@@ -546,30 +552,57 @@ function hasStatementBreakpointOutsideLiterals(sql) {
 	}
 	return false;
 }
-function isSingleStatement(sql) {
+function scanStatements(sql) {
 	const normalized = canonicalSql(sql);
-	let statements = 0;
+	const ranges = [];
+	let cursor = 0;
 	let inStatement = false;
+	let hasCompoundBody = false;
 	for (const segment of tokenizeSql(normalized)) {
 		if (segment.kind === "line-comment" || segment.kind === "block-comment") continue;
 		if (segment.kind === "string" || segment.kind === "ident-quote") {
 			inStatement = true;
 			continue;
 		}
+		if (/\b(?:BEGIN|TRIGGER)\b/i.test(normalized.slice(segment.start, segment.end))) hasCompoundBody = true;
 		for (let index = segment.start; index < segment.end; index++) {
 			const character = normalized[index];
 			if (character === ";") {
 				if (inStatement) {
-					statements++;
+					ranges.push({
+						start: cursor,
+						end: index + 1
+					});
 					inStatement = false;
 				}
+				cursor = index + 1;
 				continue;
 			}
 			if (character !== " " && character !== "	" && character !== "\n" && character !== "\r") inStatement = true;
 		}
 	}
-	if (inStatement) statements++;
-	return statements === 1;
+	if (inStatement) ranges.push({
+		start: cursor,
+		end: normalized.length
+	});
+	return {
+		normalized,
+		ranges,
+		hasCompoundBody
+	};
+}
+function isSingleStatement(sql) {
+	return scanStatements(sql).ranges.length === 1;
+}
+/**
+* Split SQL on top-level semicolons, ignoring literals and comments. Returns
+* null when a statement may contain a compound `BEGIN ... END` body (such as
+* CREATE TRIGGER), whose inner semicolons cannot be told apart lexically.
+*/
+function splitSqlStatements(sql) {
+	const { normalized, ranges, hasCompoundBody } = scanStatements(sql);
+	if (hasCompoundBody) return null;
+	return ranges.map((range) => normalized.slice(range.start, range.end).trim());
 }
 /** Classify SQL without imposing the caller's execution policy or hashing implementation. */
 function classifySqlMigration(sql) {
@@ -682,4 +715,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, splitSqlStatements, tokenizeSql, validateManifestShape };

package/package.json

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