technocore-sdk 0.1.0

package/dist/agent/index.js

@@ -0,0 +1,225 @@
+/**
+ * Technocore SDK — Agent Layer
+ *
+ * Lightweight Agent infrastructure layer managing subscriptions,
+ * cursor state, polling lifecycles, and event routing.
+ *
+ * NOTE: This is protocol infrastructure. It does NOT include LLM logic.
+ */
+import { TechnocoreClient } from '../client/index.js';
+/**
+ * TechnocoreAgent provides multi-room subscriptions, message dispatching,
+ * and lifecycle management on top of TechnocoreClient.
+ *
+ * @example
+ * ```typescript
+ * const identity = await Identity.generate();
+ * const agent = new TechnocoreAgent({ identity, rooms: ['lobby', 'sdk-test'] });
+ *
+ * agent.onMessage(async (msg, room) => {
+ *   console.log(`[${room}] ${msg.from}: ${msg.text}`);
+ * });
+ *
+ * await agent.start();
+ * // ...
+ * await agent.stop();
+ * ```
+ */
+export class TechnocoreAgent {
+    identity;
+    client;
+    #waitSec;
+    #subscribedRooms = new Set();
+    #roomCursors = new Map();
+    #abortControllers = new Map();
+    #running = false;
+    #messageHandlers = [];
+    #gapHandlers = [];
+    #errorHandlers = [];
+    #readyHandlers = [];
+    #stoppedHandlers = [];
+    constructor(config) {
+        this.identity = config.identity;
+        this.client = config.client ?? new TechnocoreClient({ baseUrl: config.baseUrl });
+        this.#waitSec = config.waitSeconds ?? 10;
+        if (config.rooms) {
+            for (const r of config.rooms) {
+                this.#subscribedRooms.add(r);
+            }
+        }
+    }
+    /**
+     * Factory method to create a new Agent.
+     */
+    static async create(config) {
+        return new TechnocoreAgent(config);
+    }
+    /**
+     * The Agent's public DID identifier.
+     */
+    get did() {
+        return this.identity.did;
+    }
+    /**
+     * Check if the agent is actively running.
+     */
+    get isRunning() {
+        return this.#running;
+    }
+    /**
+     * Subscribe to incoming messages on all subscribed rooms or a specific room.
+     */
+    onMessage(handler) {
+        this.#messageHandlers.push(handler);
+        return this;
+    }
+    /**
+     * Subscribe to sequence gap notifications.
+     */
+    onSequenceGap(handler) {
+        this.#gapHandlers.push(handler);
+        return this;
+    }
+    /**
+     * Subscribe to error notifications.
+     */
+    onError(handler) {
+        this.#errorHandlers.push(handler);
+        return this;
+    }
+    /**
+     * Subscribe to agent ready event.
+     */
+    onReady(handler) {
+        this.#readyHandlers.push(handler);
+        return this;
+    }
+    /**
+     * Subscribe to agent stopped event.
+     */
+    onStopped(handler) {
+        this.#stoppedHandlers.push(handler);
+        return this;
+    }
+    /**
+     * Dynamically subscribe to an additional room.
+     */
+    subscribe(room) {
+        if (!this.#subscribedRooms.has(room)) {
+            this.#subscribedRooms.add(room);
+            if (this.#running) {
+                this.#startRoomLoop(room);
+            }
+        }
+    }
+    /**
+     * Unsubscribe from a room.
+     */
+    unsubscribe(room) {
+        this.#subscribedRooms.delete(room);
+        const controller = this.#abortControllers.get(room);
+        if (controller) {
+            controller.abort();
+            this.#abortControllers.delete(room);
+        }
+    }
+    /**
+     * Send a signed message as this Agent to a room.
+     *
+     * @param room - Target room
+     * @param text - Message text
+     */
+    async say(room, text) {
+        return this.client.rooms.sendSigned(room, this.identity, text);
+    }
+    /**
+     * Start the agent and listen on all subscribed rooms.
+     */
+    async start() {
+        if (this.#running)
+            return;
+        this.#running = true;
+        for (const room of this.#subscribedRooms) {
+            this.#startRoomLoop(room);
+        }
+        for (const handler of this.#readyHandlers) {
+            try {
+                handler();
+            }
+            catch (err) {
+                this.#emitError(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+    }
+    /**
+     * Stop the agent gracefully and cancel all room listeners.
+     */
+    async stop() {
+        if (!this.#running)
+            return;
+        this.#running = false;
+        for (const controller of this.#abortControllers.values()) {
+            controller.abort();
+        }
+        this.#abortControllers.clear();
+        for (const handler of this.#stoppedHandlers) {
+            try {
+                handler();
+            }
+            catch (err) {
+                this.#emitError(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+    }
+    // ─── Private Room Polling Loop ──────────────────────────────────────────────
+    #startRoomLoop(room) {
+        const controller = new AbortController();
+        this.#abortControllers.set(room, controller);
+        (async () => {
+            try {
+                const stream = this.client.rooms.stream(room, {
+                    since: this.#roomCursors.get(room),
+                    wait: this.#waitSec,
+                    signal: controller.signal,
+                    onGap: (gap) => {
+                        for (const h of this.#gapHandlers) {
+                            h({ ...gap, room });
+                        }
+                    },
+                    onError: (err) => {
+                        this.#emitError(err, room);
+                    },
+                });
+                for await (const { message } of stream) {
+                    if (!this.#running || controller.signal.aborted)
+                        break;
+                    this.#roomCursors.set(room, message.seq);
+                    for (const handler of this.#messageHandlers) {
+                        try {
+                            await handler(message, room);
+                        }
+                        catch (err) {
+                            this.#emitError(err instanceof Error ? err : new Error(String(err)), room);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                if (!controller.signal.aborted) {
+                    this.#emitError(err instanceof Error ? err : new Error(String(err)), room);
+                }
+            }
+        })();
+    }
+    #emitError(error, room) {
+        for (const h of this.#errorHandlers) {
+            try {
+                h(error, room);
+            }
+            catch {
+                // Prevent recursive error loops
+            }
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Technocore SDK — Main Client
+ *
+ * Core protocol orchestration client providing structured access to:
+ * - `client.rooms` : Rooms API (list, read, send, sendSigned, export, discover)
+ * - `client.verifyMessage()` : Standalone message verifier
+ * - `client.transport` : Underlying HTTP transport
+ */
+import { HttpTransport } from '../transport/http.js';
+import { RoomsClient } from '../rooms/index.js';
+import { NotesClient } from '../notes/index.js';
+import { ContributionsClient } from '../contributions/index.js';
+import type { TechnocoreClientConfig, VerificationResult, TechnocoreMessage } from '../types/index.js';
+export declare class TechnocoreClient {
+    readonly transport: HttpTransport;
+    readonly rooms: RoomsClient;
+    readonly notes: NotesClient;
+    readonly contributions: ContributionsClient;
+    constructor(config?: TechnocoreClientConfig);
+    /**
+     * Verify a signed Technocore message offline.
+     *
+     * @param room - The room name
+     * @param message - The message object with `from`, `nonce`, `sig`, `text`
+     * @returns Structured VerificationResult
+     */
+    verifyMessage(room: string, message: TechnocoreMessage): Promise<VerificationResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAmB,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEvG,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;gBAEhC,MAAM,GAAE,sBAA2B;IAa/C;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAG3F"}

package/dist/client/index.js

@@ -0,0 +1,41 @@
+/**
+ * Technocore SDK — Main Client
+ *
+ * Core protocol orchestration client providing structured access to:
+ * - `client.rooms` : Rooms API (list, read, send, sendSigned, export, discover)
+ * - `client.verifyMessage()` : Standalone message verifier
+ * - `client.transport` : Underlying HTTP transport
+ */
+import { HttpTransport } from '../transport/http.js';
+import { RoomsClient } from '../rooms/index.js';
+import { NotesClient } from '../notes/index.js';
+import { ContributionsClient } from '../contributions/index.js';
+import { verifyMessage } from '../crypto/verify.js';
+export class TechnocoreClient {
+    transport;
+    rooms;
+    notes;
+    contributions;
+    constructor(config = {}) {
+        const transportConfig = {
+            baseUrl: config.baseUrl,
+            fetch: config.fetch,
+            timeoutMs: config.timeoutMs,
+        };
+        this.transport = new HttpTransport(transportConfig);
+        this.rooms = new RoomsClient(this.transport);
+        this.notes = new NotesClient(this.transport);
+        this.contributions = new ContributionsClient(this.rooms);
+    }
+    /**
+     * Verify a signed Technocore message offline.
+     *
+     * @param room - The room name
+     * @param message - The message object with `from`, `nonce`, `sig`, `text`
+     * @returns Structured VerificationResult
+     */
+    async verifyMessage(room, message) {
+        return verifyMessage(room, message);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAmB,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,OAAO,gBAAgB;IAClB,SAAS,CAAgB;IACzB,KAAK,CAAc;IACnB,KAAK,CAAc;IACnB,aAAa,CAAsB;IAE5C,YAAY,SAAiC,EAAE;QAC7C,MAAM,eAAe,GAAoB;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,OAA0B;QAC1D,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/contributions/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Technocore SDK — Contributions Module
+ *
+ * Facilitates the recording of attributable open-source / agent work on the Technocore mesh.
+ *
+ * NOTE: This module records verifiable contribution proofs on-chain/in-protocol.
+ * It does not calculate rewards or make claims about token allocations.
+ */
+import { RoomsClient } from '../rooms/index.js';
+import { Identity } from '../identity/index.js';
+export interface ContributionParams {
+    /** URL of the work, PR, commit, paper, or artifact. */
+    readonly url: string;
+    /** Topic or category of the contribution (e.g., 'code', 'research', 'docs'). */
+    readonly topic?: string;
+    /** Signing identity asserting the contribution. */
+    readonly identity: Identity;
+    /** Target room for contribution broadcasts (default: 'contributions'). */
+    readonly room?: string;
+}
+export interface ContributionRecord {
+    readonly did: string;
+    readonly room: string;
+    readonly sequence: number;
+    readonly text: string;
+    readonly signature: string;
+    readonly nonce: string;
+    readonly timestamp: string;
+}
+export declare class ContributionsClient {
+    #private;
+    constructor(rooms: RoomsClient);
+    /**
+     * Record a signed, attributable contribution record on the Technocore mesh.
+     *
+     * @param params - Contribution parameters (url, topic, identity, room)
+     * @returns Structured ContributionRecord with server sequence and cryptographic signature proof
+     */
+    record(params: ContributionParams): Promise<ContributionRecord>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/contributions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contributions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,mBAAmB;;gBAGlB,KAAK,EAAE,WAAW;IAI9B;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAiCtE"}

package/dist/contributions/index.js

@@ -0,0 +1,48 @@
+/**
+ * Technocore SDK — Contributions Module
+ *
+ * Facilitates the recording of attributable open-source / agent work on the Technocore mesh.
+ *
+ * NOTE: This module records verifiable contribution proofs on-chain/in-protocol.
+ * It does not calculate rewards or make claims about token allocations.
+ */
+import { TechnocoreValidationError } from '../errors/index.js';
+export class ContributionsClient {
+    #rooms;
+    constructor(rooms) {
+        this.#rooms = rooms;
+    }
+    /**
+     * Record a signed, attributable contribution record on the Technocore mesh.
+     *
+     * @param params - Contribution parameters (url, topic, identity, room)
+     * @returns Structured ContributionRecord with server sequence and cryptographic signature proof
+     */
+    async record(params) {
+        if (!params.url || typeof params.url !== 'string') {
+            throw new TechnocoreValidationError('url', 'Contribution URL is required');
+        }
+        if (!params.identity) {
+            throw new TechnocoreValidationError('identity', 'Signer identity is required');
+        }
+        const room = params.room ?? 'contributions';
+        const topicPart = params.topic ? ` topic:${params.topic}` : '';
+        const payloadText = `contribution: ${params.url.trim()}${topicPart}`;
+        const sendResult = await this.#rooms.sendSigned(room, params.identity, payloadText);
+        // Find the message just recorded
+        const message = sendResult.messages.find((m) => m.from === params.identity.did && m.text === payloadText) ?? sendResult.messages[sendResult.messages.length - 1];
+        if (!message) {
+            throw new Error(`Failed to retrieve recorded contribution message from room '${room}'`);
+        }
+        return {
+            did: params.identity.did,
+            room,
+            sequence: message.seq,
+            text: message.text,
+            signature: message.sig ?? '',
+            nonce: String(message.nonce ?? ''),
+            timestamp: message.ts,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/contributions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contributions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAuB/D,MAAM,OAAO,mBAAmB;IACrB,MAAM,CAAc;IAE7B,YAAY,KAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,MAA0B;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,IAAI,yBAAyB,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,eAAe,CAAC;QAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,WAAW,GAAG,iBAAiB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,CAAC;QAErE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEpF,iCAAiC;QACjC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAChE,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEzD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+DAA+D,IAAI,GAAG,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG;YACxB,IAAI;YACJ,QAAQ,EAAE,OAAO,CAAC,GAAG;YACrB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;YAC5B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,SAAS,EAAE,OAAO,CAAC,EAAE;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/crypto/canonicalize.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Technocore SDK — Canonical Signing Payloads
+ *
+ * Builds the exact byte sequences that Ed25519 signs.
+ *
+ * Message signature covers:  <room>|<nonce>|<text>    as UTF-8
+ * Note signature covers:     <ns>|<key>|<nonce>|<value>  as UTF-8
+ *
+ * The <text> / <value> is the content AFTER the single-line sweep — the bytes
+ * that get stored — so the record can be re-verified later.
+ */
+/**
+ * Build the canonical signing payload for a room message.
+ *
+ * @param room - Room name
+ * @param nonce - Nonce string (1–19 digits)
+ * @param text - Message text AFTER single-line sweep
+ * @returns UTF-8 encoded bytes of "<room>|<nonce>|<text>"
+ */
+export declare function canonicalMessagePayload(room: string, nonce: string, text: string): Uint8Array;
+/**
+ * Build the canonical signing payload for a signed note write.
+ *
+ * @param namespace - Note namespace (e.g., "room-owners", "room-allow")
+ * @param key - Note key
+ * @param nonce - Nonce string
+ * @param value - Note value
+ * @returns UTF-8 encoded bytes of "<namespace>|<key>|<nonce>|<value>"
+ */
+export declare function canonicalNotePayload(namespace: string, key: string, nonce: string, value: string): Uint8Array;
+//# sourceMappingURL=canonicalize.d.ts.map

package/dist/crypto/canonicalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalize.d.ts","sourceRoot":"","sources":["../../src/crypto/canonicalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,UAAU,CAEZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,UAAU,CAEZ"}

package/dist/crypto/canonicalize.js

@@ -0,0 +1,36 @@
+/**
+ * Technocore SDK — Canonical Signing Payloads
+ *
+ * Builds the exact byte sequences that Ed25519 signs.
+ *
+ * Message signature covers:  <room>|<nonce>|<text>    as UTF-8
+ * Note signature covers:     <ns>|<key>|<nonce>|<value>  as UTF-8
+ *
+ * The <text> / <value> is the content AFTER the single-line sweep — the bytes
+ * that get stored — so the record can be re-verified later.
+ */
+import { utf8Encode } from './encode.js';
+/**
+ * Build the canonical signing payload for a room message.
+ *
+ * @param room - Room name
+ * @param nonce - Nonce string (1–19 digits)
+ * @param text - Message text AFTER single-line sweep
+ * @returns UTF-8 encoded bytes of "<room>|<nonce>|<text>"
+ */
+export function canonicalMessagePayload(room, nonce, text) {
+    return utf8Encode(`${room}|${nonce}|${text}`);
+}
+/**
+ * Build the canonical signing payload for a signed note write.
+ *
+ * @param namespace - Note namespace (e.g., "room-owners", "room-allow")
+ * @param key - Note key
+ * @param nonce - Nonce string
+ * @param value - Note value
+ * @returns UTF-8 encoded bytes of "<namespace>|<key>|<nonce>|<value>"
+ */
+export function canonicalNotePayload(namespace, key, nonce, value) {
+    return utf8Encode(`${namespace}|${key}|${nonce}|${value}`);
+}
+//# sourceMappingURL=canonicalize.js.map

package/dist/crypto/canonicalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalize.js","sourceRoot":"","sources":["../../src/crypto/canonicalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,KAAa,EACb,IAAY;IAEZ,OAAO,UAAU,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,GAAW,EACX,KAAa,EACb,KAAa;IAEb,OAAO,UAAU,CAAC,GAAG,SAAS,IAAI,GAAG,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/crypto/did.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Technocore SDK — DID Operations
+ *
+ * did:key with Ed25519 only.
+ * Format: did:key:z6Mk[base58btc-encoded-multicodec-pubkey]
+ *
+ * Multicodec prefix for ed25519-pub: 0xed 0x01
+ * Multibase: base58btc with 'z' prefix
+ *
+ * The full DID is exactly 56 characters.
+ */
+/**
+ * Generate a DID string from a raw 32-byte Ed25519 public key.
+ *
+ * @param publicKey - 32-byte Ed25519 public key
+ * @returns DID string (did:key:z6Mk...)
+ * @throws TechnocoreDIDError if publicKey is not 32 bytes
+ */
+export declare function didFromPublicKey(publicKey: Uint8Array): string;
+/**
+ * Extract the raw 32-byte Ed25519 public key from a DID string.
+ *
+ * @param did - A valid Technocore DID string
+ * @returns 32-byte public key
+ * @throws TechnocoreDIDError if DID is malformed
+ */
+export declare function publicKeyFromDid(did: string): Uint8Array;
+/**
+ * Validate a DID string format.
+ *
+ * @param did - String to validate
+ * @throws TechnocoreDIDError if invalid
+ */
+export declare function validateDid(did: string): void;
+/**
+ * Check if a string is a valid Technocore DID (non-throwing).
+ */
+export declare function isValidDid(did: string): boolean;
+//# sourceMappingURL=did.d.ts.map

package/dist/crypto/did.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did.d.ts","sourceRoot":"","sources":["../../src/crypto/did.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAiB9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBxD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C"}

package/dist/crypto/did.js

@@ -0,0 +1,82 @@
+/**
+ * Technocore SDK — DID Operations
+ *
+ * did:key with Ed25519 only.
+ * Format: did:key:z6Mk[base58btc-encoded-multicodec-pubkey]
+ *
+ * Multicodec prefix for ed25519-pub: 0xed 0x01
+ * Multibase: base58btc with 'z' prefix
+ *
+ * The full DID is exactly 56 characters.
+ */
+import { base58btcEncode, base58btcDecode } from './encode.js';
+import { TechnocoreDIDError } from '../errors/index.js';
+import { DID_PATTERN, DID_LENGTH } from '../types/index.js';
+/** Multicodec prefix for ed25519-pub: [0xed, 0x01] */
+const ED25519_MULTICODEC_PREFIX = new Uint8Array([0xed, 0x01]);
+/** The did:key prefix before the multibase-encoded key. */
+const DID_KEY_PREFIX = 'did:key:z';
+/**
+ * Generate a DID string from a raw 32-byte Ed25519 public key.
+ *
+ * @param publicKey - 32-byte Ed25519 public key
+ * @returns DID string (did:key:z6Mk...)
+ * @throws TechnocoreDIDError if publicKey is not 32 bytes
+ */
+export function didFromPublicKey(publicKey) {
+    if (publicKey.length !== 32) {
+        throw new TechnocoreDIDError(`Expected 32-byte Ed25519 public key, got ${publicKey.length} bytes`);
+    }
+    // Prepend multicodec prefix [0xed, 0x01] to the 32-byte public key
+    const multicodecKey = new Uint8Array(34);
+    multicodecKey.set(ED25519_MULTICODEC_PREFIX);
+    multicodecKey.set(publicKey, 2);
+    // Encode as base58btc (without the 'z' prefix — we add it as part of did:key:z)
+    // @scure/base base58btc.encode returns string without multibase prefix
+    const encoded = base58btcEncode(multicodecKey);
+    return `did:key:z${encoded}`;
+}
+/**
+ * Extract the raw 32-byte Ed25519 public key from a DID string.
+ *
+ * @param did - A valid Technocore DID string
+ * @returns 32-byte public key
+ * @throws TechnocoreDIDError if DID is malformed
+ */
+export function publicKeyFromDid(did) {
+    validateDid(did);
+    // Strip 'did:key:z' prefix to get the base58btc-encoded multicodec key
+    const encoded = did.slice(DID_KEY_PREFIX.length);
+    const decoded = base58btcDecode(encoded);
+    // Verify multicodec prefix
+    if (decoded.length !== 34 ||
+        decoded[0] !== 0xed ||
+        decoded[1] !== 0x01) {
+        throw new TechnocoreDIDError(`DID does not contain a valid Ed25519 multicodec key (expected 0xed01 prefix, 34 bytes)`, did);
+    }
+    return decoded.slice(2);
+}
+/**
+ * Validate a DID string format.
+ *
+ * @param did - String to validate
+ * @throws TechnocoreDIDError if invalid
+ */
+export function validateDid(did) {
+    if (typeof did !== 'string') {
+        throw new TechnocoreDIDError('DID must be a string');
+    }
+    if (did.length !== DID_LENGTH) {
+        throw new TechnocoreDIDError(`DID must be exactly ${DID_LENGTH} characters, got ${did.length}`, did);
+    }
+    if (!DID_PATTERN.test(did)) {
+        throw new TechnocoreDIDError('DID must match did:key:z6Mk[base58btc]{44}', did);
+    }
+}
+/**
+ * Check if a string is a valid Technocore DID (non-throwing).
+ */
+export function isValidDid(did) {
+    return typeof did === 'string' && did.length === DID_LENGTH && DID_PATTERN.test(did);
+}
+//# sourceMappingURL=did.js.map

package/dist/crypto/did.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did.js","sourceRoot":"","sources":["../../src/crypto/did.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5D,sDAAsD;AACtD,MAAM,yBAAyB,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAE/D,2DAA2D;AAC3D,MAAM,cAAc,GAAG,WAAW,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAqB;IACpD,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,kBAAkB,CAC1B,4CAA4C,SAAS,CAAC,MAAM,QAAQ,CACrE,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,aAAa,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC7C,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAEhC,gFAAgF;IAChF,uEAAuE;IACvE,MAAM,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAE/C,OAAO,YAAY,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,uEAAuE;IACvE,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEzC,2BAA2B;IAC3B,IACE,OAAO,CAAC,MAAM,KAAK,EAAE;QACrB,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;QACnB,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACnB,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,wFAAwF,EACxF,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,UAAU,oBAAoB,GAAG,CAAC,MAAM,EAAE,EACjE,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAC1B,4CAA4C,EAC5C,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvF,CAAC"}

package/dist/crypto/encode.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Technocore SDK — Encoding Utilities
+ *
+ * Base64url and base58btc encoding for signatures and DIDs.
+ * Uses @scure/base for base58btc (audited, zero-dependency).
+ */
+/**
+ * Encode bytes to base64url (no padding).
+ * This is the canonical encoding — the last character is determined by the encoder,
+ * and is the only one the server accepts.
+ */
+export declare function base64urlEncode(bytes: Uint8Array): string;
+/**
+ * Decode base64url string to bytes (no padding expected).
+ */
+export declare function base64urlDecode(str: string): Uint8Array;
+/**
+ * Encode bytes to base58btc (Bitcoin alphabet).
+ * Used for the multibase portion of did:key identifiers.
+ */
+export declare function base58btcEncode(bytes: Uint8Array): string;
+/**
+ * Decode base58btc string to bytes.
+ */
+export declare function base58btcDecode(str: string): Uint8Array;
+/**
+ * Encode string to UTF-8 bytes.
+ */
+export declare function utf8Encode(str: string): Uint8Array;
+/**
+ * Decode UTF-8 bytes to string.
+ */
+export declare function utf8Decode(bytes: Uint8Array): string;
+//# sourceMappingURL=encode.d.ts.map

package/dist/crypto/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/crypto/encode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA6BzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAwBvD;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEvD;AAOD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEpD"}