@decentrl/sdk 0.0.6 → 0.0.8

package/dist/public-channel-reader.js

@@ -0,0 +1,169 @@
+import { multibaseDecode, verifyJsonSignature } from '@decentrl/crypto';
+import { resolveMediatorServiceEndpoint } from '@decentrl/identity/mediator/mediator.resolver';
+export class PublicChannelReader {
+    transport;
+    eventProcessor;
+    channelDefinitions;
+    subscriptions = new Map();
+    mediatorEndpointCache = new Map();
+    signingKeyCache = new Map();
+    constructor(transport, eventProcessor, channelDefinitions) {
+        this.transport = transport;
+        this.eventProcessor = eventProcessor;
+        this.channelDefinitions = channelDefinitions;
+    }
+    subscribe(config) {
+        const subId = crypto.randomUUID();
+        const pollIntervalMs = config.pollIntervalMs ?? 10_000;
+        let afterTimestamp = Math.floor(Date.now() / 1000);
+        const poll = async () => {
+            try {
+                const mediatorEndpoint = await this.resolveMediatorEndpoint(config.did);
+                if (!this.transport.fetchPublicEvents) {
+                    return;
+                }
+                const result = await this.transport.fetchPublicEvents({
+                    mediatorEndpoint,
+                    publisherDid: config.did,
+                    channelId: config.channelId,
+                    tags: config.tags,
+                    afterTimestamp,
+                });
+                for (const event of result.events) {
+                    const parsed = await this.parseAndVerifyPublicEvent(event, config.did);
+                    if (parsed) {
+                        this.eventProcessor.processChannelEvent(parsed);
+                    }
+                }
+                if (result.events.length > 0) {
+                    const maxTimestamp = Math.max(...result.events.map((e) => e.timestamp));
+                    afterTimestamp = maxTimestamp;
+                }
+            }
+            catch (err) {
+                console.warn('[Decentrl] Public channel poll failed:', err);
+            }
+        };
+        poll();
+        const intervalId = setInterval(poll, pollIntervalMs);
+        this.subscriptions.set(subId, { intervalId });
+        return {
+            unsubscribe: () => {
+                const sub = this.subscriptions.get(subId);
+                if (sub) {
+                    clearInterval(sub.intervalId);
+                    this.subscriptions.delete(subId);
+                }
+            },
+        };
+    }
+    async fetch(options) {
+        const mediatorEndpoint = options.mediatorEndpoint ?? (await this.resolveMediatorEndpoint(options.did));
+        if (!this.transport.fetchPublicEvents) {
+            return { data: [], pagination: { page: 0, pageSize: 20, total: 0 } };
+        }
+        const result = await this.transport.fetchPublicEvents({
+            mediatorEndpoint,
+            publisherDid: options.did,
+            channelId: options.channelId,
+            tags: options.tags,
+            afterTimestamp: options.afterTimestamp,
+            beforeTimestamp: options.beforeTimestamp,
+            page: options.pagination?.page,
+            pageSize: options.pagination?.pageSize,
+        });
+        return {
+            data: result.events,
+            pagination: result.pagination,
+        };
+    }
+    dispose() {
+        for (const sub of this.subscriptions.values()) {
+            clearInterval(sub.intervalId);
+        }
+        this.subscriptions.clear();
+    }
+    async parseAndVerifyPublicEvent(raw, publisherDid) {
+        try {
+            // Verify signature over { channel_id, event, tags, timestamp }
+            const signingKey = this.resolveSigningKeyFromDid(publisherDid);
+            if (signingKey) {
+                const signedData = {
+                    channel_id: raw.channelId,
+                    event: raw.event,
+                    tags: raw.tags,
+                    timestamp: raw.timestamp,
+                };
+                const isValid = verifyJsonSignature(signedData, raw.eventSignature, signingKey);
+                if (!isValid) {
+                    console.warn(`[Decentrl] Invalid signature on public event ${raw.id}, skipping`);
+                    return null;
+                }
+            }
+            const parsed = JSON.parse(raw.event);
+            const eventType = parsed.type;
+            if (!eventType || typeof eventType !== 'string') {
+                return null;
+            }
+            if (this.channelDefinitions &&
+                !this.eventProcessor.validateChannelEvent(eventType, parsed.data)) {
+                return null;
+            }
+            return {
+                type: eventType,
+                data: parsed.data,
+                meta: {
+                    publisherDid,
+                    timestamp: raw.timestamp,
+                    eventId: raw.id,
+                    channelId: raw.channelId,
+                },
+                tags: raw.tags,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    resolveSigningKeyFromDid(did) {
+        const cached = this.signingKeyCache.get(did);
+        if (cached) {
+            return cached;
+        }
+        // did:decentrl:alias:signingKey:encKey:mediatorHost
+        if (!did.startsWith('did:decentrl:')) {
+            return null;
+        }
+        const parts = did.replace('did:decentrl:', '').split(':');
+        if (parts.length < 2) {
+            return null;
+        }
+        try {
+            const key = multibaseDecode(parts[1]);
+            this.signingKeyCache.set(did, key);
+            return key;
+        }
+        catch {
+            return null;
+        }
+    }
+    async resolveMediatorEndpoint(did) {
+        const cached = this.mediatorEndpointCache.get(did);
+        if (cached) {
+            return cached;
+        }
+        const parts = did.replace('did:decentrl:', '').split(':');
+        if (parts.length >= 4) {
+            const mediatorDid = `did:web:${parts[3]}`;
+            const endpoint = await resolveMediatorServiceEndpoint(mediatorDid);
+            this.mediatorEndpointCache.set(did, endpoint);
+            return endpoint;
+        }
+        if (did.startsWith('did:web:')) {
+            const endpoint = await resolveMediatorServiceEndpoint(did);
+            this.mediatorEndpointCache.set(did, endpoint);
+            return endpoint;
+        }
+        throw new Error(`Cannot resolve mediator endpoint for DID: ${did}`);
+    }
+}

package/dist/transport.d.ts

@@ -36,6 +36,38 @@ export interface DecentrlTransport {
         page: number;
         pageSize: number;
     }): Promise<import('./types.js').PaginatedResult<EventEnvelope>>;
+    publishPublicEvent?(options: {
+        channelId: string;
+        event: string;
+        tags: string[];
+    }): Promise<{
+        publicEventId: string;
+    }>;
+    deletePublicEvent?(publicEventId: string, eventType?: string): Promise<void>;
+    fetchPublicEvents?(options: {
+        mediatorEndpoint: string;
+        publisherDid: string;
+        channelId?: string;
+        tags?: string[];
+        afterTimestamp?: number;
+        beforeTimestamp?: number;
+        page?: number;
+        pageSize?: number;
+    }): Promise<{
+        events: Array<{
+            id: string;
+            channelId: string;
+            event: string;
+            tags: string[];
+            timestamp: number;
+            eventSignature: string;
+        }>;
+        pagination: {
+            page: number;
+            pageSize: number;
+            total: number;
+        };
+    }>;
     dispose(): void;
 }
 //# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAEjC,cAAc,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7F,WAAW,IAAI,kBAAkB,GAAG,IAAI,CAAC;IACzC,YAAY,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAGpD,YAAY,CACX,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAClE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjD,8BAA8B,CAAC,CAC9B,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACnE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAG5B,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACzD,cAAc,CACb,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,2BAA2B,EAAE,MAAM,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACpD,kBAAkB,IAAI,oBAAoB,EAAE,CAAC;IAG7C,mBAAmB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvD,sBAAsB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzC,kBAAkB,CAAC,IAAI,OAAO,CAAC,OAAO,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAGxE,WAAW,CAAC,CACX,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,YAAY,GACzC,OAAO,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC;IAGhE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAGnE,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAGtD,eAAe,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGpF,sBAAsB,CAAC,CAAC,UAAU,CAAC,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC;IAEjE,OAAO,IAAI,IAAI,CAAC;CAChB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -9,13 +9,66 @@ export type EventDefinitions = Record<string, {
     schema: z.ZodType;
     tags: string[];
 }>;
-export interface StateSliceDefinition<TSlice = unknown, TEvents extends EventDefinitions = EventDefinitions> {
-    initial: TSlice;
-    reduce: {
-        [K in keyof TEvents]?: (state: TSlice, data: z.infer<TEvents[K]['schema']>, meta: EventMeta) => TSlice;
+export interface PublicEventDefinition<TSchema extends z.ZodType = z.ZodType> {
+    schema: TSchema;
+    tags: string[];
+    channelId: string;
+}
+export type PublicEventDefinitions = Record<string, {
+    schema: z.ZodType;
+    tags: string[];
+    channelId: string;
+}>;
+export interface ChannelDefinition<TSchema extends z.ZodType = z.ZodType> {
+    schema: TSchema;
+}
+export type ChannelDefinitions = Record<string, {
+    schema: z.ZodType;
+}>;
+export interface PublicEventMeta {
+    publisherDid: string;
+    timestamp: number;
+    eventId: string;
+    channelId: string;
+}
+export interface PublicEventEnvelope {
+    type: string;
+    data: unknown;
+    meta: PublicEventMeta;
+    tags?: string[];
+}
+export interface ChannelSubscriptionConfig {
+    did: string;
+    channelId: string;
+    tags?: string[];
+    pollIntervalMs?: number;
+}
+export interface ChannelFetchOptions {
+    did: string;
+    mediatorEndpoint?: string;
+    channelId?: string;
+    tags?: string[];
+    afterTimestamp?: number;
+    beforeTimestamp?: number;
+    pagination?: {
+        page: number;
+        pageSize: number;
     };
 }
-export type StateDefinitions<TEvents extends EventDefinitions = EventDefinitions> = Record<string, StateSliceDefinition<any, TEvents>>;
+type PrivateReducers<TSlice, TEvents extends EventDefinitions> = {
+    [K in string & keyof TEvents]?: (state: TSlice, data: z.infer<TEvents[K]['schema']>, meta: EventMeta) => TSlice;
+};
+type PublicReducers<TSlice, TPublicEvents extends PublicEventDefinitions> = {
+    [K in string & keyof TPublicEvents as `public:${K}`]?: (state: TSlice, data: z.infer<TPublicEvents[K]['schema']>, meta: PublicEventMeta) => TSlice;
+};
+type ChannelReducers<TSlice, TChannels extends ChannelDefinitions> = {
+    [K in string & keyof TChannels as `channel:${K}`]?: (state: TSlice, data: z.infer<TChannels[K]['schema']>, meta: PublicEventMeta) => TSlice;
+};
+export interface StateSliceDefinition<TSlice = unknown, TEvents extends EventDefinitions = EventDefinitions, TPublicEvents extends PublicEventDefinitions = PublicEventDefinitions, TChannels extends ChannelDefinitions = ChannelDefinitions> {
+    initial: TSlice;
+    reduce: PrivateReducers<TSlice, TEvents> & PublicReducers<TSlice, TPublicEvents> & ChannelReducers<TSlice, TChannels>;
+}
+export type StateDefinitions<TEvents extends EventDefinitions = EventDefinitions, TPublicEvents extends PublicEventDefinitions = PublicEventDefinitions, TChannels extends ChannelDefinitions = ChannelDefinitions> = Record<string, StateSliceDefinition<unknown, TEvents, TPublicEvents, TChannels>>;
 export type InferState<TState extends StateDefinitions> = {
     [K in keyof TState]: TState[K]['initial'];
 };
@@ -33,7 +86,7 @@ export interface EventEnvelope {
     _mediatorEventId?: string;
 }
 export interface DecentrlClientConfig {
-    mediatorDid: string;
+    mediatorDid?: string;
     /** Enable localStorage persistence. Pass a key prefix (e.g. "decentrl-myapp"). */
     persist?: {
         key: string;
@@ -41,9 +94,11 @@ export interface DecentrlClientConfig {
     /** Optional transport layer. Defaults to DirectTransport (direct HTTP to mediator). */
     transport?: import('./transport.js').DecentrlTransport;
 }
-export interface DecentrlAppConfig<TEvents extends EventDefinitions = EventDefinitions, TState extends StateDefinitions<TEvents> = StateDefinitions<TEvents>> {
+export interface DecentrlAppConfig<TEvents extends EventDefinitions = EventDefinitions, TPublicEvents extends PublicEventDefinitions = PublicEventDefinitions, TChannels extends ChannelDefinitions = ChannelDefinitions, TState extends StateDefinitions<TEvents, TPublicEvents, TChannels> = StateDefinitions<TEvents, TPublicEvents, TChannels>> {
     events: TEvents;
     state: TState;
+    publicEvents?: TPublicEvents;
+    channels?: TChannels;
 }
 export interface SerializedKeyPair {
     privateKey: string;
@@ -112,6 +167,28 @@ export interface PaginatedResult<T> {
     data: T[];
     pagination: PaginationMeta;
 }
+export interface PublicQueryOptions {
+    publisherDid: string;
+    mediatorEndpoint?: string;
+    channelId?: string;
+    tags?: string[];
+    /** Unix timestamp in seconds */
+    afterTimestamp?: number;
+    /** Unix timestamp in seconds */
+    beforeTimestamp?: number;
+    pagination?: {
+        page: number;
+        pageSize: number;
+    };
+}
+export interface PublicEventResult {
+    id: string;
+    channelId: string;
+    event: string;
+    tags: string[];
+    timestamp: number;
+    eventSignature: string;
+}
 export interface PublishOptions {
     recipient?: string;
     ephemeral?: boolean;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yEAAyE,CAAC;AAC3H,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACpC,MAAM,EACN;IACC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf,CACD,CAAC;AAIF,MAAM,WAAW,oBAAoB,CACpC,MAAM,GAAG,OAAO,EAChB,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAEnD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;SACN,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EACnC,IAAI,EAAE,SAAS,KACX,MAAM;KACX,CAAC;CACF;AAED,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,MAAM,CACzF,MAAM,EACN,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAClC,CAAC;AAIF,MAAM,MAAM,UAAU,CAAC,MAAM,SAAS,gBAAgB,IAAI;KACxD,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;CACzC,CAAC;AAIF,MAAM,WAAW,SAAS;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,gBAAgB,EAAE,iBAAiB,CAAC;CACvD;AAID,MAAM,WAAW,iBAAiB,CACjC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAEpE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE;QACL,OAAO,EAAE,iBAAiB,CAAC;QAC3B,UAAU,EAAE,iBAAiB,CAAC;QAC9B,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,gBAAgB,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACrD;AAID,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,gBAAgB,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACrD;AAID,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B,EAAE,2BAA2B,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2BAA2B,EAAE,MAAM,CAAC;CACpC;AAID,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,cAAc,CAAC;CAC3B;AAID,MAAM,WAAW,cAAc;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,WAAW,WAAW;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACF;AAID,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,MAAM,MAAM,aAAa,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentrl/sdk",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Declarative SDK for building Decentrl protocol applications",
   "type": "module",
   "main": "dist/index.js",
@@ -8,9 +8,9 @@
   "dependencies": {
     "zod": "^4.0.10",
     "axios": "1.11.0",
-    "@decentrl/crypto": "0.0.6",
-    "@decentrl/identity": "0.0.6",
-    "@decentrl/event-store": "0.0.6"
+    "@decentrl/crypto": "0.0.8",
+    "@decentrl/identity": "0.0.8",
+    "@decentrl/event-store": "0.0.8"
   },
   "devDependencies": {
     "typescript": "^5.8.3",

package/src/client.ts

@@ -10,10 +10,14 @@ import {
 	persistIdentity,
 	persistState,
 } from './persistence.js';
+import { PublicChannelReader } from './public-channel-reader.js';
 import { StateStore } from './state-store.js';
 import { SyncManager } from './sync-manager.js';
 import type { DecentrlTransport } from './transport.js';
 import type {
+	ChannelDefinitions,
+	ChannelFetchOptions,
+	ChannelSubscriptionConfig,
 	DecentrlAppConfig,
 	DecentrlClientConfig,
 	EventDefinitions,
@@ -21,6 +25,10 @@ import type {
 	EventMeta,
 	InferState,
 	PaginatedResult,
+	PublicEventDefinitions,
+	PublicEventEnvelope,
+	PublicEventResult,
+	PublicQueryOptions,
 	PublishOptions,
 	QueryOptions,
 	StateDefinitions,
@@ -31,12 +39,19 @@ import type { ConnectionStatus } from './websocket-transport.js';
 
 export class DecentrlClient<
 	TEvents extends EventDefinitions,
-	TState extends StateDefinitions<TEvents>,
+	TPublicEvents extends PublicEventDefinitions = PublicEventDefinitions,
+	TChannels extends ChannelDefinitions = ChannelDefinitions,
+	TState extends StateDefinitions<TEvents, TPublicEvents, TChannels> = StateDefinitions<
+		TEvents,
+		TPublicEvents,
+		TChannels
+	>,
 > {
 	private stateStore: StateStore<InferState<TState>>;
 	private eventProcessor: EventProcessor<TEvents, TState>;
 	private syncManager: SyncManager<TEvents, TState>;
 	private transport: DecentrlTransport;
+	private publicChannelReader: PublicChannelReader<TEvents, TState>;
 	private unsubscribePersistState: (() => void) | null = null;
 	private unsubscribePersistIdentity: (() => void) | null = null;
 
@@ -44,15 +59,14 @@ export class DecentrlClient<
 	readonly contracts: ContractManager;
 
 	constructor(
-		private appConfig: DecentrlAppConfig<TEvents, TState>,
+		private appConfig: DecentrlAppConfig<TEvents, TPublicEvents, TChannels, TState>,
 		private clientConfig: DecentrlClientConfig,
 	) {
 		// Build initial state from slice definitions
 		const initialState = {} as InferState<TState>;
 
 		for (const key of Object.keys(appConfig.state)) {
-			// TS can't statically index InferState<TState> during construction
-			(initialState as any)[key] = appConfig.state[key].initial;
+			(initialState as Record<string, unknown>)[key] = appConfig.state[key].initial;
 		}
 
 		// Restore persisted state if available
@@ -63,7 +77,6 @@ export class DecentrlClient<
 			const saved = loadPersistedState<InferState<TState>>(persistOpts);
 
 			if (saved) {
-				// Merge: use saved values for slices that exist, fall back to initial for new slices
 				restoredState = { ...initialState, ...saved };
 			}
 		}
@@ -88,7 +101,19 @@ export class DecentrlClient<
 			}
 		}
 
-		this.eventProcessor = new EventProcessor(appConfig.events, appConfig.state, this.stateStore);
+		this.eventProcessor = new EventProcessor(
+			appConfig.events,
+			appConfig.state,
+			this.stateStore,
+			appConfig.publicEvents,
+			appConfig.channels,
+		);
+
+		this.publicChannelReader = new PublicChannelReader(
+			this.transport,
+			this.eventProcessor,
+			appConfig.channels,
+		);
 
 		this.syncManager = new SyncManager(
 			this.eventProcessor,
@@ -105,7 +130,6 @@ export class DecentrlClient<
 				try {
 					this.identity.load(savedIdentity);
 				} catch {
-					// Corrupted identity data — clear it
 					persistIdentity(persistOpts, null);
 				}
 			}
@@ -121,7 +145,6 @@ export class DecentrlClient<
 			return;
 		}
 
-		// Auto-persist identity on changes
 		this.unsubscribePersistIdentity = this.identity.onChange((identity) => {
 			if (identity) {
 				persistIdentity(persistOpts, this.identity.serialize());
@@ -130,7 +153,6 @@ export class DecentrlClient<
 			}
 		});
 
-		// Auto-persist state on changes (debounced)
 		let persistTimeout: ReturnType<typeof setTimeout> | null = null;
 		this.unsubscribePersistState = this.stateStore.subscribe((state) => {
 			if (persistTimeout) {
@@ -141,6 +163,8 @@ export class DecentrlClient<
 		});
 	}
 
+	// --- Private Events ---
+
 	async publish<K extends string & keyof TEvents>(
 		eventType: K,
 		data: TEvents[K] extends { schema: infer S extends import('zod').ZodType }
@@ -148,10 +172,8 @@ export class DecentrlClient<
 			: never,
 		options?: PublishOptions,
 	): Promise<void> {
-		// 1. Validate data against schema
 		this.eventProcessor.validate(eventType, data);
 
-		// 2. Build envelope
 		const meta: EventMeta = {
 			senderDid: this.identity.requireIdentity().did,
 			timestamp: Date.now(),
@@ -159,19 +181,15 @@ export class DecentrlClient<
 			...(options?.ephemeral ? { ephemeral: true } : {}),
 		};
 		const envelope = this.eventProcessor.buildEnvelope(eventType, data, meta);
-
-		// 3. Compute tags
 		const tags = this.eventProcessor.computeTags(eventType, data);
 
 		try {
-			// 4. Publish via transport
 			await this.transport.publishEvent(envelope, {
 				tags,
 				recipient: options?.recipient,
 				ephemeral: options?.ephemeral,
 			});
 
-			// 5. Optimistic local state update
 			this.eventProcessor.processEvent(envelope);
 		} catch (error) {
 			throw new DecentrlSDKError(
@@ -213,6 +231,99 @@ export class DecentrlClient<
 		return { processed, total: result.pagination.total };
 	}
 
+	// --- Public Events (publishing) ---
+
+	async publishPublic<K extends string & keyof TPublicEvents>(
+		eventType: K,
+		data: TPublicEvents[K] extends { schema: infer S extends import('zod').ZodType }
+			? import('zod').infer<S>
+			: never,
+	): Promise<{ publicEventId: string }> {
+		this.eventProcessor.validatePublicEvent(eventType, data);
+
+		const identity = this.identity.requireIdentity();
+		const tags = this.eventProcessor.computePublicTags(eventType, data);
+		const channelId = this.eventProcessor.getPublicChannelId(eventType);
+		const eventPayload = JSON.stringify({ type: eventType, data });
+
+		if (!this.transport.publishPublicEvent) {
+			throw new DecentrlSDKError('Transport does not support publishPublicEvent', 'PUBLISH_FAILED');
+		}
+
+		try {
+			const result = await this.transport.publishPublicEvent({
+				channelId,
+				event: eventPayload,
+				tags,
+			});
+
+			this.eventProcessor.processPublicEvent({
+				type: eventType,
+				data,
+				meta: {
+					publisherDid: identity.did,
+					timestamp: Math.floor(Date.now() / 1000),
+					eventId: result.publicEventId,
+					channelId,
+				},
+				tags,
+			});
+
+			return result;
+		} catch (error) {
+			throw new DecentrlSDKError(
+				`Failed to publish public event "${eventType}": ${error instanceof Error ? error.message : String(error)}`,
+				'PUBLISH_FAILED',
+				{ eventType, data, error },
+			);
+		}
+	}
+
+	async deletePublicEvent(publicEventId: string, eventType?: string): Promise<void> {
+		if (!this.transport.deletePublicEvent) {
+			throw new DecentrlSDKError('Transport does not support deletePublicEvent', 'PUBLISH_FAILED');
+		}
+
+		await this.transport.deletePublicEvent(publicEventId, eventType);
+	}
+
+	// --- Public Events (reading) ---
+
+	async queryPublicEvents(
+		options: PublicQueryOptions,
+	): Promise<PaginatedResult<PublicEventResult>> {
+		// Auto-resolve mediator endpoint when querying own events
+		let mediatorEndpoint = options.mediatorEndpoint;
+
+		if (!mediatorEndpoint) {
+			const ownIdentity = this.identity.getIdentity();
+
+			if (ownIdentity && options.publisherDid === ownIdentity.did) {
+				mediatorEndpoint = ownIdentity.mediatorEndpoint;
+			}
+		}
+
+		return this.publicChannelReader.fetch({
+			did: options.publisherDid,
+			mediatorEndpoint,
+			channelId: options.channelId,
+			tags: options.tags,
+			afterTimestamp: options.afterTimestamp,
+			beforeTimestamp: options.beforeTimestamp,
+			pagination: options.pagination,
+		});
+	}
+
+	subscribeToChannel(config: ChannelSubscriptionConfig): { unsubscribe: () => void } {
+		return this.publicChannelReader.subscribe(config);
+	}
+
+	onPublicEvent(listener: (envelope: PublicEventEnvelope) => void): () => void {
+		return this.eventProcessor.onPublicEvent(listener);
+	}
+
+	// --- State ---
+
 	getState = (): InferState<TState> => {
 		return this.stateStore.getState();
 	};
@@ -221,6 +332,8 @@ export class DecentrlClient<
 		return this.stateStore.subscribe(listener);
 	};
 
+	// --- Sync ---
+
 	startSync(options?: SyncOptions): void {
 		this.syncManager.start(options);
 	}
@@ -241,8 +354,11 @@ export class DecentrlClient<
 		return this.syncManager.onConnectionStatusChange(listener);
 	};
 
+	// --- Reset ---
+
 	reset(): void {
 		this.syncManager.stop();
+		this.publicChannelReader.dispose();
 		this.identity.reset();
 		this.contracts.reset();
 		this.eventProcessor.reset();
@@ -257,21 +373,18 @@ export class DecentrlClient<
 			this.unsubscribePersistIdentity = null;
 		}
 
-		// Rebuild initial state
 		const initialState = {} as InferState<TState>;
 
 		for (const key of Object.keys(this.appConfig.state)) {
-			(initialState as any)[key] = this.appConfig.state[key].initial;
+			(initialState as Record<string, unknown>)[key] = this.appConfig.state[key].initial;
 		}
 
 		this.stateStore.reset(initialState);
 
-		// Clear persisted data
 		if (this.clientConfig.persist) {
 			clearPersisted(this.clientConfig.persist);
 		}
 
-		// Re-subscribe persistence listeners
 		this.setupPersistence();
 	}
 }