@c9up/rune 0.1.7 → 0.1.9

package/dist/native.d.ts

@@ -16,12 +16,24 @@ export declare function validateNative(requestJson: string): {
     data?: Record<string, unknown>;
 };
 export declare function isNativeAvailable(): boolean;
+/** Raised when a schema needs the Rust engine and it is not there. */
+export declare class RuneNativeRequiredError extends Error {
+    readonly code: "RUNE_NAPI_REQUIRED";
+    constructor();
+}
 /**
- * Surface — exactly once per process — that the native engine is unavailable so
- * the schema is falling back to the TypeScript validator. The two paths can
- * differ subtly, so a silent fallback makes validation results depend on whether
- * the prebuilt binary loaded (platform-dependent). Callers invoke this only when
- * they WOULD have used the native engine (no custom rules / translator).
+ * Refuse to validate without the native engine.
+ *
+ * There is a TypeScript validator, and it used to take over silently with a
+ * one-time warning. That made a schema's verdict depend on whether a prebuilt
+ * binary happened to load: two deployments of the same code could disagree on
+ * whether a payload is valid, and the one that fell back lost the reason to
+ * have Rust at all. A schema the engine can run is now run BY the engine or
+ * not at all.
+ *
+ * The TypeScript path stays for what the engine genuinely cannot do — custom
+ * rules, a translator, a messages provider — where it is the only
+ * implementation, not a second one.
  */
-export declare function warnNativeUnavailableOnce(): void;
+export declare function assertNativeAvailable(): void;
 //# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAaA;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAehD"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAaA;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAaD,sEAAsE;AACtE,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;;CAQ9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/native.js

@@ -43,26 +43,41 @@ export function validateNative(requestJson) {
 export function isNativeAvailable() {
     return native !== undefined;
 }
-let warnedFallback = false;
+/** Why the engine could not be loaded, phrased for whoever has to fix it. */
+function unavailableReason() {
+    const target = `${platform}-${arch}`;
+    if (loadError !== undefined) {
+        return `failed to load (${loadError instanceof Error ? loadError.message : String(loadError)})`;
+    }
+    return platformMap[target] !== undefined
+        ? "binary not found"
+        : `no prebuilt binary for ${target}`;
+}
+/** Raised when a schema needs the Rust engine and it is not there. */
+export class RuneNativeRequiredError extends Error {
+    code = "RUNE_NAPI_REQUIRED";
+    constructor() {
+        super(`[RUNE_NAPI_REQUIRED] The Rust validation engine is required but not loaded — ${unavailableReason()}.\n` +
+            "Install the prebuilt binary for this platform, or build it with `pnpm build:napi`.");
+        this.name = "RuneNativeRequiredError";
+    }
+}
 /**
- * Surface — exactly once per process — that the native engine is unavailable so
- * the schema is falling back to the TypeScript validator. The two paths can
- * differ subtly, so a silent fallback makes validation results depend on whether
- * the prebuilt binary loaded (platform-dependent). Callers invoke this only when
- * they WOULD have used the native engine (no custom rules / translator).
+ * Refuse to validate without the native engine.
+ *
+ * There is a TypeScript validator, and it used to take over silently with a
+ * one-time warning. That made a schema's verdict depend on whether a prebuilt
+ * binary happened to load: two deployments of the same code could disagree on
+ * whether a payload is valid, and the one that fell back lost the reason to
+ * have Rust at all. A schema the engine can run is now run BY the engine or
+ * not at all.
+ *
+ * The TypeScript path stays for what the engine genuinely cannot do — custom
+ * rules, a translator, a messages provider — where it is the only
+ * implementation, not a second one.
  */
-export function warnNativeUnavailableOnce() {
-    if (warnedFallback)
-        return;
-    warnedFallback = true;
-    const target = `${platform}-${arch}`;
-    const reason = loadError !== undefined
-        ? `failed to load (${loadError instanceof Error ? loadError.message : String(loadError)})`
-        : platformMap[target] !== undefined
-            ? "binary not found"
-            : `no prebuilt binary for ${target}`;
-    console.warn(`[rune] native validation engine unavailable — ${reason}. Falling back to the ` +
-        "TypeScript validator, whose results can differ subtly from the Rust engine — " +
-        "validation is platform-dependent for this process.");
+export function assertNativeAvailable() {
+    if (native === undefined)
+        throw new RuneNativeRequiredError();
 }
 //# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -1 +1 @@
-{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE3D,MAAM,WAAW,GAA2B;IAC3C,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,iBAAiB;IAChC,YAAY,EAAE,YAAY;IAC1B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,gBAAgB;CAC7B,CAAC;AAEF,IAAI,MAA0D,CAAC;AAC/D,IAAI,SAAkB,CAAC;AAEvB,IAAI,CAAC;IACJ,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,MAAM,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;AACF,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACZ,SAAS,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAKjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,+DAA+D,SAAS,IAAI,kBAAkB,EAAE,CAChG,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACd,uEAAuE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC/F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,OAAO,MAAM,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB;IACxC,IAAI,cAAc;QAAE,OAAO;IAC3B,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IACrC,MAAM,MAAM,GACX,SAAS,KAAK,SAAS;QACtB,CAAC,CAAC,mBAAmB,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG;QAC1F,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,SAAS;YAClC,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,0BAA0B,MAAM,EAAE,CAAC;IACxC,OAAO,CAAC,IAAI,CACX,iDAAiD,MAAM,wBAAwB;QAC9E,+EAA+E;QAC/E,oDAAoD,CACrD,CAAC;AACH,CAAC"}
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE3D,MAAM,WAAW,GAA2B;IAC3C,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,iBAAiB;IAChC,YAAY,EAAE,YAAY;IAC1B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,gBAAgB;CAC7B,CAAC;AAEF,IAAI,MAA0D,CAAC;AAC/D,IAAI,SAAkB,CAAC;AAEvB,IAAI,CAAC;IACJ,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,MAAM,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;AACF,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACZ,SAAS,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB;IAKjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,+DAA+D,SAAS,IAAI,kBAAkB,EAAE,CAChG,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACd,uEAAuE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC/F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,OAAO,MAAM,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,6EAA6E;AAC7E,SAAS,iBAAiB;IACzB,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IACrC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,mBAAmB,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;IACjG,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,SAAS;QACvC,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,0BAA0B,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,sEAAsE;AACtE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACxC,IAAI,GAAG,oBAA6B,CAAC;IAC9C;QACC,KAAK,CACJ,gFAAgF,iBAAiB,EAAE,KAAK;YACvG,oFAAoF,CACrF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACvC,CAAC;CACD;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,uBAAuB,EAAE,CAAC;AAC/D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module @c9up/rune/types
+ * @description
+ * Type-only surface, mirroring `@vinejs/vine/types`.
+ *
+ * A separate subpath so a consumer can `import type { FieldContext } from
+ * "@c9up/rune/types"` exactly as it would from Vine — importing types through
+ * the value entrypoint pulls the whole module graph into a file that only
+ * needed a signature.
+ */
+export type { DateFormat } from "./date.js";
+export type { AlphaOptions, EmailOptions, NormalizeEmailOptions, NormalizeUrlOptions, UrlOptions, } from "./formats.js";
+export type { MessageArgs, MessagesProviderContract, ValidationFields, ValidationMessages, } from "./MessagesProvider.js";
+export type { AsyncCompiledRule, AsyncRuleValidator, CompiledRule, ConditionalBranch, ConditionalGroup, CreateRuleOptions, DatabaseLookup, DatabaseResolver, DatabaseRuleOptions, ErrorReporterContract, ErrorReporterFactory, FieldContext, FileLike, HostResolver, Infer, JsonSchemaModifier, ParseContext, RuleChain, RuleDef, RuleValidator, SchemaIntrospection, UnionBranch, ValidateOptions, ValidationError, ValidationMessageParams, ValidationResult, ValidationSchema, ValidationTranslator, } from "./Schema.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,WAAW,EACX,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,aAAa,CAAC"}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * @module @c9up/rune/types
+ * @description
+ * Type-only surface, mirroring `@vinejs/vine/types`.
+ *
+ * A separate subpath so a consumer can `import type { FieldContext } from
+ * "@c9up/rune/types"` exactly as it would from Vine — importing types through
+ * the value entrypoint pulls the whole module graph into a file that only
+ * needed a signature.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/rune",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Rune — Validation engine for the Ream framework",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
     }
   },
   "publishConfig": {

package/src/MessagesProvider.ts

@@ -39,7 +39,7 @@ export interface MessagesProviderContract {
  * Replace a dotted field path's numeric segments with `*` so array items share
  * a single wildcard message key — `tags.0.name` → `tags.*.name` (VineJS parity).
  */
-function toWildcardPath(field: string): string {
+export function toWildcardPath(field: string): string {
 	return field
 		.split(".")
 		.map((segment) => (/^\d+$/.test(segment) ? "*" : segment))