@ossy/sdk 1.25.2 → 1.25.3

package/build/public.index.d.ts

@@ -273,4 +273,34 @@ declare class SDK {
     makeRequest: <T extends Action>(action: T) => (_payload?: Required<T["payload"]>) => Promise<any>;
 }
 
+/**
+ * Unified interface for all SDK adapters.
+ *
+ * Adapters translate the generic `dispatch` / `query` calls into
+ * concrete operations — direct MongoDB writes (EventStoreAdapter),
+ * HTTP calls (HttpAdapter), or an in-memory store (InMemoryAdapter).
+ *
+ * Action names follow the pattern `{domain}/{verb}`, e.g.:
+ *   - `workspaces/create`
+ *   - `resources/create`
+ *   - `user/join-workspace`
+ *
+ * Query names follow the same pattern, e.g.:
+ *   - `workspaces/list`
+ *   - `resources/list`
+ *   - `resources/search`
+ */
+interface OssySdkAdapter {
+    /**
+     * Dispatch a write action. Returns the resulting entity/resource,
+     * or null for fire-and-forget operations.
+     */
+    dispatch(action: string, payload: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute a read query. Returns the matching data.
+     */
+    query(name: string, params?: Record<string, unknown>): Promise<unknown>;
+}
+
 export { ApiTokenCreate, ApiTokenGetAll, ApiTokenInvalidate, AuthGetAuthenticatedUser, AuthGetAuthenticatedUserHistory, AuthGetUser, AuthSignIn, AuthSignOff, AuthSignUp, AuthVerifyInvitation, AuthVerifySignIn, ResourceUpdateAccess, ResourcesCreate, ResourcesCreateDirectory, ResourcesGet, ResourcesList, ResourcesMove, ResourcesRemove, ResourcesRename, ResourcesSearch, ResourcesUpdateContent, ResourcesUpload, ResourcesUploadNamedVersion, SDK, UserCurrentGet, UserCurrentGetHistory, UserCurrentUpdate, WorkspacesCreate, WorkspacesCreateApiToken, WorkspacesDisableService, WorkspacesEnableService, WorkspacesGet, WorkspacesGetApiTokens, WorkspacesGetCurrent, WorkspacesGetResourceTemplates, WorkspacesGetUsers, WorkspacesImportResourceTemplates, WorkspacesInviteUser, WorkspacesList };
+export type { OssySdkAdapter };

package/build/types/adapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Unified interface for all SDK adapters.
+ *
+ * Adapters translate the generic `dispatch` / `query` calls into
+ * concrete operations — direct MongoDB writes (EventStoreAdapter),
+ * HTTP calls (HttpAdapter), or an in-memory store (InMemoryAdapter).
+ *
+ * Action names follow the pattern `{domain}/{verb}`, e.g.:
+ *   - `workspaces/create`
+ *   - `resources/create`
+ *   - `user/join-workspace`
+ *
+ * Query names follow the same pattern, e.g.:
+ *   - `workspaces/list`
+ *   - `resources/list`
+ *   - `resources/search`
+ */
+export interface OssySdkAdapter {
+    /**
+     * Dispatch a write action. Returns the resulting entity/resource,
+     * or null for fire-and-forget operations.
+     */
+    dispatch(action: string, payload: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute a read query. Returns the matching data.
+     */
+    query(name: string, params?: Record<string, unknown>): Promise<unknown>;
+}

package/build/types/public.index.d.ts

@@ -2,3 +2,4 @@ export { Tasks, TaskStatus } from './tasks-client.js';
 export * from '@ossy/types';
 export * from './sdk';
 export * from './Actions';
+export type { OssySdkAdapter } from './adapter.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ossy/sdk",
   "description": "Software Development Kit for interacting with our services",
-  "version": "1.25.2",
+  "version": "1.25.3",
   "url": "git://github.com/ossy-se/packages/sdk",
   "source": "src/public.index.ts",
   "main": "build/public.index.js",
@@ -21,7 +21,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@ossy/types": "^1.25.2"
+    "@ossy/types": "^1.25.3"
   },
   "scripts": {
     "start": "",
@@ -36,5 +36,5 @@
     "/build",
     "README.md"
   ],
-  "gitHead": "6e44e53bf3c9b5c14c5bc2b0a02e60a590389b55"
+  "gitHead": "88840c464266647e040f0b0d51c0bb95b18a056b"
 }