@meet-sudo/sdk 0.1.6 → 0.1.7

package/README.md

@@ -57,6 +57,28 @@ meetsudo.identify('user-123', {
 </script>
 ```
 
+### Server SDK (Node.js)
+
+```javascript
+import { MeetSudoServer } from '@meet-sudo/sdk';
+
+const ms = new MeetSudoServer({
+  apiKey: process.env.MEETSUDO_API_KEY,      // for identify/track/customer APIs
+  secretKey: process.env.MEETSUDO_SECRET_KEY // for logs APIs, must start with sk_
+});
+
+await ms.identify('user-123', {
+  email: 'user@example.com',
+  name: 'John Doe',
+  plan: 'pro'
+});
+
+await ms.track('user-123', 'invoice_paid', {
+  amount: 120,
+  currency: 'USD'
+});
+```
+
 ## API Reference
 
 ### `init(config)`
@@ -141,6 +163,96 @@ meetsudo.changelog('open');
 meetsudo.changelog('close');
 ```
 
+## Server API Reference
+
+### `new MeetSudoServer(config)`
+
+```typescript
+interface MeetSudoServerConfig {
+  apiKey?: string;
+  secretKey?: string;
+  apiUrl?: string;
+}
+```
+
+- Provide `apiKey` for customer/event APIs.
+- Provide `secretKey` for log ingest/query APIs.
+
+### `identify(userId, traits?)`
+
+Create or update a user from backend code.
+
+### `track(userId, eventName, properties?)`
+
+Track one backend event for a user.
+
+### `trackBatch(userId, events[])`
+
+Track multiple backend events in one call.
+
+### `getCustomer(customerId)`
+
+Fetch customer details.
+
+### `getCustomerTimeline(customerId, limit?)`
+
+Fetch customer timeline (events, messages, sessions).
+
+## Logging API (Server)
+
+### `log(entry)`
+
+Ingest a single backend log line.
+
+```javascript
+await ms.log({
+  level: 'error',
+  source: 'backend',
+  service: 'api',
+  event: 'checkout_failed',
+  message: 'Stripe returned 402',
+  user_id: 'user-123',
+  props: { duration_ms: 742, amount: 99 }
+});
+```
+
+### `logBatch(entries[])`
+
+Ingest multiple logs in one request.
+
+```javascript
+await ms.logBatch([
+  { level: 'info', source: 'backend', service: 'api', message: 'request started' },
+  { level: 'warn', source: 'backend', service: 'api', message: 'retrying payment' }
+]);
+```
+
+### `queryLogs({ query, from, to, limit })`
+
+Run Splunk-like queries.
+
+```javascript
+const r1 = await ms.queryLogs({ query: 'count' });
+const r2 = await ms.queryLogs({ query: 'stats count by service' });
+const r3 = await ms.queryLogs({ query: 'stats p95(prop.duration_ms) by service' });
+const r4 = await ms.queryLogs({ query: 'timechart span=1h' });
+```
+
+### `assistLogQuery(prompt)`
+
+Generate a valid logs query from English text.
+
+```javascript
+const assist = await ms.assistLogQuery(
+  'show p99 checkout latency by service in last 24 hours'
+);
+// assist.query => stats p99(prop.duration_ms) by service
+```
+
+### `getLogSchemaHints()`
+
+Get observed workspace fields (services, events, prop keys, levels, sources).
+
 ### Helper Methods
 
 ```javascript
@@ -193,7 +305,12 @@ import type {
   EventProperties,
   PageProperties,
   ChatAction,
-  ChangelogAction
+  ChangelogAction,
+  MeetSudoServerConfig,
+  LogEntry,
+  LogQueryRequest,
+  LogAssistResponse,
+  LogSchemaHintsResponse
 } from '@meet-sudo/sdk';
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meet-sudo/sdk",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "MeetSudo SDK - Chat, Analytics, Session Replay",
   "main": "dist/index.js",
   "module": "dist/index.mjs",