@goliapkg/sentori-next 1.0.0 → 1.1.0

package/lib/index.d.ts

@@ -4,4 +4,6 @@ export { resolveConfig } from './config.js';
 export type { SentoriNextConfig } from './config.js';
 export type { RequestErrorContext, RequestErrorRequest } from './server.js';
 export { SentoriErrorBoundary, SentoriProvider, useCaptureError, useSentori, } from '@goliapkg/sentori-react';
+export { sentoriPush } from './push.js';
+export type { SentoriPushConfig, SentoriPushClient } from './push.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,yBAAyB,CAAA;AAOhC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}

package/lib/index.js

@@ -11,4 +11,10 @@ export { clientInit } from './client.js';
 export { serverInit, onRequestError } from './server.js';
 export { resolveConfig } from './config.js';
 export { SentoriErrorBoundary, SentoriProvider, useCaptureError, useSentori, } from '@goliapkg/sentori-react';
+// v2.8 — server-side Push helper. Re-export from the dedicated
+// `/push` subpath so server-only code can `import { sentoriPush }
+// from '@goliapkg/sentori-next/push'` and avoid pulling the rest of
+// the surface. The top-level re-export here keeps `import { ... }
+// from '@goliapkg/sentori-next'` working for the common case.
+export { sentoriPush } from './push.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,6EAA6E;AAC7E,EAAE;AACF,mEAAmE;AACnE,8DAA8D;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAK3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,6EAA6E;AAC7E,EAAE;AACF,mEAAmE;AACnE,8DAA8D;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAK3C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,UAAU,GACX,MAAM,yBAAyB,CAAA;AAEhC,+DAA+D;AAC/D,kEAAkE;AAClE,oEAAoE;AACpE,kEAAkE;AAClE,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/lib/push.d.ts

@@ -0,0 +1,14 @@
+import type { PushMessage, PushReceipt, PushTicket } from '@goliapkg/sentori-core';
+export type SentoriPushConfig = {
+    ingestUrl: string;
+    token: string;
+    fetch?: typeof fetch;
+};
+export type SentoriPushClient = {
+    send(msg: PushMessage): Promise<PushTicket>;
+    sendBatch(msgs: PushMessage[]): Promise<PushTicket[]>;
+    getReceipt(sendId: string): Promise<PushReceipt>;
+    isSentoriPushToken(value: unknown): value is string;
+};
+export declare function sentoriPush(cfg: SentoriPushConfig): SentoriPushClient;
+//# sourceMappingURL=push.d.ts.map

package/lib/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,wBAAwB,CAAA;AAE/B,MAAM,MAAM,iBAAiB,GAAG;IAG9B,SAAS,EAAE,MAAM,CAAA;IAIjB,KAAK,EAAE,MAAM,CAAA;IAIb,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAI9B,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAM3C,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAErD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAEhD,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAA;CACpD,CAAA;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,CAgErE"}

package/lib/push.js

@@ -0,0 +1,90 @@
+// v2.8 — server-side Push helper for Next.js apps.
+//
+// Use from API routes, Server Actions, or any Node / Edge runtime
+// piece that needs to send a push. The helper wraps `/v1/push/send`
+// + `/v1/push/receipts/{id}` with the same wire shape the SDK
+// matrix shares (see `@goliapkg/sentori-core`'s `PushMessage` type).
+//
+// Edge-safe: pure `fetch`, no Node-only imports. Works under
+// `runtime: 'edge'` for App Router + middleware contexts.
+//
+// Example (App Router server action):
+//   'use server'
+//   import { sentoriPush } from '@goliapkg/sentori-next/push'
+//
+//   const push = sentoriPush({
+//     ingestUrl: process.env.SENTORI_INGEST_URL!,
+//     token: process.env.SENTORI_ADMIN_TOKEN!,
+//   })
+//
+//   export async function notifyComment(iptHandle: string, comment: string) {
+//     await push.send({
+//       to: iptHandle,
+//       title: 'New comment',
+//       body: comment.slice(0, 80),
+//       data: { kind: 'comment' },
+//     })
+//   }
+const MAX_CONCURRENT_BATCH = 8;
+export function sentoriPush(cfg) {
+    const fetchImpl = cfg.fetch ?? globalThis.fetch;
+    if (!fetchImpl) {
+        throw new Error('sentoriPush: no fetch implementation available');
+    }
+    const base = cfg.ingestUrl.replace(/\/+$/, '');
+    async function send(msg) {
+        const res = await fetchImpl(`${base}/v1/push/send`, {
+            method: 'POST',
+            headers: {
+                authorization: `Bearer ${cfg.token}`,
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(msg),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`/v1/push/send HTTP ${res.status}: ${detail.slice(0, 200)}`);
+        }
+        const body = (await res.json());
+        if (!body.tickets || body.tickets.length === 0) {
+            throw new Error('server returned no tickets');
+        }
+        return body.tickets[0];
+    }
+    async function sendBatch(msgs) {
+        // Pool of workers — each picks the next message off `queue`.
+        const queue = msgs.slice();
+        const results = new Array(msgs.length);
+        let nextSlot = 0;
+        const workers = [];
+        const worker = async () => {
+            while (true) {
+                const idx = nextSlot++;
+                const msg = queue[idx];
+                if (!msg)
+                    return;
+                results[idx] = await send(msg);
+            }
+        };
+        for (let i = 0; i < Math.min(MAX_CONCURRENT_BATCH, msgs.length); i++) {
+            workers.push(worker());
+        }
+        await Promise.all(workers);
+        return results;
+    }
+    async function getReceipt(sendId) {
+        const res = await fetchImpl(`${base}/v1/push/receipts/${encodeURIComponent(sendId)}`, {
+            headers: { authorization: `Bearer ${cfg.token}` },
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`/v1/push/receipts HTTP ${res.status}: ${detail.slice(0, 200)}`);
+        }
+        return (await res.json());
+    }
+    function isSentoriPushToken(value) {
+        return typeof value === 'string' && /^ipt_[0-9a-fA-F]+$/.test(value);
+    }
+    return { send, sendBatch, getReceipt, isSentoriPushToken };
+}
+//# sourceMappingURL=push.js.map

package/lib/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goliapkg/sentori-next",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Next.js adapter for Sentori — instrumentation.ts hooks, App Router error boundary, navigation tracing, env-driven provider built on @goliapkg/sentori-react.",
   "license": "Apache-2.0 OR MIT",
   "author": "GOLIA K.K. <takagi@golia.jp> (https://golia.jp)",
@@ -43,6 +43,10 @@
     "./app-router": {
       "types": "./lib/app-router.d.ts",
       "default": "./lib/app-router.js"
+    },
+    "./push": {
+      "types": "./lib/push.d.ts",
+      "default": "./lib/push.js"
     }
   },
   "files": [
@@ -61,9 +65,9 @@
     "react": ">=18"
   },
   "dependencies": {
-    "@goliapkg/sentori-core": "^1.0.0",
-    "@goliapkg/sentori-javascript": "^1.0.0",
-    "@goliapkg/sentori-react": "^1.0.0"
+    "@goliapkg/sentori-core": "^1.3.0",
+    "@goliapkg/sentori-javascript": "^1.3.0",
+    "@goliapkg/sentori-react": "^1.1.0"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/index.ts

@@ -21,3 +21,11 @@ export {
   useCaptureError,
   useSentori,
 } from '@goliapkg/sentori-react'
+
+// v2.8 — server-side Push helper. Re-export from the dedicated
+// `/push` subpath so server-only code can `import { sentoriPush }
+// from '@goliapkg/sentori-next/push'` and avoid pulling the rest of
+// the surface. The top-level re-export here keeps `import { ... }
+// from '@goliapkg/sentori-next'` working for the common case.
+export { sentoriPush } from './push.js'
+export type { SentoriPushConfig, SentoriPushClient } from './push.js'

package/src/push.ts

@@ -0,0 +1,132 @@
+// v2.8 — server-side Push helper for Next.js apps.
+//
+// Use from API routes, Server Actions, or any Node / Edge runtime
+// piece that needs to send a push. The helper wraps `/v1/push/send`
+// + `/v1/push/receipts/{id}` with the same wire shape the SDK
+// matrix shares (see `@goliapkg/sentori-core`'s `PushMessage` type).
+//
+// Edge-safe: pure `fetch`, no Node-only imports. Works under
+// `runtime: 'edge'` for App Router + middleware contexts.
+//
+// Example (App Router server action):
+//   'use server'
+//   import { sentoriPush } from '@goliapkg/sentori-next/push'
+//
+//   const push = sentoriPush({
+//     ingestUrl: process.env.SENTORI_INGEST_URL!,
+//     token: process.env.SENTORI_ADMIN_TOKEN!,
+//   })
+//
+//   export async function notifyComment(iptHandle: string, comment: string) {
+//     await push.send({
+//       to: iptHandle,
+//       title: 'New comment',
+//       body: comment.slice(0, 80),
+//       data: { kind: 'comment' },
+//     })
+//   }
+
+import type {
+  PushMessage,
+  PushReceipt,
+  PushTicket,
+} from '@goliapkg/sentori-core'
+
+export type SentoriPushConfig = {
+  /// Base URL of the Sentori ingest host. e.g. `https://ingest.sentori.golia.jp`.
+  /// Typically read from `process.env.SENTORI_INGEST_URL`.
+  ingestUrl: string
+  /// Admin Bearer token. The `/v1/push/send` route requires an
+  /// admin-scope token (the same kind that posts events).
+  /// Typically read from `process.env.SENTORI_ADMIN_TOKEN`.
+  token: string
+  /// Override the global fetch implementation. Defaults to
+  /// `globalThis.fetch`. Useful for unit tests + environments that
+  /// inject a fetch polyfill.
+  fetch?: typeof fetch
+}
+
+export type SentoriPushClient = {
+  /// Send one push. Returns the queued ticket (or the existing one
+  /// if the call carries an idempotency key that matched an earlier
+  /// send).
+  send(msg: PushMessage): Promise<PushTicket>
+  /// Send a batch — equivalent to N parallel `send` calls but uses
+  /// a single HTTP request when the message's `to` is an array. If
+  /// you pass an array of `PushMessage`s, this fans out to N
+  /// requests (one per message); concurrency-capped at 8 to avoid
+  /// flooding the Sentori dispatcher on big jobs.
+  sendBatch(msgs: PushMessage[]): Promise<PushTicket[]>
+  /// Fetch the latest status of a send by id.
+  getReceipt(sendId: string): Promise<PushReceipt>
+  /// `true` if `value` is a Sentori push handle (`ipt_...`).
+  isSentoriPushToken(value: unknown): value is string
+}
+
+const MAX_CONCURRENT_BATCH = 8
+
+export function sentoriPush(cfg: SentoriPushConfig): SentoriPushClient {
+  const fetchImpl = cfg.fetch ?? globalThis.fetch
+  if (!fetchImpl) {
+    throw new Error('sentoriPush: no fetch implementation available')
+  }
+  const base = cfg.ingestUrl.replace(/\/+$/, '')
+
+  async function send(msg: PushMessage): Promise<PushTicket> {
+    const res = await fetchImpl(`${base}/v1/push/send`, {
+      method: 'POST',
+      headers: {
+        authorization: `Bearer ${cfg.token}`,
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(msg),
+    })
+    if (!res.ok) {
+      const detail = await res.text().catch(() => '')
+      throw new Error(`/v1/push/send HTTP ${res.status}: ${detail.slice(0, 200)}`)
+    }
+    const body = (await res.json()) as { tickets?: PushTicket[] }
+    if (!body.tickets || body.tickets.length === 0) {
+      throw new Error('server returned no tickets')
+    }
+    return body.tickets[0]!
+  }
+
+  async function sendBatch(msgs: PushMessage[]): Promise<PushTicket[]> {
+    // Pool of workers — each picks the next message off `queue`.
+    const queue = msgs.slice()
+    const results: PushTicket[] = new Array(msgs.length)
+    let nextSlot = 0
+    const workers: Promise<void>[] = []
+    const worker = async (): Promise<void> => {
+      while (true) {
+        const idx = nextSlot++
+        const msg = queue[idx]
+        if (!msg) return
+        results[idx] = await send(msg)
+      }
+    }
+    for (let i = 0; i < Math.min(MAX_CONCURRENT_BATCH, msgs.length); i++) {
+      workers.push(worker())
+    }
+    await Promise.all(workers)
+    return results
+  }
+
+  async function getReceipt(sendId: string): Promise<PushReceipt> {
+    const res = await fetchImpl(`${base}/v1/push/receipts/${encodeURIComponent(sendId)}`, {
+      headers: { authorization: `Bearer ${cfg.token}` },
+    })
+    if (!res.ok) {
+      const detail = await res.text().catch(() => '')
+      throw new Error(`/v1/push/receipts HTTP ${res.status}: ${detail.slice(0, 200)}`)
+    }
+    return (await res.json()) as PushReceipt
+  }
+
+  function isSentoriPushToken(value: unknown): value is string {
+    return typeof value === 'string' && /^ipt_[0-9a-fA-F]+$/.test(value)
+  }
+
+  return { send, sendBatch, getReceipt, isSentoriPushToken }
+}