@pluv/io 0.5.0 → 0.6.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/io@0.5.0 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.6.0 build /home/runner/work/pluv/pluv/packages/io
 > tsup src/index.ts --format esm,cjs --dts
 
 CLI Building entry: src/index.ts
@@ -8,10 +8,10 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-CJS dist/index.js 30.95 KB
-CJS ⚡️ Build success in 112ms
-ESM dist/index.mjs 28.88 KB
-ESM ⚡️ Build success in 129ms
+ESM dist/index.mjs 28.98 KB
+ESM ⚡️ Build success in 93ms
+CJS dist/index.js 31.04 KB
+CJS ⚡️ Build success in 93ms
 DTS Build start
-DTS ⚡️ Build success in 3722ms
-DTS dist/index.d.ts 16.78 KB
+DTS ⚡️ Build success in 3311ms
+DTS dist/index.d.ts 17.03 KB

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @pluv/io
 
+## 0.6.0
+
+### Minor Changes
+
+- 2e7cbfa: Updated createIO config option `initialStorage` to be renamed to `getInitialStorage` and updated the params to use an object that includes platform parameters.
+
+  Previously:
+
+  ```ts
+  createIO({
+      initialStorage(room: string): Promise<string> => {
+          // ...
+      },
+  });
+  ```
+
+  Now:
+
+  ```ts
+  createIO({
+      platform: platformCloudflare<Env>(),
+      getInitialStorage({
+          // If you're using Cloudflare, this is the Cloudflare env parameter
+          env,
+          // The name of the room
+          room,
+      }): Promise<string> => {
+          // ...
+      },
+  });
+  ```
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -238,6 +238,10 @@ interface AuthorizeModule {
 type InferIOContext<TIO extends PluvIO<any, any, any, any, any, any, any>> = TIO extends PluvIO<any, any, infer IContext, any, any, any, any> ? IContext : never;
 type InferIOPlatform<TIO extends PluvIO<any, any, any, any, any, any, any>> = TIO extends PluvIO<infer IPlatform, any, any, any, any, any, any> ? IPlatform : never;
 type InferIORoom<TIO extends PluvIO<any, any, any, any, any, any, any>> = TIO extends PluvIO<infer IPlatform, infer IAuthorize, infer IContext, infer IInput, infer IOutputBroadcast, infer IOutputSelf, infer IOutputSync> ? IORoom<IPlatform, IAuthorize, IContext, IInput, IOutputBroadcast, IOutputSelf, IOutputSync> : never;
+type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
+    room: string;
+} & InferPlatformRoomContextType<TPlatform>;
+type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitialStorageEvent<TPlatform>) => MaybePromise<Maybe<string>>;
 interface PluvIOListeners<TPlatform extends AbstractPlatform> {
     onRoomDeleted: (event: IORoomListenerEvent<TPlatform>) => void;
     onStorageUpdated: (event: IORoomListenerEvent<TPlatform>) => void;
@@ -247,7 +251,7 @@ type PluvIOConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any
     context?: TContext;
     debug?: boolean;
     events?: InferEventConfig<TPlatform, TContext, TInput, TOutputBroadcast, TOutputSelf, TOutputSync>;
-    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
+    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
 type GetRoomOptions<TPlatform extends AbstractPlatform> = {
@@ -255,7 +259,7 @@ type GetRoomOptions<TPlatform extends AbstractPlatform> = {
 } & InferPlatformRoomContextType<TPlatform>;
 declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any> = BaseIOAuthorize, TContext extends JsonObject = {}, TInput extends EventRecord<string, any> = {}, TOutputBroadcast extends EventRecord<string, any> = {}, TOutputSelf extends EventRecord<string, any> = {}, TOutputSync extends EventRecord<string, any> = {}> implements IOLike<TAuthorize, TInput, TOutputBroadcast, TOutputSelf, TOutputSync> {
     private _context;
-    private _initialStorage;
+    private _getInitialStorage;
     private _rooms;
     readonly _authorize: TAuthorize | null;
     readonly _debug: boolean;
@@ -275,9 +279,9 @@ type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<a
     authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired>;
     context?: TContext;
     debug?: boolean;
-    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
+    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
 declare const createIO: <TPlatform extends AbstractPlatform<any, {}, {}> = AbstractPlatform<any, {}, {}>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false>(params: CreateIOParams<TPlatform, TContext, TAuthorizeUser, TAuthorizeRequired>) => PluvIO<TPlatform, IOAuthorize<TAuthorizeUser, TAuthorizeRequired>, TContext, BaseClientEventRecord, BaseIOEventRecord<IOAuthorize<TAuthorizeUser, TAuthorizeRequired>>, {}, {}>;
 
-export { AbstractCloseEvent, AbstractErrorEvent, AbstractEvent, AbstractEventMap, AbstractListener, AbstractMessageEvent, AbstractPersistance, AbstractPlatform, AbstractPubSub, AbstractWebSocket, AbstractWebSocketConfig, AbstractWebSocketHandleErrorParams, AuthorizeModule, AuthorizeParams, ConvertWebSocketConfig, CreateIOParams, GetRoomOptions, IOPubSubEventMessage, IORoom, InferIORoom, InferPlatformEventContextType, InferPlatformRoomContextType, InferPlatformWebSocketType, JWT, JWTEncodeParams, PluvIO, createIO };
+export { AbstractCloseEvent, AbstractErrorEvent, AbstractEvent, AbstractEventMap, AbstractListener, AbstractMessageEvent, AbstractPersistance, AbstractPlatform, AbstractPubSub, AbstractWebSocket, AbstractWebSocketConfig, AbstractWebSocketHandleErrorParams, AuthorizeModule, AuthorizeParams, ConvertWebSocketConfig, CreateIOParams, GetRoomOptions, IOPubSubEventMessage, IORoom, InferIORoom, InferPlatformEventContextType, InferPlatformRoomContextType, InferPlatformWebSocketType, JWT, JWTEncodeParams, PluvIO, PluvIOConfig, createIO };

package/dist/index.js

@@ -730,7 +730,7 @@ var IORoom = class {
 var PluvIO = class {
   constructor(options) {
     this._context = {};
-    this._initialStorage = null;
+    this._getInitialStorage = null;
     this._rooms = /* @__PURE__ */ new Map();
     this._authorize = null;
     this._events = {
@@ -770,7 +770,9 @@ var PluvIO = class {
             var _a, _b;
             const oldState = yield this._platform.persistance.getStorageState(room);
             const updates = [
-              oldState ? null : yield (_a = this._initialStorage) == null ? void 0 : _a.call(this, room),
+              oldState ? null : yield (_a = this._getInitialStorage) == null ? void 0 : _a.call(this, __spreadProps(__spreadValues({}, context), {
+                room
+              })),
               update
             ];
             if (updates.some((_update) => !!_update)) {
@@ -836,7 +838,7 @@ var PluvIO = class {
       context,
       debug = false,
       events,
-      initialStorage,
+      getInitialStorage,
       onRoomDeleted,
       onStorageUpdated,
       platform
@@ -849,8 +851,8 @@ var PluvIO = class {
       this._context = context;
     if (events)
       this._events = events;
-    if (initialStorage)
-      this._initialStorage = initialStorage;
+    if (getInitialStorage)
+      this._getInitialStorage = getInitialStorage;
     this._listeners = {
       onRoomDeleted: (event) => onRoomDeleted == null ? void 0 : onRoomDeleted(event),
       onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event)
@@ -968,7 +970,7 @@ var createIO = (params) => {
     authorize: authorize2,
     context,
     debug,
-    initialStorage,
+    getInitialStorage,
     onRoomDeleted,
     onStorageUpdated,
     platform
@@ -977,7 +979,7 @@ var createIO = (params) => {
     authorize: authorize2,
     context,
     debug,
-    initialStorage,
+    getInitialStorage,
     onRoomDeleted,
     onStorageUpdated,
     platform

package/dist/index.mjs

@@ -693,7 +693,7 @@ var IORoom = class {
 var PluvIO = class {
   constructor(options) {
     this._context = {};
-    this._initialStorage = null;
+    this._getInitialStorage = null;
     this._rooms = /* @__PURE__ */ new Map();
     this._authorize = null;
     this._events = {
@@ -733,7 +733,9 @@ var PluvIO = class {
             var _a, _b;
             const oldState = yield this._platform.persistance.getStorageState(room);
             const updates = [
-              oldState ? null : yield (_a = this._initialStorage) == null ? void 0 : _a.call(this, room),
+              oldState ? null : yield (_a = this._getInitialStorage) == null ? void 0 : _a.call(this, __spreadProps(__spreadValues({}, context), {
+                room
+              })),
               update
             ];
             if (updates.some((_update) => !!_update)) {
@@ -799,7 +801,7 @@ var PluvIO = class {
       context,
       debug = false,
       events,
-      initialStorage,
+      getInitialStorage,
       onRoomDeleted,
       onStorageUpdated,
       platform
@@ -812,8 +814,8 @@ var PluvIO = class {
       this._context = context;
     if (events)
       this._events = events;
-    if (initialStorage)
-      this._initialStorage = initialStorage;
+    if (getInitialStorage)
+      this._getInitialStorage = getInitialStorage;
     this._listeners = {
       onRoomDeleted: (event) => onRoomDeleted == null ? void 0 : onRoomDeleted(event),
       onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event)
@@ -931,7 +933,7 @@ var createIO = (params) => {
     authorize: authorize2,
     context,
     debug,
-    initialStorage,
+    getInitialStorage,
     onRoomDeleted,
     onStorageUpdated,
     platform
@@ -940,7 +942,7 @@ var createIO = (params) => {
     authorize: authorize2,
     context,
     debug,
-    initialStorage,
+    getInitialStorage,
     onRoomDeleted,
     onStorageUpdated,
     platform

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/io",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "@pluv/io server-side websocket manager",
   "author": "leedavidcs",
   "license": "MIT",

package/src/PluvIO.ts

@@ -24,17 +24,15 @@ import type { JWTEncodeParams } from "./authorize";
 import { authorize } from "./authorize";
 import type { EventConfig, InferEventConfig } from "./types";
 
-export type InferIOContext<
-    TIO extends PluvIO<any, any, any, any, any, any, any>
-> = TIO extends PluvIO<any, any, infer IContext, any, any, any, any>
-    ? IContext
-    : never;
-
-export type InferIOPlatform<
-    TIO extends PluvIO<any, any, any, any, any, any, any>
-> = TIO extends PluvIO<infer IPlatform, any, any, any, any, any, any>
-    ? IPlatform
-    : never;
+type InferIOContext<TIO extends PluvIO<any, any, any, any, any, any, any>> =
+    TIO extends PluvIO<any, any, infer IContext, any, any, any, any>
+        ? IContext
+        : never;
+
+type InferIOPlatform<TIO extends PluvIO<any, any, any, any, any, any, any>> =
+    TIO extends PluvIO<infer IPlatform, any, any, any, any, any, any>
+        ? IPlatform
+        : never;
 
 export type InferIORoom<TIO extends PluvIO<any, any, any, any, any, any, any>> =
     TIO extends PluvIO<
@@ -57,6 +55,14 @@ export type InferIORoom<TIO extends PluvIO<any, any, any, any, any, any, any>> =
           >
         : never;
 
+type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
+    room: string;
+} & InferPlatformRoomContextType<TPlatform>;
+
+export type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (
+    event: GetInitialStorageEvent<TPlatform>
+) => MaybePromise<Maybe<string>>;
+
 export interface PluvIOListeners<TPlatform extends AbstractPlatform> {
     onRoomDeleted: (event: IORoomListenerEvent<TPlatform>) => void;
     onStorageUpdated: (event: IORoomListenerEvent<TPlatform>) => void;
@@ -82,7 +88,7 @@ export type PluvIOConfig<
         TOutputSelf,
         TOutputSync
     >;
-    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
+    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
 
@@ -102,9 +108,7 @@ export class PluvIO<
         IOLike<TAuthorize, TInput, TOutputBroadcast, TOutputSelf, TOutputSync>
 {
     private _context: TContext = {} as TContext;
-    private _initialStorage:
-        | ((room: string) => MaybePromise<Maybe<string>>)
-        | null = null;
+    private _getInitialStorage: GetInitialStorageFn<TPlatform> | null = null;
     private _rooms = new Map<
         string,
         IORoom<
@@ -176,7 +180,12 @@ export class PluvIO<
                         await this._platform.persistance.getStorageState(room);
 
                     const updates: readonly Maybe<string>[] = [
-                        oldState ? null : await this._initialStorage?.(room),
+                        oldState
+                            ? null
+                            : await this._getInitialStorage?.({
+                                  ...context,
+                                  room,
+                              }),
                         update,
                     ];
 
@@ -284,7 +293,7 @@ export class PluvIO<
             context,
             debug = false,
             events,
-            initialStorage,
+            getInitialStorage,
             onRoomDeleted,
             onStorageUpdated,
             platform,
@@ -296,7 +305,7 @@ export class PluvIO<
         if (authorize) this._authorize = authorize;
         if (context) this._context = context;
         if (events) this._events = events;
-        if (initialStorage) this._initialStorage = initialStorage;
+        if (getInitialStorage) this._getInitialStorage = getInitialStorage;
 
         this._listeners = {
             onRoomDeleted: (event) => onRoomDeleted?.(event),

package/src/createIO.ts

@@ -8,7 +8,7 @@ import type {
     MaybePromise,
 } from "@pluv/types";
 import type { AbstractPlatform } from "./AbstractPlatform";
-import type { PluvIOListeners } from "./PluvIO";
+import type { GetInitialStorageFn, PluvIOListeners } from "./PluvIO";
 import { PluvIO } from "./PluvIO";
 
 export type CreateIOParams<
@@ -20,7 +20,7 @@ export type CreateIOParams<
     authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired>;
     context?: TContext;
     debug?: boolean;
-    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
+    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
 
@@ -47,7 +47,7 @@ export const createIO = <
         authorize,
         context,
         debug,
-        initialStorage,
+        getInitialStorage,
         onRoomDeleted,
         onStorageUpdated,
         platform,
@@ -63,7 +63,7 @@ export const createIO = <
         authorize,
         context,
         debug,
-        initialStorage,
+        getInitialStorage,
         onRoomDeleted,
         onStorageUpdated,
         platform,

package/src/index.ts

@@ -26,7 +26,12 @@ export type {
     AbstractWebSocketHandleErrorParams,
 } from "./AbstractWebSocket";
 export type { IORoom } from "./IORoom";
-export type { GetRoomOptions, InferIORoom, PluvIO } from "./PluvIO";
+export type {
+    GetRoomOptions,
+    InferIORoom,
+    PluvIO,
+    PluvIOConfig,
+} from "./PluvIO";
 export type {
     AuthorizeModule,
     AuthorizeParams,