@decentrl/sdk 0.0.6 → 0.0.8

package/dist/client.d.ts

@@ -1,19 +1,20 @@
 import { ContractManager } from './contract-manager.js';
 import { IdentityManager } from './identity-manager.js';
-import type { DecentrlAppConfig, DecentrlClientConfig, EventDefinitions, EventEnvelope, InferState, PaginatedResult, PublishOptions, QueryOptions, StateDefinitions, StateListener, SyncOptions } from './types.js';
+import type { ChannelDefinitions, ChannelSubscriptionConfig, DecentrlAppConfig, DecentrlClientConfig, EventDefinitions, EventEnvelope, InferState, PaginatedResult, PublicEventDefinitions, PublicEventEnvelope, PublicEventResult, PublicQueryOptions, PublishOptions, QueryOptions, StateDefinitions, StateListener, SyncOptions } from './types.js';
 import type { ConnectionStatus } from './websocket-transport.js';
-export declare class DecentrlClient<TEvents extends EventDefinitions, TState extends StateDefinitions<TEvents>> {
+export declare class DecentrlClient<TEvents extends EventDefinitions, TPublicEvents extends PublicEventDefinitions = PublicEventDefinitions, TChannels extends ChannelDefinitions = ChannelDefinitions, TState extends StateDefinitions<TEvents, TPublicEvents, TChannels> = StateDefinitions<TEvents, TPublicEvents, TChannels>> {
     private appConfig;
     private clientConfig;
     private stateStore;
     private eventProcessor;
     private syncManager;
     private transport;
+    private publicChannelReader;
     private unsubscribePersistState;
     private unsubscribePersistIdentity;
     readonly identity: IdentityManager;
     readonly contracts: ContractManager;
-    constructor(appConfig: DecentrlAppConfig<TEvents, TState>, clientConfig: DecentrlClientConfig);
+    constructor(appConfig: DecentrlAppConfig<TEvents, TPublicEvents, TChannels, TState>, clientConfig: DecentrlClientConfig);
     private setupPersistence;
     publish<K extends string & keyof TEvents>(eventType: K, data: TEvents[K] extends {
         schema: infer S extends import('zod').ZodType;
@@ -24,6 +25,17 @@ export declare class DecentrlClient<TEvents extends EventDefinitions, TState ext
         processed: number;
         total: number;
     }>;
+    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;
+    }>;
+    deletePublicEvent(publicEventId: string, eventType?: string): Promise<void>;
+    queryPublicEvents(options: PublicQueryOptions): Promise<PaginatedResult<PublicEventResult>>;
+    subscribeToChannel(config: ChannelSubscriptionConfig): {
+        unsubscribe: () => void;
+    };
+    onPublicEvent(listener: (envelope: PublicEventEnvelope) => void): () => void;
     getState: () => InferState<TState>;
     subscribe: (listener: StateListener<InferState<TState>>) => (() => void);
     startSync(options?: SyncOptions): void;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAWxD,OAAO,KAAK,EACX,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EAEb,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,qBAAa,cAAc,CAC1B,OAAO,SAAS,gBAAgB,EAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC;IAavC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;IAZrB,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,0BAA0B,CAA6B;IAE/D,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;gBAG3B,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,EAC7C,YAAY,EAAE,oBAAoB;IAqE3C,OAAO,CAAC,gBAAgB;IA2BlB,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,OAAO,EAC7C,SAAS,EAAE,CAAC,EACZ,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC,SAAS,OAAO,KAAK,EAAE,OAAO,CAAA;KAAE,GACvE,OAAO,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GACtB,KAAK,EACR,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;IAmCV,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAoB5E,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1D,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO5F,QAAQ,QAAO,UAAU,CAAC,MAAM,CAAC,CAE/B;IAEF,SAAS,GAAI,UAAU,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAG,CAAC,MAAM,IAAI,CAAC,CAErE;IAEF,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAItC,QAAQ,IAAI,IAAI;IAIV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,mBAAmB,QAAO,gBAAgB,CAExC;IAEF,wBAAwB,GAAI,UAAU,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAErF;IAEF,KAAK,IAAI,IAAI;CAiCb"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -4,6 +4,7 @@ import { DecentrlSDKError } from './errors.js';
 import { EventProcessor } from './event-processor.js';
 import { IdentityManager } from './identity-manager.js';
 import { clearPersisted, loadPersistedIdentity, loadPersistedState, persistIdentity, persistState, } from './persistence.js';
+import { PublicChannelReader } from './public-channel-reader.js';
 import { StateStore } from './state-store.js';
 import { SyncManager } from './sync-manager.js';
 export class DecentrlClient {
@@ -13,6 +14,7 @@ export class DecentrlClient {
     eventProcessor;
     syncManager;
     transport;
+    publicChannelReader;
     unsubscribePersistState = null;
     unsubscribePersistIdentity = null;
     identity;
@@ -23,7 +25,6 @@ export class DecentrlClient {
         // Build initial state from slice definitions
         const initialState = {};
         for (const key of Object.keys(appConfig.state)) {
-            // TS can't statically index InferState<TState> during construction
             initialState[key] = appConfig.state[key].initial;
         }
         // Restore persisted state if available
@@ -32,7 +33,6 @@ export class DecentrlClient {
         if (persistOpts) {
             const saved = loadPersistedState(persistOpts);
             if (saved) {
-                // Merge: use saved values for slices that exist, fall back to initial for new slices
                 restoredState = { ...initialState, ...saved };
             }
         }
@@ -53,7 +53,8 @@ export class DecentrlClient {
                 console.debug('[Decentrl] Failed to seed identity from transport:', err);
             }
         }
-        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, this.contracts, this.identity, this.transport);
         // Restore persisted identity
         if (persistOpts) {
@@ -63,7 +64,6 @@ export class DecentrlClient {
                     this.identity.load(savedIdentity);
                 }
                 catch {
-                    // Corrupted identity data — clear it
                     persistIdentity(persistOpts, null);
                 }
             }
@@ -75,7 +75,6 @@ export class DecentrlClient {
         if (!persistOpts) {
             return;
         }
-        // Auto-persist identity on changes
         this.unsubscribePersistIdentity = this.identity.onChange((identity) => {
             if (identity) {
                 persistIdentity(persistOpts, this.identity.serialize());
@@ -84,7 +83,6 @@ export class DecentrlClient {
                 persistIdentity(persistOpts, null);
             }
         });
-        // Auto-persist state on changes (debounced)
         let persistTimeout = null;
         this.unsubscribePersistState = this.stateStore.subscribe((state) => {
             if (persistTimeout) {
@@ -93,10 +91,9 @@ export class DecentrlClient {
             persistTimeout = setTimeout(() => persistState(persistOpts, state), 100);
         });
     }
+    // --- Private Events ---
     async publish(eventType, data, options) {
-        // 1. Validate data against schema
         this.eventProcessor.validate(eventType, data);
-        // 2. Build envelope
         const meta = {
             senderDid: this.identity.requireIdentity().did,
             timestamp: Date.now(),
@@ -104,16 +101,13 @@ 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) {
@@ -142,12 +136,79 @@ export class DecentrlClient {
         const processed = this.eventProcessor.processBatch(result.data);
         return { processed, total: result.pagination.total };
     }
+    // --- Public Events (publishing) ---
+    async publishPublic(eventType, data) {
+        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, eventType) {
+        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) {
+        // 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) {
+        return this.publicChannelReader.subscribe(config);
+    }
+    onPublicEvent(listener) {
+        return this.eventProcessor.onPublicEvent(listener);
+    }
+    // --- State ---
     getState = () => {
         return this.stateStore.getState();
     };
     subscribe = (listener) => {
         return this.stateStore.subscribe(listener);
     };
+    // --- Sync ---
     startSync(options) {
         this.syncManager.start(options);
     }
@@ -163,8 +224,10 @@ export class DecentrlClient {
     onConnectionStatusChange = (listener) => {
         return this.syncManager.onConnectionStatusChange(listener);
     };
+    // --- Reset ---
     reset() {
         this.syncManager.stop();
+        this.publicChannelReader.dispose();
         this.identity.reset();
         this.contracts.reset();
         this.eventProcessor.reset();
@@ -176,17 +239,14 @@ export class DecentrlClient {
             this.unsubscribePersistIdentity();
             this.unsubscribePersistIdentity = null;
         }
-        // Rebuild initial state
         const initialState = {};
         for (const key of Object.keys(this.appConfig.state)) {
             initialState[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();
     }
 }

package/dist/define-app.d.ts

@@ -1,8 +1,8 @@
 import { DecentrlClient } from './client.js';
-import type { DecentrlAppConfig, DecentrlClientConfig, EventDefinitions, StateDefinitions } from './types.js';
-export interface DecentrlApp<TEvents extends EventDefinitions, TState extends StateDefinitions<TEvents>> {
-    config: DecentrlAppConfig<TEvents, TState>;
-    createClient(clientConfig: DecentrlClientConfig): DecentrlClient<TEvents, TState>;
+import type { ChannelDefinitions, DecentrlAppConfig, DecentrlClientConfig, EventDefinitions, PublicEventDefinitions, StateDefinitions } from './types.js';
+export interface DecentrlApp<TEvents extends EventDefinitions, TPublicEvents extends PublicEventDefinitions, TChannels extends ChannelDefinitions, TState extends StateDefinitions<TEvents, TPublicEvents, TChannels>> {
+    config: DecentrlAppConfig<TEvents, TPublicEvents, TChannels, TState>;
+    createClient(clientConfig: DecentrlClientConfig): DecentrlClient<TEvents, TPublicEvents, TChannels, TState>;
 }
-export declare function defineDecentrlApp<TEvents extends EventDefinitions, TState extends StateDefinitions<TEvents>>(config: DecentrlAppConfig<TEvents, TState>): DecentrlApp<TEvents, TState>;
+export declare function defineDecentrlApp<TEvents extends EventDefinitions, TPublicEvents extends PublicEventDefinitions = PublicEventDefinitions, TChannels extends ChannelDefinitions = ChannelDefinitions, TState extends StateDefinitions<TEvents, TPublicEvents, TChannels> = StateDefinitions<TEvents, TPublicEvents, TChannels>>(config: DecentrlAppConfig<TEvents, TPublicEvents, TChannels, TState>): DecentrlApp<TEvents, TPublicEvents, TChannels, TState>;
 //# sourceMappingURL=define-app.d.ts.map

package/dist/define-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-app.d.ts","sourceRoot":"","sources":["../src/define-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACX,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW,CAC3B,OAAO,SAAS,gBAAgB,EAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC;IAExC,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,YAAY,CAAC,YAAY,EAAE,oBAAoB,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAClF;AAED,wBAAgB,iBAAiB,CAChC,OAAO,SAAS,gBAAgB,EAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC,EACvC,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAK1E"}
+{"version":3,"file":"define-app.d.ts","sourceRoot":"","sources":["../src/define-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACX,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW,CAC3B,OAAO,SAAS,gBAAgB,EAChC,aAAa,SAAS,sBAAsB,EAC5C,SAAS,SAAS,kBAAkB,EACpC,MAAM,SAAS,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC;IAElE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACrE,YAAY,CACX,YAAY,EAAE,oBAAoB,GAChC,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;CAC7D;AAED,wBAAgB,iBAAiB,CAChC,OAAO,SAAS,gBAAgB,EAChC,aAAa,SAAS,sBAAsB,GAAG,sBAAsB,EACrE,SAAS,SAAS,kBAAkB,GAAG,kBAAkB,EACzD,MAAM,SAAS,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,GAAG,gBAAgB,CACpF,OAAO,EACP,aAAa,EACb,SAAS,CACT,EAED,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,GAClE,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAKxD"}

package/dist/direct-transport.d.ts

@@ -61,6 +61,38 @@ export declare class DirectTransport implements DecentrlTransport {
     private autoAcceptRenewals;
     processContractCleanup(): Promise<void>;
     getContractHistory(): Promise<ArchivedContract[]>;
+    publishPublicEvent(options: {
+        channelId: string;
+        event: string;
+        tags: string[];
+    }): Promise<{
+        publicEventId: string;
+    }>;
+    deletePublicEvent(publicEventId: 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;
     private notifyEphemeralKeysChanged;
     private requireIdentity;

package/dist/direct-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct-transport.d.ts","sourceRoot":"","sources":["../src/direct-transport.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACX,gBAAgB,EAChB,aAAa,EAEb,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,OAAO,EAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1B,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAM1B,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAED,qBAAa,eAAgB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,sBAAsB,CAAC,CAAyD;IAExF,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,qBAAqB,CAAqB;IAGlD,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,OAAO,CAAC,EAAE,sBAAsB;IAUtC,cAAc,CAAC,OAAO,EAAE;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoD/B,WAAW,IAAI,kBAAkB,GAAG,IAAI;IAIxC,YAAY,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAYlD,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAYtD,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIrD,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMpC,YAAY,CACjB,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;IASV,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAMhD,8BAA8B,CACnC,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;IAMrB,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAM5E,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlF,sBAAsB,CAAC,UAAU,CAAC,EAAE;QACzC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAQrC,eAAe,CACpB,YAAY,EAAE,MAAM,EACpB,SAAS,SAAoC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAyCV,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAgCxD,cAAc,CACnB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,2BAA2B,EAAE,MAAM,GACjC,OAAO,CAAC,IAAI,CAAC;IAuEV,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAoGzD,kBAAkB,IAAI,oBAAoB,EAAE;IAItC,mBAAmB,CAAC,SAAS,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAK3C,gBAAgB;YAmChB,kBAAkB;IAyD1B,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuFvC,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqBvD,OAAO,IAAI,IAAI;YAMD,0BAA0B;IAIxC,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,iBAAiB;CAoBzB"}
+{"version":3,"file":"direct-transport.d.ts","sourceRoot":"","sources":["../src/direct-transport.ts"],"names":[],"mappings":"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"}

package/dist/direct-transport.js

@@ -416,6 +416,32 @@ export class DirectTransport {
         })
             .map((e) => e.data);
     }
+    async publishPublicEvent(options) {
+        const eventStore = this.requireEventStore();
+        return eventStore.publishPublicEvent(options.event, {
+            channelId: options.channelId,
+            tags: options.tags,
+        });
+    }
+    async deletePublicEvent(publicEventId) {
+        const eventStore = this.requireEventStore();
+        await eventStore.deletePublicEvent(publicEventId);
+    }
+    async fetchPublicEvents(options) {
+        const result = await DecentrlEventStore.fetchPublicEvents({
+            mediatorEndpoint: options.mediatorEndpoint,
+            publisherDid: options.publisherDid,
+            channelId: options.channelId,
+            tags: options.tags,
+            afterTimestamp: options.afterTimestamp,
+            beforeTimestamp: options.beforeTimestamp,
+            pagination: options.page != null ? { page: options.page, pageSize: options.pageSize ?? 20 } : undefined,
+        });
+        return {
+            events: result.data,
+            pagination: result.pagination,
+        };
+    }
     dispose() {
         this.eventStore = null;
     }

package/dist/event-processor.d.ts

@@ -1,18 +1,28 @@
 import type { StateStore } from './state-store.js';
-import type { EventDefinitions, EventEnvelope, EventMeta, InferState, StateDefinitions } from './types.js';
+import type { ChannelDefinitions, EventDefinitions, EventEnvelope, EventMeta, InferState, PublicEventDefinitions, PublicEventEnvelope, StateDefinitions } from './types.js';
 export declare class EventProcessor<TEvents extends EventDefinitions, TState extends StateDefinitions<TEvents>> {
     private eventDefinitions;
     private stateDefinitions;
     private stateStore;
+    private publicEventDefinitions?;
+    private channelDefinitions?;
     private processedEventIds;
     private eventListeners;
-    constructor(eventDefinitions: TEvents, stateDefinitions: TState, stateStore: StateStore<InferState<TState>>);
+    private publicEventListeners;
+    constructor(eventDefinitions: TEvents, stateDefinitions: TState, stateStore: StateStore<InferState<TState>>, publicEventDefinitions?: PublicEventDefinitions | undefined, channelDefinitions?: ChannelDefinitions | undefined);
     onEvent(listener: (envelope: EventEnvelope) => void): () => void;
+    onPublicEvent(listener: (envelope: PublicEventEnvelope) => void): () => void;
     validate(eventType: string, data: unknown): void;
+    validatePublicEvent(eventType: string, data: unknown): void;
     computeTags(eventType: string, data: unknown): string[];
+    computePublicTags(eventType: string, data: unknown): string[];
+    getPublicChannelId(eventType: string): string;
     computeTagsSafe(eventType: string, data: unknown): string[];
     buildEnvelope(eventType: string, data: unknown, meta: EventMeta): EventEnvelope;
     processEvent(envelope: EventEnvelope): boolean;
+    processPublicEvent(envelope: PublicEventEnvelope): boolean;
+    processChannelEvent(envelope: PublicEventEnvelope): boolean;
+    validateChannelEvent(eventType: string, data: unknown): boolean;
     processBatch(envelopes: EventEnvelope[]): number;
     reset(): void;
 }

package/dist/event-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-processor.d.ts","sourceRoot":"","sources":["../src/event-processor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EACX,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAc,CAC1B,OAAO,SAAS,gBAAgB,EAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC;IAMvC,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,UAAU;IANnB,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAgD;gBAG7D,gBAAgB,EAAE,OAAO,EACzB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAGnD,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAMhE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAoBhD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAYvD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAQ3D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,aAAa;IAI/E,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO;IAwC9C,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM;IAYhD,KAAK,IAAI,IAAI;CAIb"}
+{"version":3,"file":"event-processor.d.ts","sourceRoot":"","sources":["../src/event-processor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EACX,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EAEnB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AASpB,qBAAa,cAAc,CAC1B,OAAO,SAAS,gBAAgB,EAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC;IAOvC,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,sBAAsB,CAAC;IAC/B,OAAO,CAAC,kBAAkB,CAAC;IAT5B,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAgD;IACtE,OAAO,CAAC,oBAAoB,CAAsD;gBAGzE,gBAAgB,EAAE,OAAO,EACzB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAC1C,sBAAsB,CAAC,EAAE,sBAAsB,YAAA,EAC/C,kBAAkB,CAAC,EAAE,kBAAkB,YAAA;IAGhD,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAMhE,aAAa,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IAM5E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAoBhD,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAoB3D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAYvD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAY7D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAY7C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAQ3D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,aAAa;IAI/E,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO;IAoC9C,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAmC1D,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAmC3D,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAU/D,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM;IAYhD,KAAK,IAAI,IAAI;CAKb"}

package/dist/event-processor.js

@@ -5,17 +5,26 @@ export class EventProcessor {
     eventDefinitions;
     stateDefinitions;
     stateStore;
+    publicEventDefinitions;
+    channelDefinitions;
     processedEventIds = new Set();
     eventListeners = new Set();
-    constructor(eventDefinitions, stateDefinitions, stateStore) {
+    publicEventListeners = new Set();
+    constructor(eventDefinitions, stateDefinitions, stateStore, publicEventDefinitions, channelDefinitions) {
         this.eventDefinitions = eventDefinitions;
         this.stateDefinitions = stateDefinitions;
         this.stateStore = stateStore;
+        this.publicEventDefinitions = publicEventDefinitions;
+        this.channelDefinitions = channelDefinitions;
     }
     onEvent(listener) {
         this.eventListeners.add(listener);
         return () => this.eventListeners.delete(listener);
     }
+    onPublicEvent(listener) {
+        this.publicEventListeners.add(listener);
+        return () => this.publicEventListeners.delete(listener);
+    }
     validate(eventType, data) {
         const definition = this.eventDefinitions[eventType];
         if (!definition) {
@@ -28,6 +37,18 @@ export class EventProcessor {
             throw new DecentrlSDKError(`Schema validation failed for event type "${eventType}": ${result.error.message}`, 'SCHEMA_VALIDATION_FAILED', { eventType, errors: result.error.issues });
         }
     }
+    validatePublicEvent(eventType, data) {
+        const definition = this.publicEventDefinitions?.[eventType];
+        if (!definition) {
+            throw new DecentrlSDKError(`Unknown public event type: ${eventType}`, 'UNKNOWN_EVENT_TYPE', {
+                eventType,
+            });
+        }
+        const result = definition.schema.safeParse(data);
+        if (!result.success) {
+            throw new DecentrlSDKError(`Schema validation failed for public event type "${eventType}": ${result.error.message}`, 'SCHEMA_VALIDATION_FAILED', { eventType, errors: result.error.issues });
+        }
+    }
     computeTags(eventType, data) {
         const definition = this.eventDefinitions[eventType];
         if (!definition) {
@@ -37,6 +58,24 @@ export class EventProcessor {
         }
         return evaluateTagTemplates(definition.tags, data);
     }
+    computePublicTags(eventType, data) {
+        const definition = this.publicEventDefinitions?.[eventType];
+        if (!definition) {
+            throw new DecentrlSDKError(`Unknown public event type: ${eventType}`, 'UNKNOWN_EVENT_TYPE', {
+                eventType,
+            });
+        }
+        return evaluateTagTemplates(definition.tags, data);
+    }
+    getPublicChannelId(eventType) {
+        const definition = this.publicEventDefinitions?.[eventType];
+        if (!definition) {
+            throw new DecentrlSDKError(`Unknown public event type: ${eventType}`, 'UNKNOWN_EVENT_TYPE', {
+                eventType,
+            });
+        }
+        return definition.channelId;
+    }
     computeTagsSafe(eventType, data) {
         try {
             return this.computeTags(eventType, data);
@@ -55,7 +94,6 @@ export class EventProcessor {
                 return false;
             }
             if (this.processedEventIds.size >= MAX_DEDUP_SIZE) {
-                // Set iterates in insertion order — first value is the oldest
                 const oldest = this.processedEventIds.values().next().value;
                 this.processedEventIds.delete(oldest);
             }
@@ -64,7 +102,6 @@ export class EventProcessor {
         const currentState = this.stateStore.getState();
         for (const sliceKey of Object.keys(this.stateDefinitions)) {
             const sliceDef = this.stateDefinitions[sliceKey];
-            // Dynamic reducer lookup — TS can't prove type safety for runtime event type dispatch
             const reducer = sliceDef.reduce[envelope.type];
             if (reducer) {
                 const currentSlice = currentState[sliceKey];
@@ -77,6 +114,65 @@ export class EventProcessor {
         }
         return true;
     }
+    processPublicEvent(envelope) {
+        const dedupKey = `public:${envelope.meta.eventId}`;
+        if (this.processedEventIds.has(dedupKey)) {
+            return false;
+        }
+        if (this.processedEventIds.size >= MAX_DEDUP_SIZE) {
+            const oldest = this.processedEventIds.values().next().value;
+            this.processedEventIds.delete(oldest);
+        }
+        this.processedEventIds.add(dedupKey);
+        const reducerKey = `public:${envelope.type}`;
+        const currentState = this.stateStore.getState();
+        for (const sliceKey of Object.keys(this.stateDefinitions)) {
+            const sliceDef = this.stateDefinitions[sliceKey];
+            const reducer = sliceDef.reduce[reducerKey];
+            if (reducer) {
+                const currentSlice = currentState[sliceKey];
+                const newSlice = reducer(currentSlice, envelope.data, envelope.meta);
+                this.stateStore.setSlice(sliceKey, newSlice);
+            }
+        }
+        for (const listener of this.publicEventListeners) {
+            listener(envelope);
+        }
+        return true;
+    }
+    processChannelEvent(envelope) {
+        const dedupKey = `channel:${envelope.meta.eventId}`;
+        if (this.processedEventIds.has(dedupKey)) {
+            return false;
+        }
+        if (this.processedEventIds.size >= MAX_DEDUP_SIZE) {
+            const oldest = this.processedEventIds.values().next().value;
+            this.processedEventIds.delete(oldest);
+        }
+        this.processedEventIds.add(dedupKey);
+        const reducerKey = `channel:${envelope.type}`;
+        const currentState = this.stateStore.getState();
+        for (const sliceKey of Object.keys(this.stateDefinitions)) {
+            const sliceDef = this.stateDefinitions[sliceKey];
+            const reducer = sliceDef.reduce[reducerKey];
+            if (reducer) {
+                const currentSlice = currentState[sliceKey];
+                const newSlice = reducer(currentSlice, envelope.data, envelope.meta);
+                this.stateStore.setSlice(sliceKey, newSlice);
+            }
+        }
+        for (const listener of this.publicEventListeners) {
+            listener(envelope);
+        }
+        return true;
+    }
+    validateChannelEvent(eventType, data) {
+        const definition = this.channelDefinitions?.[eventType];
+        if (!definition) {
+            return false;
+        }
+        return definition.schema.safeParse(data).success;
+    }
     processBatch(envelopes) {
         let newCount = 0;
         for (const envelope of envelopes) {
@@ -89,5 +185,6 @@ export class EventProcessor {
     reset() {
         this.processedEventIds.clear();
         this.eventListeners.clear();
+        this.publicEventListeners.clear();
     }
 }

package/dist/index.d.ts

@@ -9,10 +9,11 @@ export { DecentrlSDKError } from './errors.js';
 export { EventProcessor } from './event-processor.js';
 export { IdentityManager } from './identity-manager.js';
 export type { PersistOptions } from './persistence.js';
+export { PublicChannelReader } from './public-channel-reader.js';
 export { StateStore } from './state-store.js';
 export { SyncManager } from './sync-manager.js';
 export type { DecentrlTransport } from './transport.js';
-export type { ArchivedContract, DecentrlAppConfig, DecentrlClientConfig, EventDefinition, EventDefinitions, EventEnvelope, EventMeta, IdentityState, InferState, PaginatedResult, PaginationMeta, PendingContractRequest, PublishOptions, QueryOptions, SerializedIdentity, SerializedKeyPair, StateDefinitions, StateListener, StateSliceDefinition, StoredSignedContract, SyncOptions, } from './types.js';
+export type { ArchivedContract, ChannelDefinition, ChannelDefinitions, ChannelFetchOptions, ChannelSubscriptionConfig, DecentrlAppConfig, DecentrlClientConfig, EventDefinition, EventDefinitions, EventEnvelope, EventMeta, IdentityState, InferState, PaginatedResult, PaginationMeta, PendingContractRequest, PublicEventDefinition, PublicEventDefinitions, PublicEventEnvelope, PublicEventMeta, PublicEventResult, PublicQueryOptions, PublishOptions, QueryOptions, SerializedIdentity, SerializedKeyPair, StateDefinitions, StateListener, StateSliceDefinition, StoredSignedContract, SyncOptions, } from './types.js';
 export type { ConnectionStatus, WebSocketTransportCallbacks, WebSocketTransportIdentity, } from './websocket-transport.js';
 export { deriveWsUrl, WebSocketTransport } from './websocket-transport.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EACX,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export { DirectTransport } from './direct-transport.js';
 export { DecentrlSDKError } from './errors.js';
 export { EventProcessor } from './event-processor.js';
 export { IdentityManager } from './identity-manager.js';
+export { PublicChannelReader } from './public-channel-reader.js';
 export { StateStore } from './state-store.js';
 export { SyncManager } from './sync-manager.js';
 export { deriveWsUrl, WebSocketTransport } from './websocket-transport.js';

package/dist/public-channel-reader.d.ts

@@ -0,0 +1,21 @@
+import type { EventProcessor } from './event-processor.js';
+import type { DecentrlTransport } from './transport.js';
+import type { ChannelDefinitions, ChannelFetchOptions, ChannelSubscriptionConfig, EventDefinitions, PaginatedResult, PublicEventResult, StateDefinitions } from './types.js';
+export declare class PublicChannelReader<TEvents extends EventDefinitions, TState extends StateDefinitions<TEvents>> {
+    private transport;
+    private eventProcessor;
+    private channelDefinitions?;
+    private subscriptions;
+    private mediatorEndpointCache;
+    private signingKeyCache;
+    constructor(transport: DecentrlTransport, eventProcessor: EventProcessor<TEvents, TState>, channelDefinitions?: ChannelDefinitions | undefined);
+    subscribe(config: ChannelSubscriptionConfig): {
+        unsubscribe: () => void;
+    };
+    fetch(options: ChannelFetchOptions): Promise<PaginatedResult<PublicEventResult>>;
+    dispose(): void;
+    private parseAndVerifyPublicEvent;
+    private resolveSigningKeyFromDid;
+    private resolveMediatorEndpoint;
+}
+//# sourceMappingURL=public-channel-reader.d.ts.map

package/dist/public-channel-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-channel-reader.d.ts","sourceRoot":"","sources":["../src/public-channel-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACX,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EAEf,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAMpB,qBAAa,mBAAmB,CAC/B,OAAO,SAAS,gBAAgB,EAChC,MAAM,SAAS,gBAAgB,CAAC,OAAO,CAAC;IAOvC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,kBAAkB,CAAC;IAP5B,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,eAAe,CAAiC;gBAG/C,SAAS,EAAE,iBAAiB,EAC5B,cAAc,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,EAC/C,kBAAkB,CAAC,EAAE,kBAAkB,YAAA;IAGhD,SAAS,CAAC,MAAM,EAAE,yBAAyB,GAAG;QAAE,WAAW,EAAE,MAAM,IAAI,CAAA;KAAE;IAwDnE,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAyBtF,OAAO,IAAI,IAAI;YAQD,yBAAyB;IA8DvC,OAAO,CAAC,wBAAwB;YA4BlB,uBAAuB;CA0BrC"}