@queryweave/standard-schema 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QueryWeave contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# `@queryweave/standard-schema`
+
+Standard Schema interoperability for QueryWeave parameters and models.
+
+```ts
+import { fromStandardSchema } from "@queryweave/standard-schema";
+
+param.text().refine(fromStandardSchema(schema)).optional();
+defineQueryModel(definitions, { refine: [fromStandardSchema(crossFieldSchema)] });
+```
+
+The package depends on `@standard-schema/spec` and nothing else. Zod, Valibot, and ArkType are
+development-only dependencies of the test suite, and one shared compatibility contract runs against
+all three. Vendor errors are normalized into QueryWeave `validation_failed` issues.
+
+Asynchronous schemas resolve through `model.decodeAsync`.

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { QueryRefinement } from "@queryweave/core";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/index.d.ts
+/**
+ * Standard Schema interoperability.
+ *
+ * The validator stays a development-time choice: this package depends on the specification alone,
+ * never on Zod, Valibot, ArkType, or any other runtime. Vendor errors are normalized so consumers
+ * only ever see QueryWeave issues.
+ */
+/** Options accepted by {@link fromStandardSchema}. */
+interface StandardSchemaRefinementOptions {
+  /** Label used for diagnostics. Defaults to the schema's own vendor name. */
+  readonly name?: string | undefined;
+}
+/** The refinement produced from a Standard Schema. */
+type StandardSchemaRefinement<TSchema extends StandardSchemaV1> = QueryRefinement<StandardSchemaV1.InferInput<TSchema>, StandardSchemaV1.InferOutput<TSchema>>;
+/**
+ * Adapt any Standard Schema into a QueryWeave refinement.
+ *
+ * Synchronous schemas keep synchronous decoding available. Asynchronous schemas resolve through
+ * `model.decodeAsync`, and transformed outputs flow through to the parameter's value type.
+ */
+declare function fromStandardSchema<TSchema extends StandardSchemaV1>(schema: TSchema, options?: StandardSchemaRefinementOptions): StandardSchemaRefinement<TSchema>;
+//#endregion
+export { StandardSchemaRefinement, StandardSchemaRefinementOptions, fromStandardSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;UAgBiB;;WAEN;;;KAIC,yBAAyB,gBAAgB,oBAAoB,gBACvE,iBAAiB,WAAW,UAC5B,iBAAiB,YAAY;;;;;;;iBAqCf,mBAAmB,gBAAgB,kBACjD,QAAQ,SACR,UAAS,kCACR,yBAAyB"}

package/dist/index.js

@@ -0,0 +1,42 @@
+//#region src/index.ts
+function toPath(segments) {
+	if (segments === void 0) return;
+	const path = [];
+	for (const segment of segments) if (typeof segment === "object") path.push(segment.key);
+	else path.push(segment);
+	return path;
+}
+function toRefinementResult(result) {
+	if (result.issues === void 0) return {
+		ok: true,
+		value: result.value
+	};
+	return {
+		ok: false,
+		issues: result.issues.map((issue) => ({
+			message: issue.message,
+			path: toPath(issue.path)
+		}))
+	};
+}
+/**
+* Adapt any Standard Schema into a QueryWeave refinement.
+*
+* Synchronous schemas keep synchronous decoding available. Asynchronous schemas resolve through
+* `model.decodeAsync`, and transformed outputs flow through to the parameter's value type.
+*/
+function fromStandardSchema(schema, options = {}) {
+	const standard = schema["~standard"];
+	return {
+		name: options.name ?? standard.vendor,
+		refine: (value) => {
+			const outcome = standard.validate(value);
+			if (outcome instanceof Promise) return outcome.then((resolved) => toRefinementResult(resolved));
+			return toRefinementResult(outcome);
+		}
+	};
+}
+
+//#endregion
+export { fromStandardSchema };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  QueryRefinement,\n  QueryRefinementIssue,\n  QueryRefinementResult,\n} from \"@queryweave/core\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Standard Schema interoperability.\n *\n * The validator stays a development-time choice: this package depends on the specification alone,\n * never on Zod, Valibot, ArkType, or any other runtime. Vendor errors are normalized so consumers\n * only ever see QueryWeave issues.\n */\n\n/** Options accepted by {@link fromStandardSchema}. */\nexport interface StandardSchemaRefinementOptions {\n  /** Label used for diagnostics. Defaults to the schema's own vendor name. */\n  readonly name?: string | undefined;\n}\n\n/** The refinement produced from a Standard Schema. */\nexport type StandardSchemaRefinement<TSchema extends StandardSchemaV1> = QueryRefinement<\n  StandardSchemaV1.InferInput<TSchema>,\n  StandardSchemaV1.InferOutput<TSchema>\n>;\n\nfunction toPath(segments: StandardSchemaV1.Issue[\"path\"]): readonly PropertyKey[] | undefined {\n  if (segments === undefined) {\n    return undefined;\n  }\n  const path: PropertyKey[] = [];\n  for (const segment of segments) {\n    if (typeof segment === \"object\") {\n      path.push(segment.key);\n    } else {\n      path.push(segment);\n    }\n  }\n  return path;\n}\n\nfunction toRefinementResult<TOutput>(\n  result: StandardSchemaV1.Result<TOutput>,\n): QueryRefinementResult<TOutput> {\n  if (result.issues === undefined) {\n    return { ok: true, value: result.value };\n  }\n  const issues: QueryRefinementIssue[] = result.issues.map((issue) => ({\n    message: issue.message,\n    path: toPath(issue.path),\n  }));\n  return { ok: false, issues };\n}\n\n/**\n * Adapt any Standard Schema into a QueryWeave refinement.\n *\n * Synchronous schemas keep synchronous decoding available. Asynchronous schemas resolve through\n * `model.decodeAsync`, and transformed outputs flow through to the parameter's value type.\n */\nexport function fromStandardSchema<TSchema extends StandardSchemaV1>(\n  schema: TSchema,\n  options: StandardSchemaRefinementOptions = {},\n): StandardSchemaRefinement<TSchema> {\n  const standard = schema[\"~standard\"];\n\n  return {\n    name: options.name ?? standard.vendor,\n    refine: (value) => {\n      const outcome = standard.validate(value);\n      if (outcome instanceof Promise) {\n        return outcome.then((resolved) =>\n          toRefinementResult(\n            resolved as StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>,\n          ),\n        );\n      }\n      return toRefinementResult(\n        outcome as StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>,\n      );\n    },\n  };\n}\n"],"mappings":";AA2BA,SAAS,OAAO,UAA8E;CAC5F,IAAI,aAAa,QACf;CAEF,MAAM,OAAsB,CAAC;CAC7B,KAAK,MAAM,WAAW,UACpB,IAAI,OAAO,YAAY,UACrB,KAAK,KAAK,QAAQ,GAAG;MAErB,KAAK,KAAK,OAAO;CAGrB,OAAO;AACT;AAEA,SAAS,mBACP,QACgC;CAChC,IAAI,OAAO,WAAW,QACpB,OAAO;EAAE,IAAI;EAAM,OAAO,OAAO;CAAM;CAMzC,OAAO;EAAE,IAAI;EAAO,QAJmB,OAAO,OAAO,KAAK,WAAW;GACnE,SAAS,MAAM;GACf,MAAM,OAAO,MAAM,IAAI;EACzB,EACyB;CAAE;AAC7B;;;;;;;AAQA,SAAgB,mBACd,QACA,UAA2C,CAAC,GACT;CACnC,MAAM,WAAW,OAAO;CAExB,OAAO;EACL,MAAM,QAAQ,QAAQ,SAAS;EAC/B,SAAS,UAAU;GACjB,MAAM,UAAU,SAAS,SAAS,KAAK;GACvC,IAAI,mBAAmB,SACrB,OAAO,QAAQ,MAAM,aACnB,mBACE,QACF,CACF;GAEF,OAAO,mBACL,OACF;EACF;CACF;AACF"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@queryweave/standard-schema",
+  "version": "0.1.0-alpha.1",
+  "description": "Standard Schema interoperability contracts for QueryWeave.",
+  "keywords": [
+    "query",
+    "standard-schema",
+    "state",
+    "url",
+    "validation"
+  ],
+  "homepage": "https://github.com/boussadjra/queryweave#readme",
+  "bugs": {
+    "url": "https://github.com/boussadjra/queryweave/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/boussadjra/queryweave.git",
+    "directory": "packages/standard-schema"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@standard-schema/spec": "1.1.0",
+    "@queryweave/core": "0.1.0-alpha.1"
+  },
+  "devDependencies": {
+    "@queryweave/typescript-config": "0.0.0"
+  },
+  "engines": {
+    "node": ">=24.18.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc -p tsconfig.json",
+    "test:types": "tsc -p tsconfig.json",
+    "package:check": "publint --strict && attw --pack . --profile esm-only",
+    "clean": "node ../../scripts/clean-package.mjs"
+  }
+}