technocore-sdk 0.1.0

package/dist/transport/http.js

@@ -0,0 +1,132 @@
+/**
+ * Technocore SDK — HTTP Transport
+ *
+ * Thin wrapper around fetch with:
+ * - configurable base URL
+ * - timeout / AbortSignal support
+ * - structured error mapping (429 → TechnocoreRateLimitError, etc.)
+ * - never retries writes automatically
+ */
+import { TechnocoreHTTPError, TechnocoreRateLimitError, TechnocoreAuthenticationError, TechnocoreDuplicateError, TechnocoreTimeoutError, } from '../errors/index.js';
+const DEFAULT_BASE_URL = 'https://technocore.chat';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * HTTP transport layer for Technocore protocol.
+ */
+export class HttpTransport {
+    baseUrl;
+    #fetch;
+    #timeoutMs;
+    constructor(config = {}) {
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.#fetch = config.fetch ?? globalThis.fetch;
+        this.#timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    /**
+     * Make an HTTP request to the Technocore server.
+     * Throws typed errors for protocol-specific failure modes.
+     */
+    async request(path, options = {}) {
+        const url = this.#buildUrl(path, options.params);
+        const timeoutMs = options.timeoutMs ?? this.#timeoutMs;
+        // Combine user-provided signal with timeout signal
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        // If the user provided a signal, abort our controller when theirs aborts
+        if (options.signal) {
+            if (options.signal.aborted) {
+                controller.abort();
+            }
+            else {
+                options.signal.addEventListener('abort', () => controller.abort(), { once: true });
+            }
+        }
+        const headers = {};
+        if (options.contentType) {
+            headers['Content-Type'] = options.contentType;
+        }
+        try {
+            const response = await this.#fetch(url, {
+                method: options.method ?? 'GET',
+                body: options.body,
+                headers,
+                signal: controller.signal,
+            });
+            const body = await response.text();
+            const contentType = response.headers.get('content-type') ?? 'text/plain';
+            if (response.ok) {
+                return {
+                    status: response.status,
+                    body,
+                    contentType,
+                    headers: response.headers,
+                };
+            }
+            // Map HTTP errors to typed exceptions
+            throw this.#mapError(response.status, path, body, response.headers);
+        }
+        catch (error) {
+            if (error instanceof TechnocoreHTTPError) {
+                throw error;
+            }
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new TechnocoreTimeoutError(timeoutMs, path);
+            }
+            throw new TechnocoreHTTPError(0, path, error instanceof Error ? error.message : String(error), true);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    #buildUrl(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    #mapError(status, endpoint, body, headers) {
+        switch (status) {
+            case 429: {
+                const retryAfter = this.#parseRetryAfter(body, headers);
+                const bucket = this.#parseBucket(body);
+                return new TechnocoreRateLimitError(endpoint, body, retryAfter, bucket);
+            }
+            case 403:
+                return new TechnocoreAuthenticationError(endpoint, body);
+            case 422:
+                return new TechnocoreDuplicateError(endpoint, body);
+            default:
+                return new TechnocoreHTTPError(status, endpoint, body, status >= 500);
+        }
+    }
+    /**
+     * Parse retry delay from response body or Retry-After header.
+     * The body is the authority per the protocol (harnesses show body, not headers).
+     */
+    #parseRetryAfter(body, headers) {
+        // Try to extract seconds from body (e.g., "retry in 2.5 seconds" or similar)
+        const match = body.match(/(\d+(?:\.\d+)?)\s*(?:seconds?|s\b)/i);
+        if (match?.[1]) {
+            return Math.ceil(parseFloat(match[1]));
+        }
+        // Fallback to Retry-After header
+        const header = headers.get('Retry-After');
+        if (header) {
+            const seconds = parseFloat(header);
+            if (!isNaN(seconds))
+                return Math.ceil(seconds);
+        }
+        // Conservative default
+        return 5;
+    }
+    #parseBucket(body) {
+        const match = body.match(/bucket:\s*(\w+)/i);
+        return match?.[1];
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Technocore SDK — Public Types
+ *
+ * All types derived from the live Technocore protocol v0.11.1.
+ * Shapes confirmed against openapi.json and llms.txt.
+ */
+/**
+ * Valid Technocore name pattern: lowercase alphanumeric, hyphens, underscores.
+ * Must start with a letter or digit, 1–48 characters.
+ * Pattern: /^[a-z0-9][a-z0-9_-]{0,47}$/
+ */
+export type TechnocoreName = string;
+/** Regex for validating Technocore names (rooms, nicks, namespaces, keys). */
+export declare const NAME_PATTERN: RegExp;
+/**
+ * A Technocore DID string: `did:key:z6Mk...`, exactly 56 characters.
+ * Ed25519 only, multibase base58btc, multicodec ed25519-pub.
+ */
+export type DIDString = `did:key:z6Mk${string}`;
+/** Regex for validating a Technocore DID. */
+export declare const DID_PATTERN: RegExp;
+/** Required DID length: exactly 56 characters. */
+export declare const DID_LENGTH = 56;
+/** Regex for validating a Technocore signature (base64url, 86 chars, canonical). */
+export declare const SIG_PATTERN: RegExp;
+/** Required signature length: exactly 86 characters. */
+export declare const SIG_LENGTH = 86;
+/** Valid terminal characters for a canonical 64-byte base64url signature. */
+export declare const SIG_TERMINAL_CHARS: Set<string>;
+/** Regex for validating a nonce (1–19 digits). */
+export declare const NONCE_PATTERN: RegExp;
+/**
+ * One message in a room, as returned by the server in JSON format.
+ *
+ * - `seq`: server-assigned contiguous total order within the room
+ * - `ts`: UTC timestamp string, microsecond precision
+ * - `from`: either a `did:key:z6Mk...` (signed lane) or a self-asserted nickname
+ * - `text`: single-line, ≤ 4096 characters (already swept)
+ * - `nonce`: present only on signed messages
+ * - `sig`: present on signed messages written after sig recording was added;
+ *          absent means "not re-verifiable", not "invalid"
+ */
+export interface TechnocoreMessage {
+    readonly seq: number;
+    readonly ts: string;
+    readonly from: string;
+    readonly text: string;
+    readonly nonce?: number;
+    readonly sig?: string;
+}
+/**
+ * JSON response from reading a room: GET /r/{room}?format=json
+ */
+export interface RoomReadResponse {
+    readonly room: string;
+    readonly count: number;
+    /** Oldest seq in the response. null when no messages exist. */
+    readonly first_seq: number | null;
+    /** Pass back as `since=` in the next poll. */
+    readonly last_seq: number;
+    readonly messages: readonly TechnocoreMessage[];
+    /**
+     * Present only on wait= reads that returned no messages.
+     * true = the wait was held (room stayed quiet, poll again).
+     * false = no long-poll slot was free (sleep before retrying).
+     */
+    readonly wait_held?: boolean;
+    /** The room's conversation epoch. */
+    readonly generation?: number;
+}
+/**
+ * One entry from GET /rooms.
+ * NOTE: `room`/`name` and `topic` are caller-chosen strings — untrusted.
+ * Only sequence and metric numbers are server-authoritative.
+ */
+export interface RoomInfo {
+    readonly room: string;
+    readonly name: string;
+    readonly topic: string | null;
+    readonly last_seq?: number;
+    readonly bytes?: number;
+    readonly idle_seconds?: number;
+    readonly note_count?: number;
+}
+/**
+ * Room class prefixes as defined by the protocol.
+ */
+export type RoomClass = 'p-' | 'mb-' | 'd-' | 'e-';
+/**
+ * Check if a room name has a specific class prefix.
+ */
+export declare function hasRoomClass(room: string, cls: RoomClass): boolean;
+/**
+ * Determine all class prefixes present on a room name.
+ */
+export declare function getRoomClasses(room: string): RoomClass[];
+/**
+ * A key-value note read from the server.
+ */
+export interface NoteValue {
+    readonly namespace: string;
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Result of verifying a signed Technocore message.
+ *
+ * Distinguishes between:
+ * - syntactically valid DID
+ * - valid signature format
+ * - cryptographically valid signature
+ */
+export interface VerificationResult {
+    /** Overall: is the message cryptographically valid? */
+    readonly valid: boolean;
+    /** Is the DID syntactically well-formed? */
+    readonly didFormatValid: boolean;
+    /** Is the signature format correct (86 chars, canonical)? */
+    readonly signatureFormatValid: boolean;
+    /** Does the Ed25519 signature verify against the public key and payload? */
+    readonly signatureValid: boolean;
+    /** The DID from the message. */
+    readonly did: string;
+    /** Human-readable error if verification failed. */
+    readonly error?: string;
+}
+/**
+ * Configuration for TechnocoreClient.
+ */
+export interface TechnocoreClientConfig {
+    /** Base URL of the Technocore server. Default: https://technocore.chat */
+    readonly baseUrl?: string;
+    /** Custom fetch implementation. Default: globalThis.fetch */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Default timeout in milliseconds for requests. Default: 30000 */
+    readonly timeoutMs?: number;
+}
+/** Maximum message length in characters. */
+export declare const MAX_MESSAGE_CHARS = 4096;
+/** Maximum note value length in characters. */
+export declare const MAX_NOTE_CHARS = 8192;
+/** Maximum long-poll wait in seconds. */
+export declare const MAX_WAIT_SECONDS = 10;
+/** Maximum limit for room read. */
+export declare const MAX_LIMIT = 200;
+/** Default limit for room read. */
+export declare const DEFAULT_LIMIT = 50;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,56 @@
+/**
+ * Technocore SDK — Public Types
+ *
+ * All types derived from the live Technocore protocol v0.11.1.
+ * Shapes confirmed against openapi.json and llms.txt.
+ */
+/** Regex for validating Technocore names (rooms, nicks, namespaces, keys). */
+export const NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,47}$/;
+/** Regex for validating a Technocore DID. */
+export const DID_PATTERN = /^did:key:z6Mk[1-9A-HJ-NP-Za-km-z]{44}$/;
+/** Required DID length: exactly 56 characters. */
+export const DID_LENGTH = 56;
+// ─── Signature ──────────────────────────────────────────────────────────────
+/** Regex for validating a Technocore signature (base64url, 86 chars, canonical). */
+export const SIG_PATTERN = /^[A-Za-z0-9_-]{85}[AQgw]$/;
+/** Required signature length: exactly 86 characters. */
+export const SIG_LENGTH = 86;
+/** Valid terminal characters for a canonical 64-byte base64url signature. */
+export const SIG_TERMINAL_CHARS = new Set(['A', 'Q', 'g', 'w']);
+// ─── Nonce ──────────────────────────────────────────────────────────────────
+/** Regex for validating a nonce (1–19 digits). */
+export const NONCE_PATTERN = /^[0-9]{1,19}$/;
+/**
+ * Check if a room name has a specific class prefix.
+ */
+export function hasRoomClass(room, cls) {
+    return room.startsWith(cls);
+}
+/**
+ * Determine all class prefixes present on a room name.
+ */
+export function getRoomClasses(room) {
+    const classes = [];
+    // Classes compose by prefix: mb-p-xxx has both mb- and p- (via mb-p-)
+    if (room.startsWith('p-') || room.includes('-p-'))
+        classes.push('p-');
+    if (room.startsWith('mb-'))
+        classes.push('mb-');
+    if (room.startsWith('d-'))
+        classes.push('d-');
+    if (room.startsWith('e-') || room.includes('-e-'))
+        classes.push('e-');
+    return classes;
+}
+// ─── Protocol Constants ─────────────────────────────────────────────────────
+/** Maximum message length in characters. */
+export const MAX_MESSAGE_CHARS = 4096;
+/** Maximum note value length in characters. */
+export const MAX_NOTE_CHARS = 8192;
+/** Maximum long-poll wait in seconds. */
+export const MAX_WAIT_SECONDS = 10;
+/** Maximum limit for room read. */
+export const MAX_LIMIT = 200;
+/** Default limit for room read. */
+export const DEFAULT_LIMIT = 50;
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAUzD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAEpE,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,+EAA+E;AAE/E,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEvD,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEhE,+EAA+E;AAE/E,kDAAkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAqE7C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,GAAc;IACvD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,sEAAsE;IACtE,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC;AACjB,CAAC;AAoDD,+EAA+E;AAE/E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,yCAAyC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,mCAAmC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,mCAAmC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC"}

package/dist/verification/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Technocore SDK — Verification API
+ *
+ * Standalone, offline verification suite for Technocore cryptographic primitives.
+ * Does not require network access or identity registration.
+ */
+import { verifyMessage, rawVerify } from '../crypto/verify.js';
+import type { TechnocoreMessage, VerificationResult } from '../types/index.js';
+export { verifyMessage, rawVerify };
+/**
+ * Verify a single signed message payload from raw parts.
+ *
+ * @param room - Target room
+ * @param did - Signer DID (did:key:z6Mk...)
+ * @param nonce - Message nonce
+ * @param text - Stored message text (swept)
+ * @param sig - 86-character base64url signature
+ * @returns VerificationResult
+ */
+export declare function verifyMessageParts(room: string, did: string, nonce: string | number, text: string, sig: string): Promise<VerificationResult>;
+/**
+ * Verify a batch of messages concurrently.
+ *
+ * @param room - Target room
+ * @param messages - Array of messages to verify
+ * @returns Array of VerificationResult
+ */
+export declare function batchVerifyMessages(room: string, messages: readonly TechnocoreMessage[]): Promise<VerificationResult[]>;
+/**
+ * Verify a signed note write offline.
+ *
+ * @param namespace - Note namespace (e.g., "room-owners", "room-allow")
+ * @param key - Note key
+ * @param did - Signer DID
+ * @param nonce - Nonce string
+ * @param value - Note value
+ * @param sig - Base64url signature
+ */
+export declare function verifyNoteSignature(namespace: string, key: string, did: string, nonce: string, value: string, sig: string): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verification/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAK/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAEpC;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,CAAC,CAU7B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/dist/verification/index.js

@@ -0,0 +1,69 @@
+/**
+ * Technocore SDK — Verification API
+ *
+ * Standalone, offline verification suite for Technocore cryptographic primitives.
+ * Does not require network access or identity registration.
+ */
+import { verifyMessage, rawVerify } from '../crypto/verify.js';
+import { isValidDid, publicKeyFromDid } from '../crypto/did.js';
+import { canonicalNotePayload } from '../crypto/canonicalize.js';
+import { base64urlDecode } from '../crypto/encode.js';
+import { SIG_PATTERN, SIG_LENGTH } from '../types/index.js';
+export { verifyMessage, rawVerify };
+/**
+ * Verify a single signed message payload from raw parts.
+ *
+ * @param room - Target room
+ * @param did - Signer DID (did:key:z6Mk...)
+ * @param nonce - Message nonce
+ * @param text - Stored message text (swept)
+ * @param sig - 86-character base64url signature
+ * @returns VerificationResult
+ */
+export async function verifyMessageParts(room, did, nonce, text, sig) {
+    const fakeMessage = {
+        seq: 0,
+        ts: '',
+        from: did,
+        text,
+        nonce: typeof nonce === 'number' ? nonce : parseInt(nonce, 10),
+        sig,
+    };
+    return verifyMessage(room, fakeMessage);
+}
+/**
+ * Verify a batch of messages concurrently.
+ *
+ * @param room - Target room
+ * @param messages - Array of messages to verify
+ * @returns Array of VerificationResult
+ */
+export async function batchVerifyMessages(room, messages) {
+    return Promise.all(messages.map((m) => verifyMessage(room, m)));
+}
+/**
+ * Verify a signed note write offline.
+ *
+ * @param namespace - Note namespace (e.g., "room-owners", "room-allow")
+ * @param key - Note key
+ * @param did - Signer DID
+ * @param nonce - Nonce string
+ * @param value - Note value
+ * @param sig - Base64url signature
+ */
+export async function verifyNoteSignature(namespace, key, did, nonce, value, sig) {
+    if (!isValidDid(did))
+        return false;
+    if (!sig || sig.length !== SIG_LENGTH || !SIG_PATTERN.test(sig))
+        return false;
+    try {
+        const publicKey = publicKeyFromDid(did);
+        const sigBytes = base64urlDecode(sig);
+        const payload = canonicalNotePayload(namespace, key, nonce, value);
+        return rawVerify(sigBytes, payload, publicKey);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/verification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verification/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAA2B,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,GAAW,EACX,KAAsB,EACtB,IAAY,EACZ,GAAW;IAEX,MAAM,WAAW,GAAsB;QACrC,GAAG,EAAE,CAAC;QACN,EAAE,EAAE,EAAE;QACN,IAAI,EAAE,GAAG;QACT,IAAI;QACJ,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QAC9D,GAAG;KACJ,CAAC;IACF,OAAO,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,QAAsC;IAEtC,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,GAAW,EACX,GAAW,EACX,KAAa,EACb,KAAa,EACb,GAAW;IAEX,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "technocore-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for building reliable, verifiable agents and applications on the Technocore protocol.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:live": "cross-env TECHNOCORE_LIVE=1 vitest run --reporter=verbose",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "technocore",
+    "agent",
+    "sdk",
+    "did",
+    "ed25519",
+    "protocol",
+    "typescript"
+  ],
+  "author": "Exo-Tech",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Zeeyan05/technocore-sdk"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@noble/ed25519": "^2.2.3",
+    "@noble/hashes": "^1.7.2",
+    "@scure/base": "^1.2.4"
+  },
+  "devDependencies": {
+    "cross-env": "^10.1.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.3"
+  }
+}