@dxos/keys 0.7.5-labs.35b4b42 → 0.7.5-labs.a279d8c

package/src/dxn.ts

@@ -41,8 +41,7 @@ export class DXN {
      */
     ECHO: 'echo',
     /**
-     * The subspace tag enables us to partition queues by usage within the context of a space.
-     * dxn:queue:<subspace_tag>:<space_id>:<queue_id>[:object_id]
+     * dxn:queue:<subspace tag>:<space id>:<queue id>[:object id]
      * dxn:queue:data:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
      * dxn:queue:trace:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
      */
@@ -57,32 +56,38 @@ export class DXN {
     return dxn.startsWith('dxn:');
   }
 
-  static parse(dxn: string): DXN {
+  static parse(dxn: string): DXN;
+  static parse(dxn: string, noThrow: boolean): DXN | undefined;
+  static parse(dxn: string, noThrow?: boolean): DXN | undefined {
     if (typeof dxn !== 'string') {
+      if (noThrow) {
+        return undefined;
+      }
       throw new Error(`Invalid DXN: ${dxn}`);
     }
     const [prefix, kind, ...parts] = dxn.split(':');
     if (!(prefix === 'dxn')) {
+      if (noThrow) {
+        return undefined;
+      }
       throw new Error(`Invalid DXN: ${dxn}`);
     }
     if (!(typeof kind === 'string' && kind.length > 0)) {
+      if (noThrow) {
+        return undefined;
+      }
       throw new Error(`Invalid DXN: ${dxn}`);
     }
     if (!(parts.length > 0)) {
+      if (noThrow) {
+        return undefined;
+      }
       throw new Error(`Invalid DXN: ${dxn}`);
     }
 
     return new DXN(kind, parts);
   }
 
-  static tryParse(dxn: string) {
-    try {
-      return DXN.parse(dxn);
-    } catch (error) {
-      return undefined;
-    }
-  }
-
   /**
    * @example `dxn:type:example.com/type/Contact`
    */
@@ -180,7 +185,6 @@ export class DXN {
     if (typeof queueId !== 'string') {
       return undefined;
     }
-
     return {
       subspaceTag,
       spaceId: spaceId as SpaceId,

package/src/index.ts

@@ -2,7 +2,6 @@
 // Copyright 2020 DXOS.org
 //
 
-export * from './identity-did';
 export * from './public-key';
 export * from './types';
 export * from './space-id';

package/dist/types/src/identity-did.d.ts

@@ -1,16 +0,0 @@
-/**
- * A unique identifier for a space.
- * Space keys are generated by creating a keypair, and then taking the first 20 bytes of the SHA-256 hash of the public key and encoding them to multibase RFC4648 base-32 format (prefixed with B, see Multibase Table).
- * @example did:halo:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE
- */
-export type IdentityDid = string & {
-    __IdentityDid: true;
-};
-export declare const IdentityDid: Readonly<{
-    byteLength: 20;
-    encode: (value: Uint8Array) => IdentityDid;
-    decode: (value: IdentityDid) => Uint8Array;
-    isValid: (value: string) => value is IdentityDid;
-    random: () => IdentityDid;
-}>;
-//# sourceMappingURL=identity-did.d.ts.map

package/dist/types/src/identity-did.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity-did.d.ts","sourceRoot":"","sources":["../../../src/identity-did.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC;AAE3D,eAAO,MAAM,WAAW;;oBAEN,UAAU,KAAG,WAAW;oBAMxB,WAAW,KAAG,UAAU;qBAKvB,MAAM,KAAG,KAAK,IAAI,WAAW;kBAKlC,WAAW;EAGvB,CAAC"}

package/dist/types/src/identity-did.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=identity-did.test.d.ts.map

package/dist/types/src/identity-did.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity-did.test.d.ts","sourceRoot":"","sources":["../../../src/identity-did.test.ts"],"names":[],"mappings":""}

package/src/identity-did.test.ts

@@ -1,17 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { expect, test } from 'vitest';
-
-import { IdentityDid } from './identity-did';
-
-test('identity-did', () => {
-  const id = IdentityDid.random();
-
-  expect(id.length).toBe(42);
-  expect(IdentityDid.isValid(id)).toBe(true);
-  const decoded = IdentityDid.decode(id);
-  expect(decoded.length).toBe(IdentityDid.byteLength);
-  expect(IdentityDid.encode(decoded)).toBe(id);
-});

package/src/identity-did.ts

@@ -1,49 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import base32Decode from 'base32-decode';
-import base32Encode from 'base32-encode';
-
-import { invariant } from '@dxos/invariant';
-
-import { randomBytes } from './random-bytes';
-
-/**
- * A unique identifier for a space.
- * Space keys are generated by creating a keypair, and then taking the first 20 bytes of the SHA-256 hash of the public key and encoding them to multibase RFC4648 base-32 format (prefixed with B, see Multibase Table).
- * @example did:halo:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE
- */
-export type IdentityDid = string & { __IdentityDid: true };
-
-export const IdentityDid = Object.freeze({
-  byteLength: 20,
-  encode: (value: Uint8Array): IdentityDid => {
-    invariant(value instanceof Uint8Array, 'Invalid type');
-    invariant(value.length === IdentityDid.byteLength, 'Invalid length');
-
-    return (DID_PREFIX + MULTIBASE_PREFIX + base32Encode(value, 'RFC4648')) as IdentityDid;
-  },
-  decode: (value: IdentityDid): Uint8Array => {
-    invariant(value.startsWith(DID_PREFIX + MULTIBASE_PREFIX), 'Invalid multibase32 encoding');
-
-    return new Uint8Array(base32Decode(value.slice(10), 'RFC4648'));
-  },
-  isValid: (value: string): value is IdentityDid => {
-    return (
-      typeof value === 'string' && value.startsWith(DID_PREFIX + MULTIBASE_PREFIX) && value.length === ENCODED_LENGTH
-    );
-  },
-  random: (): IdentityDid => {
-    return IdentityDid.encode(randomBytes(IdentityDid.byteLength));
-  },
-});
-
-/**
- * Denotes RFC4648 base-32 format.
- */
-const MULTIBASE_PREFIX = 'B';
-
-const DID_PREFIX = 'did:halo:';
-
-const ENCODED_LENGTH = 42;