@clocknext/sdk 0.12.0 → 0.12.1

package/dist/index.d.cts

@@ -249,8 +249,10 @@ interface TrackResult {
      *   `"accepted"` — the server has written it to its durable inbox (`202`)
      *                  and will price it shortly. It can no longer be lost, but
      *                  it is not billed yet and `usageLog` is null. A rejection
-     *                  discovered during pricing will NOT come back to you here —
-     *                  read it back with `signals.list()`.
+     *                  discovered during pricing will NOT come back to you here,
+     *                  nor on `onError`. `signals.list()` shows what got priced;
+     *                  the dashboard's signal log — owner-only, by design — is
+     *                  where an individual rejection says why.
      *   `"recorded"` — the server priced it inline and `usageLog` is populated.
      *   `"dropped"`  — the SDK threw it away without sending: the client is
      *                  closed, or the local queue is full. `onDrop` fired with
@@ -1916,8 +1918,15 @@ declare function signalToWire(signal: Signal): Record<string, unknown>;
  *
  * Because of that, a signal the server later REJECTS (unknown `agentKey`, a
  * model the org has not enabled, no active plan) cannot come back through this
- * promise. It surfaces on the `onError` hook, and `list()` is how you confirm
- * one actually landed — ingestion being asynchronous, the only way to.
+ * promise — and does not reach `onError` either, since from here that request
+ * succeeded. Such a rejection has no programmatic channel at all: it is
+ * recorded on the workspace's signal log in the ClockNext dashboard, which is
+ * owner-only by design.
+ *
+ * `list()` is the partial check available from code. It returns priced usage
+ * logs with a `status`, so it confirms a signal landed and whether pricing
+ * succeeded — but a signal refused BEFORE pricing never becomes a usage log
+ * and does not appear there.
  */
 declare class Signals {
     private readonly transport;

package/dist/index.d.ts

@@ -249,8 +249,10 @@ interface TrackResult {
      *   `"accepted"` — the server has written it to its durable inbox (`202`)
      *                  and will price it shortly. It can no longer be lost, but
      *                  it is not billed yet and `usageLog` is null. A rejection
-     *                  discovered during pricing will NOT come back to you here —
-     *                  read it back with `signals.list()`.
+     *                  discovered during pricing will NOT come back to you here,
+     *                  nor on `onError`. `signals.list()` shows what got priced;
+     *                  the dashboard's signal log — owner-only, by design — is
+     *                  where an individual rejection says why.
      *   `"recorded"` — the server priced it inline and `usageLog` is populated.
      *   `"dropped"`  — the SDK threw it away without sending: the client is
      *                  closed, or the local queue is full. `onDrop` fired with
@@ -1916,8 +1918,15 @@ declare function signalToWire(signal: Signal): Record<string, unknown>;
  *
  * Because of that, a signal the server later REJECTS (unknown `agentKey`, a
  * model the org has not enabled, no active plan) cannot come back through this
- * promise. It surfaces on the `onError` hook, and `list()` is how you confirm
- * one actually landed — ingestion being asynchronous, the only way to.
+ * promise — and does not reach `onError` either, since from here that request
+ * succeeded. Such a rejection has no programmatic channel at all: it is
+ * recorded on the workspace's signal log in the ClockNext dashboard, which is
+ * owner-only by design.
+ *
+ * `list()` is the partial check available from code. It returns priced usage
+ * logs with a `status`, so it confirms a signal landed and whether pricing
+ * succeeded — but a signal refused BEFORE pricing never becomes a usage log
+ * and does not appear there.
  */
 declare class Signals {
     private readonly transport;

package/dist/index.js

@@ -326,7 +326,7 @@ function sleep(ms) {
 }
 
 // src/http.ts
-var SDK_VERSION = "0.12.0" ;
+var SDK_VERSION = "0.12.1" ;
 var Transport = class {
   constructor(cfg) {
     this.cfg = cfg;