@sinio/sdk 0.1.0 → 0.2.0

package/README.md

@@ -43,8 +43,10 @@ console.log(result.accepted, result.duplicates, result.rejections);
   backoff and full jitter, honouring `Retry-After`. This is safe because
   a resend with the same `source_event_id` and the same content is counted in
   `duplicates`, never stored twice.
-- **Local validation.** A timestamp without a UTC offset is rejected before any
-  call, with the API's own rule, instead of coming back as an `invalid_occurred_at` rejection.
+- **Local validation.** What the API would refuse is refused before any call with a
+  `SinioValidationError` naming the field: a timestamp without a UTC offset (the API's own
+  rule), a kind or level outside its vocabulary, a missing required field, a `validTo` not after
+  `validFrom`, a role other than the four, a `payload` that is not an object.
 - **Typed errors.** `SinioAuthError` (401/403, do not replay),
   `SinioRequestError` (400/404/413, fix the request), `SinioRateLimitError`
   (429, carries `retryAfterSeconds`), `SinioServerError` (5xx, replayable),
@@ -64,6 +66,23 @@ for (const rejection of result.rejections) {
 
 `duplicates` and `revisions` are successes, not failures.
 
+The vocabularies are exported, so a value from elsewhere can be checked or a code handled
+without retyping the lists. A rejection code added by a later API version is kept as is:
+
+```ts
+import { ENTITY_KINDS, isKnownRejectionCode, type EntityKind } from "@sinio/sdk";
+
+const kind = row.type as EntityKind;
+if (!ENTITY_KINDS.includes(kind)) throw new Error(`unexpected kind ${row.type}`);
+
+for (const { code } of result.rejections) {
+  if (!isKnownRejectionCode(code)) console.warn("new rejection code", code);
+}
+```
+
+Also exported: `INGESTION_MODES`, `LOCATION_LEVELS`, `ASSIGNMENT_RELATIONS`, `EVENT_ROLES`,
+`REJECTION_CODES`.
+
 ## Reference data
 
 ```ts

package/dist/cjs/client.d.ts

@@ -1,6 +1,6 @@
 import { type FetchLike } from "./http.ts";
 import type { AssignmentInput, AssignmentsResult, EntityInput, LocationInput, SendEventsOptions, SendEventsResult, SinioEvent, ProjectOptions, UpsertResult } from "./types.ts";
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.2.0";
 export interface SinioClientOptions {
     /** Machine credential, sent as `Authorization: Bearer`. Mutually exclusive with `webhookKey`. */
     readonly apiKey?: string;
@@ -11,9 +11,15 @@ export interface SinioClientOptions {
     readonly webhookKey?: string;
     /** Defaults to `https://api.sinio.ai`. */
     readonly baseUrl?: string;
-    /** Sent as `X-Source-Code`; optional when the key is already bound to a source. */
+    /**
+     * Sent as `X-Source-Code`. Only for keys not bound to a single source (organization-wide keys,
+     * issued on request); a source key already carries its source.
+     */
     readonly sourceCode?: string;
-    /** Default project `external_id`, for publisher-level keys covering several projects. */
+    /**
+     * Default project `external_id`. Only for organization-wide keys (issued on request) covering
+     * several projects; a project key already carries its project.
+     */
     readonly project?: string;
     /** Per-request timeout, default 30 s. */
     readonly timeoutMs?: number;

package/dist/cjs/client.js

@@ -4,7 +4,7 @@ exports.SinioClient = exports.SDK_VERSION = void 0;
 const errors_ts_1 = require("./errors.js");
 const http_ts_1 = require("./http.js");
 const serialize_ts_1 = require("./serialize.js");
-exports.SDK_VERSION = "0.1.0";
+exports.SDK_VERSION = "0.2.0";
 /**
  * Client for the sinio.ai ingestion API.
  *
@@ -44,7 +44,8 @@ class SinioClient {
     }
     /** `POST /v1/events` — live ingestion. Derivation is asynchronous: a 200 confirms receipt only. */
     async sendEvents(events, options = {}) {
-        const wire = events.map((event, index) => (0, serialize_ts_1.toWireEvent)(this.project === undefined || event.project !== undefined ? event : { ...event, project: this.project }, index));
+        const mode = (0, serialize_ts_1.toWireMode)(options.mode ?? "webhook");
+        const wire = (0, serialize_ts_1.requireList)(events, "events").map((event, index) => (0, serialize_ts_1.toWireEvent)(withDefaultProject(event, this.project), index));
         const sourceCode = options.sourceCode ?? this.sourceCode;
         const headers = sourceCode === undefined ? {} : { "x-source-code": sourceCode };
         const merged = {
@@ -58,25 +59,22 @@ class SinioClient {
             testMode: false,
         };
         for (const part of (0, serialize_ts_1.chunk)(wire, serialize_ts_1.MAX_ITEMS_PER_CALL)) {
-            const body = { events: part, mode: options.mode ?? "webhook" };
-            const response = asRecord(await this.transport.post(this.eventsPath, body, { ...this.authHeaders, ...headers }));
+            const response = asRecord(await this.transport.post(this.eventsPath, { events: part, mode }, { ...this.authHeaders, ...headers }));
             const batchId = asString(response["batch_id"]);
             if (batchId !== null) {
                 merged.batchIds.push(batchId);
             }
-            Object.assign(merged, {
-                accepted: merged.accepted + asNumber(response["accepted"]),
-                pendingClassification: merged.pendingClassification + asNumber(response["pending_classification"]),
-                duplicates: merged.duplicates + asNumber(response["duplicates"]),
-                revisions: merged.revisions + asNumber(response["revisions"]),
-                rejected: merged.rejected + asNumber(response["rejected"]),
-                testMode: merged.testMode || response["test_mode"] === true,
-            });
+            merged.accepted += asNumber(response["accepted"]);
+            merged.pendingClassification += asNumber(response["pending_classification"]);
+            merged.duplicates += asNumber(response["duplicates"]);
+            merged.revisions += asNumber(response["revisions"]);
+            merged.rejected += asNumber(response["rejected"]);
+            merged.testMode = merged.testMode || response["test_mode"] === true;
             for (const rejection of asArray(response["rejections"])) {
                 const item = asRecord(rejection);
                 merged.rejections.push({
                     sourceEventId: asString(item["source_event_id"]) ?? "",
-                    code: asString(item["code"]) ?? "unknown",
+                    code: asCode(item["code"]),
                     message: asString(item["message"]) ?? "",
                 });
             }
@@ -96,11 +94,13 @@ class SinioClient {
      * to qualify in the console.
      */
     async upsertEntities(entities, options = {}) {
-        return this.upsertReference("/v1/entities", "entities", entities.map(serialize_ts_1.toWireEntity), options);
+        this.assertBearerMode("upsertEntities");
+        return this.upsertReference("/v1/entities", "entities", (0, serialize_ts_1.requireList)(entities, "entities").map((entity, index) => (0, serialize_ts_1.toWireEntity)(entity, index)), options);
     }
     /** `POST /v1/locations` — bulk upsert of the location tree, keyed on `external_id`. */
     async upsertLocations(locations, options = {}) {
-        return this.upsertReference("/v1/locations", "locations", locations.map(serialize_ts_1.toWireLocation), options);
+        this.assertBearerMode("upsertLocations");
+        return this.upsertReference("/v1/locations", "locations", (0, serialize_ts_1.requireList)(locations, "locations").map((location, index) => (0, serialize_ts_1.toWireLocation)(location, index)), options);
     }
     /**
      * `POST /v1/assignments` — `credential -> subject` with a validity range. An
@@ -108,20 +108,22 @@ class SinioClient {
      */
     async createAssignments(assignments, options = {}) {
         this.assertBearerMode("createAssignments");
-        const wire = assignments.map(serialize_ts_1.toWireAssignment);
-        const merged = { accepted: 0, rejected: 0, rejections: [] };
+        const wire = (0, serialize_ts_1.requireList)(assignments, "assignments").map((assignment, index) => (0, serialize_ts_1.toWireAssignment)(assignment, index));
+        const merged = {
+            accepted: 0,
+            rejected: 0,
+            rejections: [],
+        };
         for (const part of (0, serialize_ts_1.chunk)(wire, serialize_ts_1.MAX_ITEMS_PER_CALL)) {
             const response = asRecord(await this.transport.post("/v1/assignments", this.withProject({ assignments: part }, options), this.authHeaders));
-            Object.assign(merged, {
-                accepted: merged.accepted + asNumber(response["accepted"]),
-                rejected: merged.rejected + asNumber(response["rejected"]),
-            });
+            merged.accepted += asNumber(response["accepted"]);
+            merged.rejected += asNumber(response["rejected"]);
             for (const rejection of asArray(response["rejections"])) {
                 const item = asRecord(rejection);
                 merged.rejections.push({
                     credential: asString(item["credential"]) ?? "",
                     subject: asString(item["subject"]) ?? "",
-                    code: asString(item["code"]) ?? "unknown",
+                    code: asCode(item["code"]),
                     message: asString(item["message"]) ?? "",
                 });
             }
@@ -129,19 +131,20 @@ class SinioClient {
         return merged;
     }
     async upsertReference(path, key, wire, options) {
-        this.assertBearerMode(path);
-        const merged = { accepted: 0, rejected: 0, rejections: [] };
+        const merged = {
+            accepted: 0,
+            rejected: 0,
+            rejections: [],
+        };
         for (const part of (0, serialize_ts_1.chunk)(wire, serialize_ts_1.MAX_ITEMS_PER_CALL)) {
             const response = asRecord(await this.transport.post(path, this.withProject({ [key]: part }, options), this.authHeaders));
-            Object.assign(merged, {
-                accepted: merged.accepted + asNumber(response["accepted"]),
-                rejected: merged.rejected + asNumber(response["rejected"]),
-            });
+            merged.accepted += asNumber(response["accepted"]);
+            merged.rejected += asNumber(response["rejected"]);
             for (const rejection of asArray(response["rejections"])) {
                 const item = asRecord(rejection);
                 merged.rejections.push({
                     externalId: asString(item["external_id"]) ?? "",
-                    code: asString(item["code"]) ?? "unknown",
+                    code: asCode(item["code"]),
                     message: asString(item["message"]) ?? "",
                 });
             }
@@ -149,7 +152,7 @@ class SinioClient {
         return merged;
     }
     withProject(body, options) {
-        const project = options.project ?? this.project;
+        const project = optionalProject(options.project) ?? this.project;
         return project === undefined ? body : { project, ...body };
     }
     assertBearerMode(operation) {
@@ -159,6 +162,23 @@ class SinioClient {
     }
 }
 exports.SinioClient = SinioClient;
+/** The client-level project applies only to an event that does not name its own. */
+function withDefaultProject(event, project) {
+    if (project === undefined || typeof event !== "object" || event === null || event.project !== undefined) {
+        return event;
+    }
+    return { ...event, project };
+}
+function optionalProject(value) {
+    if (value !== undefined && typeof value !== "string") {
+        throw new errors_ts_1.SinioValidationError(`project must be a string (got ${JSON.stringify(value)})`);
+    }
+    return value;
+}
+/** A known code or any code the API adds later, kept as is; never a reason to fail. */
+function asCode(value) {
+    return asString(value) ?? "unknown";
+}
 function asRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value)
         ? value

package/dist/cjs/client.js.map

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

package/dist/cjs/errors.d.ts

@@ -1,3 +1,4 @@
+import type { RejectionCodeValue } from "./types.ts";
 /** Base class for every error the SDK throws. */
 export declare class SinioError extends Error {
     constructor(message: string);
@@ -11,9 +12,9 @@ export declare class SinioConnectionError extends SinioError {
 export declare class SinioApiError extends SinioError {
     readonly status: number;
     readonly body: unknown;
-    /** Rejection code returned by the API, when the body carries one. */
-    readonly code: string | null;
-    constructor(message: string, status: number, body: unknown, code?: string | null);
+    /** Rejection code returned by the API, when the body carries one (a known `RejectionCode` or a newer one). */
+    readonly code: RejectionCodeValue | null;
+    constructor(message: string, status: number, body: unknown, code?: RejectionCodeValue | null);
 }
 /** 401 / 403 — invalid, revoked, or insufficiently scoped key. Never replay. */
 export declare class SinioAuthError extends SinioApiError {

package/dist/cjs/errors.js

@@ -22,7 +22,7 @@ exports.SinioConnectionError = SinioConnectionError;
 class SinioApiError extends SinioError {
     status;
     body;
-    /** Rejection code returned by the API, when the body carries one. */
+    /** Rejection code returned by the API, when the body carries one (a known `RejectionCode` or a newer one). */
     code;
     constructor(message, status, body, code = null) {
         super(message);

package/dist/cjs/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,MAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AALD,gCAKC;AAED,6EAA6E;AAC7E,MAAa,oBAAqB,SAAQ,UAAU;IACzC,MAAM,CAAU;IAEzB,YAAY,OAAe,EAAE,MAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAPD,oDAOC;AAED,6BAA6B;AAC7B,MAAa,aAAc,SAAQ,UAAU;IAClC,MAAM,CAAS;IACf,IAAI,CAAU;IACvB,qEAAqE;IAC5D,IAAI,CAAgB;IAE7B,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa,EAAE,OAAsB,IAAI;QACpF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAZD,sCAYC;AAED,gFAAgF;AAChF,MAAa,cAAe,SAAQ,aAAa;CAAG;AAApD,wCAAoD;AAEpD,8EAA8E;AAC9E,MAAa,iBAAkB,SAAQ,aAAa;CAAG;AAAvD,8CAAuD;AAEvD,kFAAkF;AAClF,MAAa,mBAAoB,SAAQ,aAAa;IAC3C,iBAAiB,CAAgB;IAE1C,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa,EAAE,iBAAgC;QAC1F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAPD,kDAOC;AAED,yEAAyE;AACzE,MAAa,gBAAiB,SAAQ,aAAa;CAAG;AAAtD,4CAAsD;AAEtD,gFAAgF;AAChF,MAAa,oBAAqB,SAAQ,UAAU;CAAG;AAAvD,oDAAuD"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAEA,iDAAiD;AACjD,MAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AALD,gCAKC;AAED,6EAA6E;AAC7E,MAAa,oBAAqB,SAAQ,UAAU;IACzC,MAAM,CAAU;IAEzB,YAAY,OAAe,EAAE,MAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAPD,oDAOC;AAED,6BAA6B;AAC7B,MAAa,aAAc,SAAQ,UAAU;IAClC,MAAM,CAAS;IACf,IAAI,CAAU;IACvB,8GAA8G;IACrG,IAAI,CAA4B;IAEzC,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa,EAAE,OAAkC,IAAI;QAChG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAZD,sCAYC;AAED,gFAAgF;AAChF,MAAa,cAAe,SAAQ,aAAa;CAAG;AAApD,wCAAoD;AAEpD,8EAA8E;AAC9E,MAAa,iBAAkB,SAAQ,aAAa;CAAG;AAAvD,8CAAuD;AAEvD,kFAAkF;AAClF,MAAa,mBAAoB,SAAQ,aAAa;IAC3C,iBAAiB,CAAgB;IAE1C,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa,EAAE,iBAAgC;QAC1F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAPD,kDAOC;AAED,yEAAyE;AACzE,MAAa,gBAAiB,SAAQ,aAAa;CAAG;AAAtD,4CAAsD;AAEtD,gFAAgF;AAChF,MAAa,oBAAqB,SAAQ,UAAU;CAAG;AAAvD,oDAAuD"}

package/dist/cjs/http.d.ts

@@ -5,9 +5,9 @@ export interface TransportOptions {
     readonly maxRetries: number;
     readonly retryBaseDelayMs: number;
     readonly userAgent: string;
-    readonly fetch?: FetchLike;
+    readonly fetch?: FetchLike | undefined;
     /** Injected in tests so retries do not actually wait. */
-    readonly sleep?: (ms: number) => Promise<void>;
+    readonly sleep?: ((ms: number) => Promise<void>) | undefined;
 }
 /** `Retry-After` is either a delay in seconds or an HTTP date. Both are accepted. */
 export declare function parseRetryAfter(header: string | null, now?: number): number | null;

package/dist/cjs/index.d.ts

@@ -1,4 +1,5 @@
 export { SinioClient, SDK_VERSION, type SinioClientOptions } from "./client.ts";
 export { SinioApiError, SinioAuthError, SinioConnectionError, SinioError, SinioRateLimitError, SinioRequestError, SinioServerError, SinioValidationError, } from "./errors.ts";
-export { MAX_ITEMS_PER_CALL } from "./serialize.ts";
+export { MAX_EVENT_COUNT, MAX_ITEMS_PER_CALL } from "./serialize.ts";
+export { ASSIGNMENT_RELATIONS, ENTITY_KINDS, EVENT_ROLES, INGESTION_MODES, LOCATION_LEVELS, REJECTION_CODES, isKnownRejectionCode, } from "./vocabularies.ts";
 export type * from "./types.ts";

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_ITEMS_PER_CALL = exports.SinioValidationError = exports.SinioServerError = exports.SinioRequestError = exports.SinioRateLimitError = exports.SinioError = exports.SinioConnectionError = exports.SinioAuthError = exports.SinioApiError = exports.SDK_VERSION = exports.SinioClient = void 0;
+exports.isKnownRejectionCode = exports.REJECTION_CODES = exports.LOCATION_LEVELS = exports.INGESTION_MODES = exports.EVENT_ROLES = exports.ENTITY_KINDS = exports.ASSIGNMENT_RELATIONS = exports.MAX_ITEMS_PER_CALL = exports.MAX_EVENT_COUNT = exports.SinioValidationError = exports.SinioServerError = exports.SinioRequestError = exports.SinioRateLimitError = exports.SinioError = exports.SinioConnectionError = exports.SinioAuthError = exports.SinioApiError = exports.SDK_VERSION = exports.SinioClient = void 0;
 var client_ts_1 = require("./client.js");
 Object.defineProperty(exports, "SinioClient", { enumerable: true, get: function () { return client_ts_1.SinioClient; } });
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return client_ts_1.SDK_VERSION; } });
@@ -14,5 +14,14 @@ Object.defineProperty(exports, "SinioRequestError", { enumerable: true, get: fun
 Object.defineProperty(exports, "SinioServerError", { enumerable: true, get: function () { return errors_ts_1.SinioServerError; } });
 Object.defineProperty(exports, "SinioValidationError", { enumerable: true, get: function () { return errors_ts_1.SinioValidationError; } });
 var serialize_ts_1 = require("./serialize.js");
+Object.defineProperty(exports, "MAX_EVENT_COUNT", { enumerable: true, get: function () { return serialize_ts_1.MAX_EVENT_COUNT; } });
 Object.defineProperty(exports, "MAX_ITEMS_PER_CALL", { enumerable: true, get: function () { return serialize_ts_1.MAX_ITEMS_PER_CALL; } });
+var vocabularies_ts_1 = require("./vocabularies.js");
+Object.defineProperty(exports, "ASSIGNMENT_RELATIONS", { enumerable: true, get: function () { return vocabularies_ts_1.ASSIGNMENT_RELATIONS; } });
+Object.defineProperty(exports, "ENTITY_KINDS", { enumerable: true, get: function () { return vocabularies_ts_1.ENTITY_KINDS; } });
+Object.defineProperty(exports, "EVENT_ROLES", { enumerable: true, get: function () { return vocabularies_ts_1.EVENT_ROLES; } });
+Object.defineProperty(exports, "INGESTION_MODES", { enumerable: true, get: function () { return vocabularies_ts_1.INGESTION_MODES; } });
+Object.defineProperty(exports, "LOCATION_LEVELS", { enumerable: true, get: function () { return vocabularies_ts_1.LOCATION_LEVELS; } });
+Object.defineProperty(exports, "REJECTION_CODES", { enumerable: true, get: function () { return vocabularies_ts_1.REJECTION_CODES; } });
+Object.defineProperty(exports, "isKnownRejectionCode", { enumerable: true, get: function () { return vocabularies_ts_1.isKnownRejectionCode; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAgF;AAAvE,wGAAA,WAAW,OAAA;AAAE,wGAAA,WAAW,OAAA;AACjC,yCASqB;AARnB,0GAAA,aAAa,OAAA;AACb,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AACpB,uGAAA,UAAU,OAAA;AACV,gHAAA,mBAAmB,OAAA;AACnB,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AAEtB,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAgF;AAAvE,wGAAA,WAAW,OAAA;AAAE,wGAAA,WAAW,OAAA;AACjC,yCASqB;AARnB,0GAAA,aAAa,OAAA;AACb,2GAAA,cAAc,OAAA;AACd,iHAAA,oBAAoB,OAAA;AACpB,uGAAA,UAAU,OAAA;AACV,gHAAA,mBAAmB,OAAA;AACnB,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AAEtB,+CAAqE;AAA5D,+GAAA,eAAe,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AAC5C,qDAQ2B;AAPzB,uHAAA,oBAAoB,OAAA;AACpB,+GAAA,YAAY,OAAA;AACZ,8GAAA,WAAW,OAAA;AACX,kHAAA,eAAe,OAAA;AACf,kHAAA,eAAe,OAAA;AACf,kHAAA,eAAe,OAAA;AACf,uHAAA,oBAAoB,OAAA"}

package/dist/cjs/serialize.d.ts

@@ -1,11 +1,49 @@
-import type { AssignmentInput, EntityInput, LocationInput, SinioEvent, Timestamp } from "./types.ts";
+import type { AssignmentInput, AssignmentRelation, EntityInput, EntityKind, EventRole, IngestionMode, JsonObject, LocationInput, LocationLevel, SinioEvent, Timestamp } from "./types.ts";
 /** The API caps every collection at 500 items per call. */
 export declare const MAX_ITEMS_PER_CALL = 500;
 /** The most units one event may stand for. */
 export declare const MAX_EVENT_COUNT = 1000000;
+export type WireRoles = {
+    readonly [role in EventRole]?: string | undefined;
+};
+export interface WireEvent {
+    readonly source_event_id: string;
+    readonly source_version?: string | undefined;
+    readonly project?: string | undefined;
+    readonly type: string;
+    readonly label?: string | undefined;
+    readonly occurred_at: string;
+    readonly roles?: WireRoles | undefined;
+    readonly payload?: JsonObject | undefined;
+    readonly count?: number | undefined;
+}
+export interface WireEntity {
+    readonly external_id: string;
+    readonly kind: EntityKind;
+    readonly subkind?: string | undefined;
+    readonly label?: string | undefined;
+    readonly location?: string | undefined;
+    readonly attributes?: JsonObject | undefined;
+}
+export interface WireLocation {
+    readonly external_id: string;
+    readonly kind: LocationLevel;
+    readonly name: string;
+    readonly parent?: string | undefined;
+}
+export interface WireAssignment {
+    readonly credential: string;
+    readonly subject: string;
+    readonly relation?: AssignmentRelation | undefined;
+    readonly valid_from: string;
+    readonly valid_to?: string | undefined;
+}
 export declare function toIso(value: Timestamp, field: string): string;
 export declare function chunk<T>(items: readonly T[], size: number): T[][];
-export declare function toWireEvent(event: SinioEvent, index: number): Record<string, unknown>;
-export declare function toWireEntity(entity: EntityInput, index: number): Record<string, unknown>;
-export declare function toWireLocation(location: LocationInput, index: number): Record<string, unknown>;
-export declare function toWireAssignment(assignment: AssignmentInput, index: number): Record<string, unknown>;
+export declare function requireOneOf<const T extends string>(value: unknown, values: readonly T[], field: string): T;
+export declare function requireList(value: unknown, field: string): readonly unknown[];
+export declare function toWireMode(mode: unknown): IngestionMode;
+export declare function toWireEvent(event: SinioEvent, index: number): WireEvent;
+export declare function toWireEntity(entity: EntityInput, index: number): WireEntity;
+export declare function toWireLocation(location: LocationInput, index: number): WireLocation;
+export declare function toWireAssignment(assignment: AssignmentInput, index: number): WireAssignment;

package/dist/cjs/serialize.js

@@ -3,11 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_EVENT_COUNT = exports.MAX_ITEMS_PER_CALL = void 0;
 exports.toIso = toIso;
 exports.chunk = chunk;
+exports.requireOneOf = requireOneOf;
+exports.requireList = requireList;
+exports.toWireMode = toWireMode;
 exports.toWireEvent = toWireEvent;
 exports.toWireEntity = toWireEntity;
 exports.toWireLocation = toWireLocation;
 exports.toWireAssignment = toWireAssignment;
 const errors_ts_1 = require("./errors.js");
+const vocabularies_ts_1 = require("./vocabularies.js");
 /** The API caps every collection at 500 items per call. */
 exports.MAX_ITEMS_PER_CALL = 500;
 /** The most units one event may stand for. */
@@ -38,74 +42,150 @@ function chunk(items, size) {
     }
     return chunks;
 }
-function toWireEvent(event, index) {
-    if (!event.sourceEventId) {
-        throw new errors_ts_1.SinioValidationError(`events[${index}].sourceEventId is required`);
+// Local checks, each the API's own rule: the types already say it to TypeScript callers, these say it
+// at runtime to plain JavaScript and to values typed loosely (`as`, `any`, parsed JSON).
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function requireItem(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new errors_ts_1.SinioValidationError(`${field} must be an object (got ${describe(value)})`);
+    }
+    return value;
+}
+function requireString(value, field) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new errors_ts_1.SinioValidationError(`${field} is required and must be a non-empty string (got ${describe(value)})`);
+    }
+    return value;
+}
+function optionalString(value, field) {
+    if (value !== undefined && typeof value !== "string") {
+        throw new errors_ts_1.SinioValidationError(`${field} must be a string (got ${describe(value)})`);
+    }
+    return value;
+}
+function optionalNonEmptyString(value, field) {
+    return value === undefined ? undefined : requireString(value, field);
+}
+function optionalObject(value, field) {
+    if (value !== undefined && !isPlainObject(value)) {
+        throw new errors_ts_1.SinioValidationError(`${field} must be a JSON object (got ${describe(value)})`);
     }
-    if (!event.type) {
-        throw new errors_ts_1.SinioValidationError(`events[${index}].type is required`);
+    return value;
+}
+function requireOneOf(value, values, field) {
+    if (typeof value !== "string" || !values.includes(value)) {
+        throw new errors_ts_1.SinioValidationError(`${field} must be one of ${values.join(", ")} (got ${describe(value)})`);
     }
-    if (event.payload !== undefined &&
-        (typeof event.payload !== "object" || event.payload === null || Array.isArray(event.payload))) {
-        throw new errors_ts_1.SinioValidationError(`events[${index}].payload must be an object`);
+    return value;
+}
+function requireList(value, field) {
+    if (!Array.isArray(value)) {
+        throw new errors_ts_1.SinioValidationError(`${field} must be an array (got ${describe(value)})`);
     }
-    if (event.count !== undefined && (!Number.isInteger(event.count) || event.count < 1 || event.count > exports.MAX_EVENT_COUNT)) {
-        throw new errors_ts_1.SinioValidationError(`events[${index}].count must be an integer between 1 and ${exports.MAX_EVENT_COUNT}`);
+    return value;
+}
+function toWireMode(mode) {
+    return requireOneOf(mode, vocabularies_ts_1.INGESTION_MODES, "mode");
+}
+function describe(value) {
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (Array.isArray(value)) {
+        return "an array";
+    }
+    if (value instanceof Date) {
+        return "a Date";
+    }
+    return JSON.stringify(value) ?? String(value);
+}
+function toWireRoles(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const roles = requireItem(value, field);
+    for (const key of Object.keys(roles)) {
+        if (!vocabularies_ts_1.EVENT_ROLES.includes(key)) {
+            throw new errors_ts_1.SinioValidationError(`${field}.${key} is not a role: roles are ${vocabularies_ts_1.EVENT_ROLES.join(", ")}`);
+        }
     }
     return compact({
-        source_event_id: event.sourceEventId,
-        source_version: event.sourceVersion,
-        project: event.project,
-        type: event.type,
-        label: event.label,
-        occurred_at: toIso(event.occurredAt, `events[${index}].occurredAt`),
-        roles: event.roles === undefined ? undefined : compact({ ...event.roles }),
-        payload: event.payload,
-        count: event.count,
+        device: optionalNonEmptyString(roles["device"], `${field}.device`),
+        subject: optionalNonEmptyString(roles["subject"], `${field}.subject`),
+        location: optionalNonEmptyString(roles["location"], `${field}.location`),
+        actor: optionalNonEmptyString(roles["actor"], `${field}.actor`),
     });
 }
-function toWireEntity(entity, index) {
-    if (!entity.externalId) {
-        throw new errors_ts_1.SinioValidationError(`entities[${index}].externalId is required`);
-    }
-    if (!entity.kind) {
-        throw new errors_ts_1.SinioValidationError(`entities[${index}].kind is required`);
+function toWireEvent(event, index) {
+    const at = `events[${index}]`;
+    const item = requireItem(event, at);
+    const count = item["count"];
+    if (count !== undefined && (!Number.isInteger(count) || count < 1 || count > exports.MAX_EVENT_COUNT)) {
+        throw new errors_ts_1.SinioValidationError(`${at}.count must be an integer between 1 and ${exports.MAX_EVENT_COUNT} (got ${describe(count)})`);
     }
     return compact({
-        external_id: entity.externalId,
-        kind: entity.kind,
-        subkind: entity.subkind,
-        label: entity.label,
-        location: entity.location,
-        attributes: entity.attributes,
+        source_event_id: requireString(item["sourceEventId"], `${at}.sourceEventId`),
+        source_version: optionalString(item["sourceVersion"], `${at}.sourceVersion`),
+        project: optionalString(item["project"], `${at}.project`),
+        type: requireString(item["type"], `${at}.type`),
+        label: optionalString(item["label"], `${at}.label`),
+        occurred_at: toIso(requireTimestamp(item["occurredAt"], `${at}.occurredAt`), `${at}.occurredAt`),
+        roles: toWireRoles(item["roles"], `${at}.roles`),
+        payload: optionalObject(item["payload"], `${at}.payload`),
+        count: count,
+    });
+}
+function toWireEntity(entity, index) {
+    const at = `entities[${index}]`;
+    const item = requireItem(entity, at);
+    return compact({
+        external_id: requireString(item["externalId"], `${at}.externalId`),
+        kind: requireOneOf(item["kind"], vocabularies_ts_1.ENTITY_KINDS, `${at}.kind`),
+        subkind: optionalNonEmptyString(item["subkind"], `${at}.subkind`),
+        label: optionalString(item["label"], `${at}.label`),
+        location: optionalString(item["location"], `${at}.location`),
+        attributes: optionalObject(item["attributes"], `${at}.attributes`),
     });
 }
 function toWireLocation(location, index) {
-    if (!location.externalId) {
-        throw new errors_ts_1.SinioValidationError(`locations[${index}].externalId is required`);
-    }
-    if (!location.name) {
-        throw new errors_ts_1.SinioValidationError(`locations[${index}].name is required`);
-    }
+    const at = `locations[${index}]`;
+    const item = requireItem(location, at);
     return compact({
-        external_id: location.externalId,
-        kind: location.kind,
-        name: location.name,
-        parent: location.parent,
+        external_id: requireString(item["externalId"], `${at}.externalId`),
+        kind: requireOneOf(item["kind"], vocabularies_ts_1.LOCATION_LEVELS, `${at}.kind`),
+        name: requireString(item["name"], `${at}.name`),
+        parent: optionalString(item["parent"], `${at}.parent`),
     });
 }
 function toWireAssignment(assignment, index) {
-    if (!assignment.credential || !assignment.subject) {
-        throw new errors_ts_1.SinioValidationError(`assignments[${index}] requires both credential and subject`);
+    const at = `assignments[${index}]`;
+    const item = requireItem(assignment, at);
+    const relation = item["relation"];
+    const validFrom = toIso(requireTimestamp(item["validFrom"], `${at}.validFrom`), `${at}.validFrom`);
+    const rawValidTo = item["validTo"];
+    const validTo = rawValidTo === undefined || rawValidTo === null ? undefined : toIso(rawValidTo, `${at}.validTo`);
+    // The API's `invalid_validity_period`: an assignment has to end after it starts.
+    if (validTo !== undefined && Date.parse(validTo) <= Date.parse(validFrom)) {
+        throw new errors_ts_1.SinioValidationError(`${at}.validTo must be after validFrom (got ${validFrom} -> ${validTo})`);
     }
     return compact({
-        credential: assignment.credential,
-        subject: assignment.subject,
-        relation: assignment.relation,
-        valid_from: toIso(assignment.validFrom, `assignments[${index}].validFrom`),
-        valid_to: assignment.validTo === undefined || assignment.validTo === null
-            ? undefined
-            : toIso(assignment.validTo, `assignments[${index}].validTo`),
+        credential: requireString(item["credential"], `${at}.credential`),
+        subject: requireString(item["subject"], `${at}.subject`),
+        relation: relation === undefined ? undefined : requireOneOf(relation, vocabularies_ts_1.ASSIGNMENT_RELATIONS, `${at}.relation`),
+        valid_from: validFrom,
+        valid_to: validTo,
     });
 }
+function requireTimestamp(value, field) {
+    if (value === undefined || value === null || value === "") {
+        throw new errors_ts_1.SinioValidationError(`${field} is required`);
+    }
+    return value;
+}
 //# sourceMappingURL=serialize.js.map