@sinio/sdk 0.0.0-stage → 0.2.0

package/dist/cjs/http.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transport = void 0;
+exports.parseRetryAfter = parseRetryAfter;
+const errors_ts_1 = require("./errors.js");
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** `Retry-After` is either a delay in seconds or an HTTP date. Both are accepted. */
+function parseRetryAfter(header, now = Date.now()) {
+    if (header === null) {
+        return null;
+    }
+    const seconds = Number(header);
+    if (Number.isFinite(seconds)) {
+        return Math.max(0, seconds);
+    }
+    const date = Date.parse(header);
+    if (Number.isNaN(date)) {
+        return null;
+    }
+    return Math.max(0, (date - now) / 1000);
+}
+/**
+ * A 429 or a 5xx is retried, and so is a dropped connection: ingestion is
+ * idempotent, so a replay can only ever be counted as a duplicate. A 4xx that
+ * is not a 429 is the caller's fault and is raised immediately.
+ */
+function isRetriableStatus(status) {
+    return status === 429 || status >= 500;
+}
+class Transport {
+    options;
+    fetchImpl;
+    sleep;
+    constructor(options) {
+        this.options = options;
+        const provided = options.fetch ?? globalThis.fetch;
+        if (provided === undefined) {
+            throw new Error("No global fetch available; pass `fetch` in the client options (Node < 18).");
+        }
+        this.fetchImpl = provided;
+        this.sleep = options.sleep ?? defaultSleep;
+    }
+    async post(path, body, headers) {
+        const url = `${this.options.baseUrl.replace(/\/+$/, "")}${path}`;
+        const payload = JSON.stringify(body);
+        let attempt = 0;
+        for (;;) {
+            let response;
+            try {
+                response = await this.fetchImpl(url, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        accept: "application/json",
+                        "user-agent": this.options.userAgent,
+                        ...headers,
+                    },
+                    body: payload,
+                    signal: AbortSignal.timeout(this.options.timeoutMs),
+                });
+            }
+            catch (cause) {
+                if (attempt >= this.options.maxRetries) {
+                    throw new errors_ts_1.SinioConnectionError(`Request to ${url} failed: ${String(cause)}`, cause);
+                }
+                await this.sleep(this.backoffMs(attempt, null));
+                attempt += 1;
+                continue;
+            }
+            if (response.ok) {
+                return await readJson(response);
+            }
+            const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+            if (isRetriableStatus(response.status) && attempt < this.options.maxRetries) {
+                await this.sleep(this.backoffMs(attempt, retryAfter));
+                attempt += 1;
+                continue;
+            }
+            throw await toApiError(response, retryAfter);
+        }
+    }
+    /** Exponential backoff with full jitter, unless the server told us how long to wait. */
+    backoffMs(attempt, retryAfterSeconds) {
+        if (retryAfterSeconds !== null) {
+            return retryAfterSeconds * 1000;
+        }
+        const ceiling = Math.min(this.options.retryBaseDelayMs * 2 ** attempt, 30_000);
+        return Math.random() * ceiling;
+    }
+}
+exports.Transport = Transport;
+async function readJson(response) {
+    const text = await response.text();
+    if (text.length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+async function toApiError(response, retryAfterSeconds) {
+    const body = await readJson(response);
+    const code = extractCode(body);
+    const message = `${response.status} ${response.statusText}: ${extractMessage(body) ?? "no message"}`;
+    if (response.status === 401 || response.status === 403) {
+        return new errors_ts_1.SinioAuthError(message, response.status, body, code);
+    }
+    if (response.status === 429) {
+        return new errors_ts_1.SinioRateLimitError(message, response.status, body, retryAfterSeconds);
+    }
+    if (response.status >= 500) {
+        return new errors_ts_1.SinioServerError(message, response.status, body, code);
+    }
+    return new errors_ts_1.SinioRequestError(message, response.status, body, code);
+}
+function extractCode(body) {
+    if (typeof body === "object" && body !== null && "code" in body && typeof body.code === "string") {
+        return body.code;
+    }
+    return null;
+}
+function extractMessage(body) {
+    if (typeof body === "string") {
+        return body;
+    }
+    if (typeof body !== "object" || body === null || !("message" in body)) {
+        return null;
+    }
+    const { message } = body;
+    // NestJS's ValidationPipe returns an array of messages, one per failed rule.
+    if (Array.isArray(message)) {
+        return message.join("; ");
+    }
+    return typeof message === "string" ? message : null;
+}
+//# sourceMappingURL=http.js.map

package/dist/cjs/http.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +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_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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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; } });
+var errors_ts_1 = require("./errors.js");
+Object.defineProperty(exports, "SinioApiError", { enumerable: true, get: function () { return errors_ts_1.SinioApiError; } });
+Object.defineProperty(exports, "SinioAuthError", { enumerable: true, get: function () { return errors_ts_1.SinioAuthError; } });
+Object.defineProperty(exports, "SinioConnectionError", { enumerable: true, get: function () { return errors_ts_1.SinioConnectionError; } });
+Object.defineProperty(exports, "SinioError", { enumerable: true, get: function () { return errors_ts_1.SinioError; } });
+Object.defineProperty(exports, "SinioRateLimitError", { enumerable: true, get: function () { return errors_ts_1.SinioRateLimitError; } });
+Object.defineProperty(exports, "SinioRequestError", { enumerable: true, get: function () { return errors_ts_1.SinioRequestError; } });
+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

@@ -0,0 +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,+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/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/serialize.d.ts

@@ -0,0 +1,49 @@
+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 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

@@ -0,0 +1,191 @@
+"use strict";
+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. */
+exports.MAX_EVENT_COUNT = 1_000_000;
+// The API's own rule: a `T`, seconds, an optional fraction, then `Z` or an offset. It rejects the
+// event otherwise (`invalid_occurred_at`); refused here, it is a fixable local error before any call.
+const ISO_WITH_OFFSET = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})$/;
+function toIso(value, field) {
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime())) {
+            throw new errors_ts_1.SinioValidationError(`${field} is an invalid Date`);
+        }
+        return value.toISOString();
+    }
+    if (typeof value !== "string" || !ISO_WITH_OFFSET.test(value)) {
+        throw new errors_ts_1.SinioValidationError(`${field} must be an ISO 8601 timestamp with an offset (got ${JSON.stringify(value)})`);
+    }
+    return value;
+}
+/** Drops `undefined` keys so they never reach the wire as `null`. */
+function compact(record) {
+    return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+}
+function chunk(items, size) {
+    const chunks = [];
+    for (let index = 0; index < items.length; index += size) {
+        chunks.push(items.slice(index, index + size));
+    }
+    return chunks;
+}
+// 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)})`);
+    }
+    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)})`);
+    }
+    return value;
+}
+function requireList(value, field) {
+    if (!Array.isArray(value)) {
+        throw new errors_ts_1.SinioValidationError(`${field} must be an array (got ${describe(value)})`);
+    }
+    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({
+        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 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({
+        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) {
+    const at = `locations[${index}]`;
+    const item = requireItem(location, at);
+    return compact({
+        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) {
+    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: 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

package/dist/cjs/serialize.js.map

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

package/dist/cjs/types.d.ts

@@ -0,0 +1,126 @@
+import type { AssignmentRelation, EntityKind, EventRole, IngestionMode, LocationLevel, RejectionCode } from "./vocabularies.ts";
+export type { AssignmentRelation, EntityKind, EventRole, IngestionMode, LocationLevel, RejectionCode };
+/**
+ * A rejection code as read from a response: one of the known `RejectionCode`s (autocompleted), or
+ * any other string the API may add later, kept as is.
+ */
+export type RejectionCodeValue = RejectionCode | (string & {});
+/** A JSON object: `payload` and `attributes` are never an array or a scalar. */
+export type JsonObject = Readonly<Record<string, unknown>>;
+/** An ISO 8601 timestamp *with* an offset, or a `Date`. */
+export type Timestamp = string | Date;
+/**
+ * The four structural roles the derivation engine resolves, each a raw, non-empty
+ * identifier from the source. Anything else (ticket number, firmware, ...)
+ * belongs in `payload`. The API refuses any other key.
+ */
+export type EventRoles = {
+    readonly [role in EventRole]?: string;
+};
+export interface SinioEvent {
+    /** Identity at the source, stable over time. Part of the idempotency key. */
+    readonly sourceEventId: string;
+    /** Source-side version, kept for tracing: it plays no part in deduplication. */
+    readonly sourceVersion?: string;
+    /** Project `external_id`. Only for organization-wide keys (issued on request), which cover several projects; a project key already carries its project. */
+    readonly project?: string;
+    /** `code` of an event type in the catalog. */
+    readonly type: string;
+    readonly label?: string;
+    /** ISO 8601 with offset. Without an offset the API rejects the event. */
+    readonly occurredAt: Timestamp;
+    readonly roles?: EventRoles;
+    /** Free-form, optional (`{}` when omitted); the readings (battery, signal, ...) are read from it as its source declares them. */
+    readonly payload?: JsonObject;
+    /** How many units this one event stands for (a button pressed ten times). An integer from 1 to 1,000,000; omitted = 1. */
+    readonly count?: number;
+}
+export interface EntityInput {
+    readonly externalId: string;
+    readonly kind: EntityKind;
+    /** Code of the entity's subkind; never empty when given. An unknown code is created undeclared. */
+    readonly subkind?: string;
+    readonly label?: string;
+    /** External id of the location the entity sits in. */
+    readonly location?: string;
+    /** Free-form JSON object. */
+    readonly attributes?: JsonObject;
+}
+export interface LocationInput {
+    readonly externalId: string;
+    readonly kind: LocationLevel;
+    readonly name: string;
+    /** External id of the parent location, if any. */
+    readonly parent?: string;
+}
+export interface AssignmentInput {
+    /** External id of the credential (badge, card, ...). */
+    readonly credential: string;
+    /** External id of the subject the credential is assigned to. */
+    readonly subject: string;
+    /** Defaults to `assigned_to`, the only relation today. */
+    readonly relation?: AssignmentRelation;
+    /** ISO 8601 with offset, or a `Date`. */
+    readonly validFrom: Timestamp;
+    /** Open-ended when omitted or `null`; otherwise strictly after `validFrom`. */
+    readonly validTo?: Timestamp | null;
+}
+export interface EventRejection {
+    readonly sourceEventId: string;
+    readonly code: RejectionCodeValue;
+    readonly message: string;
+}
+export interface ReferenceRejection {
+    readonly externalId: string;
+    readonly code: RejectionCodeValue;
+    readonly message: string;
+}
+export interface AssignmentRejection {
+    readonly credential: string;
+    readonly subject: string;
+    readonly code: RejectionCodeValue;
+    readonly message: string;
+}
+/**
+ * Outcome of `sendEvents`. `duplicates` and `revisions` are successes, not
+ * errors: replaying a batch is expected and never creates anything twice.
+ */
+export interface SendEventsResult {
+    /** Server-side batch ids, one per HTTP call the SDK made (batches are chunked at 500). */
+    readonly batchIds: readonly string[];
+    readonly accepted: number;
+    readonly pendingClassification: number;
+    readonly duplicates: number;
+    readonly revisions: number;
+    readonly rejected: number;
+    readonly rejections: readonly EventRejection[];
+    /** The key is in test mode: its events are checked and kept apart, never used for detection. */
+    readonly testMode: boolean;
+}
+export interface UpsertResult {
+    readonly accepted: number;
+    readonly rejected: number;
+    readonly rejections: readonly ReferenceRejection[];
+}
+export interface AssignmentsResult {
+    readonly accepted: number;
+    readonly rejected: number;
+    readonly rejections: readonly AssignmentRejection[];
+}
+export interface SendEventsOptions {
+    /** Defaults to `webhook`. */
+    readonly mode?: IngestionMode;
+    /**
+     * Overrides the client-level source code for this call. Only needed for keys not bound to a
+     * single source (organization-wide keys, issued on request).
+     */
+    readonly sourceCode?: string;
+}
+/**
+ * Project override, only for organization-wide API keys (issued on request) covering several
+ * projects. A project key already carries its project.
+ */
+export interface ProjectOptions {
+    /** Project `external_id`. */
+    readonly project?: string;
+}

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/cjs/vocabularies.d.ts

@@ -0,0 +1,23 @@
+/** Ingestion modes. `backfill` persists history without triggering alerts. */
+export declare const INGESTION_MODES: readonly ["webhook", "backfill"];
+export type IngestionMode = (typeof INGESTION_MODES)[number];
+/** Kinds accepted by `POST /v1/entities`. */
+export declare const ENTITY_KINDS: readonly ["device", "subject", "asset", "actor", "credential"];
+export type EntityKind = (typeof ENTITY_KINDS)[number];
+/** Levels accepted by `POST /v1/locations`. */
+export declare const LOCATION_LEVELS: readonly ["site", "zone", "point"];
+export type LocationLevel = (typeof LOCATION_LEVELS)[number];
+/** Relations accepted by `POST /v1/assignments`; `assigned_to` when omitted. */
+export declare const ASSIGNMENT_RELATIONS: readonly ["assigned_to"];
+export type AssignmentRelation = (typeof ASSIGNMENT_RELATIONS)[number];
+/** The four structural roles an event may carry in `roles`. */
+export declare const EVENT_ROLES: readonly ["device", "subject", "location", "actor"];
+export type EventRole = (typeof EVENT_ROLES)[number];
+/**
+ * Codes the API returns in `rejections[].code` today. The list may grow (additive changes): a
+ * response carrying a code missing here is passed through unchanged, never refused.
+ */
+export declare const REJECTION_CODES: readonly ["payload_too_large", "unknown_project", "unknown_source", "archived_source", "source_mismatch", "ambiguous_source", "invalid_occurred_at", "missing_required_field", "unknown_location", "unknown_parent_location", "overlapping_assignment", "invalid_validity_period"];
+export type RejectionCode = (typeof REJECTION_CODES)[number];
+/** Whether a rejection code is one this SDK version knows, narrowing it to `RejectionCode`. */
+export declare function isKnownRejectionCode(code: string): code is RejectionCode;

package/dist/cjs/vocabularies.js

@@ -0,0 +1,39 @@
+"use strict";
+// The closed vocabularies of the ingestion API, each defined once: the value list (used by the local
+// checks) and the type derived from it. They mirror the API contract exactly.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REJECTION_CODES = exports.EVENT_ROLES = exports.ASSIGNMENT_RELATIONS = exports.LOCATION_LEVELS = exports.ENTITY_KINDS = exports.INGESTION_MODES = void 0;
+exports.isKnownRejectionCode = isKnownRejectionCode;
+/** Ingestion modes. `backfill` persists history without triggering alerts. */
+exports.INGESTION_MODES = ["webhook", "backfill"];
+/** Kinds accepted by `POST /v1/entities`. */
+exports.ENTITY_KINDS = ["device", "subject", "asset", "actor", "credential"];
+/** Levels accepted by `POST /v1/locations`. */
+exports.LOCATION_LEVELS = ["site", "zone", "point"];
+/** Relations accepted by `POST /v1/assignments`; `assigned_to` when omitted. */
+exports.ASSIGNMENT_RELATIONS = ["assigned_to"];
+/** The four structural roles an event may carry in `roles`. */
+exports.EVENT_ROLES = ["device", "subject", "location", "actor"];
+/**
+ * Codes the API returns in `rejections[].code` today. The list may grow (additive changes): a
+ * response carrying a code missing here is passed through unchanged, never refused.
+ */
+exports.REJECTION_CODES = [
+    "payload_too_large",
+    "unknown_project",
+    "unknown_source",
+    "archived_source",
+    "source_mismatch",
+    "ambiguous_source",
+    "invalid_occurred_at",
+    "missing_required_field",
+    "unknown_location",
+    "unknown_parent_location",
+    "overlapping_assignment",
+    "invalid_validity_period",
+];
+/** Whether a rejection code is one this SDK version knows, narrowing it to `RejectionCode`. */
+function isKnownRejectionCode(code) {
+    return exports.REJECTION_CODES.includes(code);
+}
+//# sourceMappingURL=vocabularies.js.map

package/dist/cjs/vocabularies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabularies.js","sourceRoot":"","sources":["../../src/vocabularies.ts"],"names":[],"mappings":";AAAA,qGAAqG;AACrG,8EAA8E;;;AA2C9E,oDAEC;AA3CD,8EAA8E;AACjE,QAAA,eAAe,GAAG,CAAC,SAAS,EAAE,UAAU,CAAU,CAAC;AAGhE,6CAA6C;AAChC,QAAA,YAAY,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC;AAG3F,+CAA+C;AAClC,QAAA,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAGlE,gFAAgF;AACnE,QAAA,oBAAoB,GAAG,CAAC,aAAa,CAAU,CAAC;AAG7D,+DAA+D;AAClD,QAAA,WAAW,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAG/E;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,mBAAmB;IACnB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,wBAAwB;IACxB,kBAAkB;IAClB,yBAAyB;IACzB,wBAAwB;IACxB,yBAAyB;CACjB,CAAC;AAGX,+FAA+F;AAC/F,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,OAAQ,uBAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}