@dxos/keys 0.9.1-main.c7dcc2e112 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/keys",
-  "version": "0.9.1-main.c7dcc2e112",
+  "version": "0.10.0",
   "description": "Key utils and definitions.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -27,17 +27,17 @@
   ],
   "dependencies": {
     "ulidx": "^2.3.0",
-    "@dxos/invariant": "0.9.1-main.c7dcc2e112",
-    "@dxos/debug": "0.9.1-main.c7dcc2e112",
-    "@dxos/node-std": "0.9.1-main.c7dcc2e112"
+    "@dxos/debug": "0.10.0",
+    "@dxos/node-std": "0.10.0",
+    "@dxos/invariant": "0.10.0"
   },
   "devDependencies": {
     "base32-decode": "^1.0.0",
     "base32-encode": "^2.0.0",
-    "effect": "3.21.3"
+    "effect": "3.21.4"
   },
   "peerDependencies": {
-    "effect": "3.21.3"
+    "effect": "3.21.4"
   },
   "publishConfig": {
     "access": "public"

package/src/DXN.test.ts

@@ -2,6 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
+import * as Schema from 'effect/Schema';
 import { describe, test } from 'vitest';
 
 import * as DXN from './DXN';
@@ -120,3 +121,19 @@ describe('DXN.getVersion', () => {
     expect(DXN.getVersion(DXN.make('org.dxos.type.calendar'))).toBeUndefined();
   });
 });
+
+describe('DXN.NameSchema', () => {
+  const isName = Schema.is(DXN.NameSchema);
+
+  test('accepts a well-formed NSID name (no dxn: prefix)', ({ expect }) => {
+    expect(isName('com.anthropic.model.claude-sonnet-4-6.default')).toBe(true);
+    expect(isName('org.dxos.provider.edge')).toBe(true);
+    expect(isName('com.meta.model.llama-3-2-1b.instruct')).toBe(true);
+  });
+
+  test('rejects malformed names', ({ expect }) => {
+    expect(isName('single')).toBe(false); // not multi-segment
+    expect(isName('com.example.model.has-hyphen')).toBe(false); // final segment has a hyphen
+    expect(isName('dxn:com.example.type.thing')).toBe(false); // already a full DXN, not a bare name
+  });
+});

package/src/DXN.ts

@@ -57,6 +57,17 @@ export type Name<T extends string> = [string] extends [T]
         : T
     : never;
 
+/**
+ * Effect Schema validating an NSID name — the `dxn:`-less portion — at runtime, mirroring the rules
+ * the {@link Name} type checks at compile time (multi-segment; camelCase final segment). Pairs with
+ * the {@link Name} type for schema fields that hold a bare NSID (e.g. a model id passed to a creator
+ * helper). Named `NameSchema` because a value cannot share the generic `Name` type's name.
+ */
+export const NameSchema: Schema.Schema<string, string> = Schema.String.pipe(
+  Schema.filter((value) => DXN_SPEC_REGEXP.test(`dxn:${value}`), { message: () => 'Invalid NSID name' }),
+  Schema.annotations({ title: 'DXN.Name', description: 'NSID name (the dxn: prefix omitted)' }),
+);
+
 /**
  * Cheap prefix check — does not validate the full DXN grammar.
  * Sufficient for narrowing a URI to a DXN.