mindoodb 0.0.1 → 0.0.3

package/dist/core/uri/MindooURI.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * MindooDB URI scheme for out-of-band exchange of join requests and responses.
+ *
+ * Format: mdb://<type>/<base64url-encoded-JSON>
+ *
+ * Examples:
+ *   mdb://join-request/eyJ2IjoxLCJ1c2VybmFtZSI6...
+ *   mdb://join-response/eyJ2IjoxLCJ0ZW5hbnRJZCI6...
+ *
+ * All payloads include a "v" field (version number) for forward compatibility.
+ * Uses base64url encoding (URL-safe, no padding) so URIs remain valid
+ * in all contexts (URLs, QR codes, email, chat).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeMindooURI = encodeMindooURI;
+exports.decodeMindooURI = decodeMindooURI;
+exports.isMindooURI = isMindooURI;
+const VALID_TYPES = new Set([
+    "join-request",
+    "join-response",
+]);
+const MDB_SCHEME = "mdb://";
+/**
+ * Encode a payload object into a mdb:// URI string.
+ *
+ * The payload MUST contain a "v" field with a numeric version.
+ *
+ * @param type The URI type (e.g. "join-request")
+ * @param payload The payload object to encode (must include "v" field)
+ * @returns A mdb:// URI string
+ * @throws Error if the type is invalid or payload is missing "v" field
+ */
+function encodeMindooURI(type, payload) {
+    if (!VALID_TYPES.has(type)) {
+        throw new Error(`Invalid MindooDB URI type: "${type}". Valid types: ${[...VALID_TYPES].join(", ")}`);
+    }
+    if (typeof payload.v !== "number" || !Number.isInteger(payload.v) || payload.v < 1) {
+        throw new Error(`MindooDB URI payload must contain a "v" field with a positive integer version number`);
+    }
+    const jsonStr = JSON.stringify(payload);
+    const base64url = toBase64Url(jsonStr);
+    return `${MDB_SCHEME}${type}/${base64url}`;
+}
+/**
+ * Decode a mdb:// URI string back into its type and payload.
+ *
+ * @param uri The mdb:// URI string to decode
+ * @returns The decoded URI with type, version, and payload
+ * @throws Error if the URI is malformed or has an invalid type
+ */
+function decodeMindooURI(uri) {
+    if (!uri.startsWith(MDB_SCHEME)) {
+        throw new Error(`Invalid MindooDB URI: must start with "${MDB_SCHEME}"`);
+    }
+    const remainder = uri.substring(MDB_SCHEME.length);
+    const slashIdx = remainder.indexOf("/");
+    if (slashIdx === -1) {
+        throw new Error(`Invalid MindooDB URI: missing type/payload separator "/"`);
+    }
+    const type = remainder.substring(0, slashIdx);
+    const base64urlPayload = remainder.substring(slashIdx + 1);
+    if (!VALID_TYPES.has(type)) {
+        throw new Error(`Invalid MindooDB URI type: "${type}". Valid types: ${[...VALID_TYPES].join(", ")}`);
+    }
+    if (!base64urlPayload) {
+        throw new Error(`Invalid MindooDB URI: empty payload`);
+    }
+    let jsonStr;
+    try {
+        jsonStr = fromBase64Url(base64urlPayload);
+    }
+    catch {
+        throw new Error(`Invalid MindooDB URI: payload is not valid base64url`);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(jsonStr);
+    }
+    catch {
+        throw new Error(`Invalid MindooDB URI: payload is not valid JSON`);
+    }
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        throw new Error(`Invalid MindooDB URI: payload must be a JSON object`);
+    }
+    if (typeof payload.v !== "number" || !Number.isInteger(payload.v) || payload.v < 1) {
+        throw new Error(`Invalid MindooDB URI: payload must contain a "v" field with a positive integer version number`);
+    }
+    return {
+        type: type,
+        version: payload.v,
+        payload: payload,
+    };
+}
+/**
+ * Check if a string is a valid mdb:// URI.
+ *
+ * Performs structural validation only (scheme, type, base64url payload).
+ * Does not validate the payload contents.
+ *
+ * @param value The string to check
+ * @returns True if the string is a valid mdb:// URI
+ */
+function isMindooURI(value) {
+    if (!value.startsWith(MDB_SCHEME)) {
+        return false;
+    }
+    const remainder = value.substring(MDB_SCHEME.length);
+    const slashIdx = remainder.indexOf("/");
+    if (slashIdx === -1) {
+        return false;
+    }
+    const type = remainder.substring(0, slashIdx);
+    const base64urlPayload = remainder.substring(slashIdx + 1);
+    if (!VALID_TYPES.has(type) || !base64urlPayload) {
+        return false;
+    }
+    try {
+        const jsonStr = fromBase64Url(base64urlPayload);
+        const parsed = JSON.parse(jsonStr);
+        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed);
+    }
+    catch {
+        return false;
+    }
+}
+// ==================== Base64url Helpers ====================
+/**
+ * Encode a UTF-8 string to base64url (URL-safe, no padding).
+ */
+function toBase64Url(str) {
+    // Use Buffer if available (Node.js), otherwise TextEncoder + btoa (browser)
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(str, "utf-8")
+            .toString("base64")
+            .replace(/\+/g, "-")
+            .replace(/\//g, "_")
+            .replace(/=+$/, "");
+    }
+    const bytes = new TextEncoder().encode(str);
+    let binary = "";
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary)
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+/**
+ * Decode a base64url string to UTF-8 string.
+ */
+function fromBase64Url(base64url) {
+    // Restore standard base64 characters and padding
+    let base64 = base64url.replace(/-/g, "+").replace(/_/g, "/");
+    const paddingNeeded = (4 - (base64.length % 4)) % 4;
+    base64 += "=".repeat(paddingNeeded);
+    // Use Buffer if available (Node.js), otherwise atob + TextDecoder (browser)
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(base64, "base64").toString("utf-8");
+    }
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return new TextDecoder().decode(bytes);
+}
+//# sourceMappingURL=MindooURI.js.map

package/dist/core/uri/MindooURI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MindooURI.js","sourceRoot":"","sources":["../../../src/core/uri/MindooURI.ts"],"names":[],"mappings":"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"}

package/dist/core/userid/index.d.ts

@@ -7,11 +7,6 @@ export interface PublicUserId {
      * The username of the user (format: "CN=<username>/O=<tenantId>")
      */
     username: string;
-    /**
-     * Signature by the administration key proving that an admin has granted this user
-     * access to the tenant. This signature covers the username and other user identification.
-     */
-    administrationSignature: string;
     /**
      * The public key for signing (Ed25519, PEM format)
      * Used ONLY for signing document changes, not for encryption.
@@ -32,11 +27,6 @@ export interface PrivateUserId {
      * The username of the user (format: "CN=<username>/O=<tenantId>")
      */
     username: string;
-    /**
-     * Signature by the administration key proving that an admin has granted this user
-     * access to the tenant. This signature covers the username and other user identification.
-     */
-    administrationSignature: string;
     /**
      * The signing key pair (Ed25519).
      * Contains both public and encrypted private key.

package/dist/core/userid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/userid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,EAAE,cAAc,CAAC;IAEnC;;;;OAIG;IACH,qBAAqB,EAAE,iBAAiB,CAAC;CAC1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/userid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,kBAAkB,EAAE,cAAc,CAAC;IAEnC;;;;OAIG;IACH,qBAAqB,EAAE,iBAAiB,CAAC;CAC1C"}