@sinio/sdk 0.0.0-stage → 0.2.0

package/dist/esm/client.d.ts

@@ -0,0 +1,75 @@
+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.2.0";
+export interface SinioClientOptions {
+    /** Machine credential, sent as `Authorization: Bearer`. Mutually exclusive with `webhookKey`. */
+    readonly apiKey?: string;
+    /**
+     * Key carried in the URL instead of a header, for systems that can only be
+     * pointed at a webhook URL. Only `sendEvents` is available in this mode.
+     */
+    readonly webhookKey?: string;
+    /** Defaults to `https://api.sinio.ai`. */
+    readonly baseUrl?: string;
+    /**
+     * 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`. 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;
+    /** Retries on 429, 5xx and dropped connections. Default 3. */
+    readonly maxRetries?: number;
+    /** First backoff ceiling, doubled per attempt with full jitter. Default 500 ms. */
+    readonly retryBaseDelayMs?: number;
+    /** Injectable transport, for tests or for Node < 18. */
+    readonly fetch?: FetchLike;
+    /** Injectable sleep, so tests do not wait on retries. */
+    readonly sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Client for the sinio.ai ingestion API.
+ *
+ * Every method accepts an arbitrarily long list and splits it into calls of
+ * 500 items, the API limit, merging the counters and rejections back into a
+ * single result. Sending the same events twice is safe: idempotency is keyed
+ * on `(project, source, source_event_id, revision)`, so a replay is counted as
+ * a duplicate rather than stored again.
+ */
+export declare class SinioClient {
+    private readonly transport;
+    private readonly authHeaders;
+    private readonly eventsPath;
+    private readonly webhookMode;
+    private readonly sourceCode;
+    private readonly project;
+    constructor(options: SinioClientOptions);
+    /** `POST /v1/events` — live ingestion. Derivation is asynchronous: a 200 confirms receipt only. */
+    sendEvents(events: readonly SinioEvent[], options?: SendEventsOptions): Promise<SendEventsResult>;
+    /**
+     * Same endpoint with `mode: "backfill"`: history is persisted but nothing is
+     * alerted, and derivation is replayed later in a canonical order.
+     */
+    backfillEvents(events: readonly SinioEvent[], options?: Omit<SendEventsOptions, "mode">): Promise<SendEventsResult>;
+    /**
+     * `POST /v1/entities` — bulk upsert keyed on `(kind, external_id)`. An unknown
+     * `subkind` never fails the call: it is created undeclared, for someone
+     * to qualify in the console.
+     */
+    upsertEntities(entities: readonly EntityInput[], options?: ProjectOptions): Promise<UpsertResult>;
+    /** `POST /v1/locations` — bulk upsert of the location tree, keyed on `external_id`. */
+    upsertLocations(locations: readonly LocationInput[], options?: ProjectOptions): Promise<UpsertResult>;
+    /**
+     * `POST /v1/assignments` — `credential -> subject` with a validity range. An
+     * overlap is rejected with `overlapping_assignment`, never merged silently.
+     */
+    createAssignments(assignments: readonly AssignmentInput[], options?: ProjectOptions): Promise<AssignmentsResult>;
+    private upsertReference;
+    private withProject;
+    private assertBearerMode;
+}

package/dist/esm/client.js

@@ -0,0 +1,192 @@
+import { SinioValidationError } from "./errors.js";
+import { Transport } from "./http.js";
+import { MAX_ITEMS_PER_CALL, chunk, requireList, toWireAssignment, toWireEntity, toWireEvent, toWireLocation, toWireMode, } from "./serialize.js";
+export const SDK_VERSION = "0.2.0";
+/**
+ * Client for the sinio.ai ingestion API.
+ *
+ * Every method accepts an arbitrarily long list and splits it into calls of
+ * 500 items, the API limit, merging the counters and rejections back into a
+ * single result. Sending the same events twice is safe: idempotency is keyed
+ * on `(project, source, source_event_id, revision)`, so a replay is counted as
+ * a duplicate rather than stored again.
+ */
+export class SinioClient {
+    transport;
+    authHeaders;
+    eventsPath;
+    webhookMode;
+    sourceCode;
+    project;
+    constructor(options) {
+        const hasApiKey = typeof options.apiKey === "string" && options.apiKey.length > 0;
+        const hasWebhookKey = typeof options.webhookKey === "string" && options.webhookKey.length > 0;
+        if (hasApiKey === hasWebhookKey) {
+            throw new SinioValidationError("Provide exactly one of `apiKey` or `webhookKey`.");
+        }
+        this.webhookMode = hasWebhookKey;
+        this.authHeaders = hasApiKey ? { authorization: `Bearer ${options.apiKey}` } : {};
+        this.eventsPath = hasWebhookKey ? `/v1/webhooks/${encodeURIComponent(options.webhookKey)}` : "/v1/events";
+        this.sourceCode = options.sourceCode;
+        this.project = options.project;
+        this.transport = new Transport({
+            baseUrl: options.baseUrl ?? "https://api.sinio.ai",
+            timeoutMs: options.timeoutMs ?? 30_000,
+            maxRetries: options.maxRetries ?? 3,
+            retryBaseDelayMs: options.retryBaseDelayMs ?? 500,
+            userAgent: `sinio-node/${SDK_VERSION}`,
+            fetch: options.fetch,
+            sleep: options.sleep,
+        });
+    }
+    /** `POST /v1/events` — live ingestion. Derivation is asynchronous: a 200 confirms receipt only. */
+    async sendEvents(events, options = {}) {
+        const mode = toWireMode(options.mode ?? "webhook");
+        const wire = requireList(events, "events").map((event, index) => toWireEvent(withDefaultProject(event, this.project), index));
+        const sourceCode = options.sourceCode ?? this.sourceCode;
+        const headers = sourceCode === undefined ? {} : { "x-source-code": sourceCode };
+        const merged = {
+            batchIds: [],
+            accepted: 0,
+            pendingClassification: 0,
+            duplicates: 0,
+            revisions: 0,
+            rejected: 0,
+            rejections: [],
+            testMode: false,
+        };
+        for (const part of chunk(wire, MAX_ITEMS_PER_CALL)) {
+            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);
+            }
+            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: asCode(item["code"]),
+                    message: asString(item["message"]) ?? "",
+                });
+            }
+        }
+        return merged;
+    }
+    /**
+     * Same endpoint with `mode: "backfill"`: history is persisted but nothing is
+     * alerted, and derivation is replayed later in a canonical order.
+     */
+    async backfillEvents(events, options = {}) {
+        return this.sendEvents(events, { ...options, mode: "backfill" });
+    }
+    /**
+     * `POST /v1/entities` — bulk upsert keyed on `(kind, external_id)`. An unknown
+     * `subkind` never fails the call: it is created undeclared, for someone
+     * to qualify in the console.
+     */
+    async upsertEntities(entities, options = {}) {
+        this.assertBearerMode("upsertEntities");
+        return this.upsertReference("/v1/entities", "entities", requireList(entities, "entities").map((entity, index) => toWireEntity(entity, index)), options);
+    }
+    /** `POST /v1/locations` — bulk upsert of the location tree, keyed on `external_id`. */
+    async upsertLocations(locations, options = {}) {
+        this.assertBearerMode("upsertLocations");
+        return this.upsertReference("/v1/locations", "locations", requireList(locations, "locations").map((location, index) => toWireLocation(location, index)), options);
+    }
+    /**
+     * `POST /v1/assignments` — `credential -> subject` with a validity range. An
+     * overlap is rejected with `overlapping_assignment`, never merged silently.
+     */
+    async createAssignments(assignments, options = {}) {
+        this.assertBearerMode("createAssignments");
+        const wire = requireList(assignments, "assignments").map((assignment, index) => toWireAssignment(assignment, index));
+        const merged = {
+            accepted: 0,
+            rejected: 0,
+            rejections: [],
+        };
+        for (const part of chunk(wire, MAX_ITEMS_PER_CALL)) {
+            const response = asRecord(await this.transport.post("/v1/assignments", this.withProject({ assignments: part }, options), this.authHeaders));
+            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: asCode(item["code"]),
+                    message: asString(item["message"]) ?? "",
+                });
+            }
+        }
+        return merged;
+    }
+    async upsertReference(path, key, wire, options) {
+        const merged = {
+            accepted: 0,
+            rejected: 0,
+            rejections: [],
+        };
+        for (const part of chunk(wire, MAX_ITEMS_PER_CALL)) {
+            const response = asRecord(await this.transport.post(path, this.withProject({ [key]: part }, options), this.authHeaders));
+            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: asCode(item["code"]),
+                    message: asString(item["message"]) ?? "",
+                });
+            }
+        }
+        return merged;
+    }
+    withProject(body, options) {
+        const project = optionalProject(options.project) ?? this.project;
+        return project === undefined ? body : { project, ...body };
+    }
+    assertBearerMode(operation) {
+        if (this.webhookMode) {
+            throw new SinioValidationError(`${operation} requires an API key: a webhook key only authenticates event ingestion.`);
+        }
+    }
+}
+/** 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 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
+        : {};
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function asNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : 0;
+}
+function asString(value) {
+    return typeof value === "string" ? value : null;
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/errors.d.ts

@@ -0,0 +1,35 @@
+import type { RejectionCodeValue } from "./types.ts";
+/** Base class for every error the SDK throws. */
+export declare class SinioError extends Error {
+    constructor(message: string);
+}
+/** The request never got a usable HTTP response (DNS, TCP, TLS, timeout). */
+export declare class SinioConnectionError extends SinioError {
+    readonly reason: unknown;
+    constructor(message: string, reason?: unknown);
+}
+/** A 4xx or 5xx response. */
+export declare class SinioApiError extends SinioError {
+    readonly status: number;
+    readonly body: unknown;
+    /** 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 {
+}
+/** 400 / 404 / 413 — the request itself is wrong. Fix it before replaying. */
+export declare class SinioRequestError extends SinioApiError {
+}
+/** 429 — quota exceeded. `retryAfterSeconds` mirrors the `Retry-After` header. */
+export declare class SinioRateLimitError extends SinioApiError {
+    readonly retryAfterSeconds: number | null;
+    constructor(message: string, status: number, body: unknown, retryAfterSeconds: number | null);
+}
+/** 5xx — temporary. Safe to replay verbatim: ingestion is idempotent. */
+export declare class SinioServerError extends SinioApiError {
+}
+/** Raised before any network call, when the input cannot be a valid request. */
+export declare class SinioValidationError extends SinioError {
+}

package/dist/esm/errors.js

@@ -0,0 +1,49 @@
+/** Base class for every error the SDK throws. */
+export class SinioError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+/** The request never got a usable HTTP response (DNS, TCP, TLS, timeout). */
+export class SinioConnectionError extends SinioError {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+    }
+}
+/** A 4xx or 5xx response. */
+export class SinioApiError extends SinioError {
+    status;
+    body;
+    /** 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);
+        this.status = status;
+        this.body = body;
+        this.code = code;
+    }
+}
+/** 401 / 403 — invalid, revoked, or insufficiently scoped key. Never replay. */
+export class SinioAuthError extends SinioApiError {
+}
+/** 400 / 404 / 413 — the request itself is wrong. Fix it before replaying. */
+export class SinioRequestError extends SinioApiError {
+}
+/** 429 — quota exceeded. `retryAfterSeconds` mirrors the `Retry-After` header. */
+export class SinioRateLimitError extends SinioApiError {
+    retryAfterSeconds;
+    constructor(message, status, body, retryAfterSeconds) {
+        super(message, status, body);
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/** 5xx — temporary. Safe to replay verbatim: ingestion is idempotent. */
+export class SinioServerError extends SinioApiError {
+}
+/** Raised before any network call, when the input cannot be a valid request. */
+export class SinioValidationError extends SinioError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,OAAO,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;AAED,6EAA6E;AAC7E,MAAM,OAAO,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;AAED,6BAA6B;AAC7B,MAAM,OAAO,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;AAED,gFAAgF;AAChF,MAAM,OAAO,cAAe,SAAQ,aAAa;CAAG;AAEpD,8EAA8E;AAC9E,MAAM,OAAO,iBAAkB,SAAQ,aAAa;CAAG;AAEvD,kFAAkF;AAClF,MAAM,OAAO,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;AAED,yEAAyE;AACzE,MAAM,OAAO,gBAAiB,SAAQ,aAAa;CAAG;AAEtD,gFAAgF;AAChF,MAAM,OAAO,oBAAqB,SAAQ,UAAU;CAAG"}

package/dist/esm/http.d.ts

@@ -0,0 +1,22 @@
+export type FetchLike = (input: string, init: RequestInit) => Promise<Response>;
+export interface TransportOptions {
+    readonly baseUrl: string;
+    readonly timeoutMs: number;
+    readonly maxRetries: number;
+    readonly retryBaseDelayMs: number;
+    readonly userAgent: string;
+    readonly fetch?: FetchLike | undefined;
+    /** Injected in tests so retries do not actually wait. */
+    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;
+export declare class Transport {
+    private readonly options;
+    private readonly fetchImpl;
+    private readonly sleep;
+    constructor(options: TransportOptions);
+    post(path: string, body: unknown, headers: Record<string, string>): Promise<unknown>;
+    /** Exponential backoff with full jitter, unless the server told us how long to wait. */
+    private backoffMs;
+}

package/dist/esm/http.js

@@ -0,0 +1,134 @@
+import { SinioAuthError, SinioConnectionError, SinioRateLimitError, SinioRequestError, SinioServerError, } from "./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. */
+export 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;
+}
+export 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 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;
+    }
+}
+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 SinioAuthError(message, response.status, body, code);
+    }
+    if (response.status === 429) {
+        return new SinioRateLimitError(message, response.status, body, retryAfterSeconds);
+    }
+    if (response.status >= 500) {
+        return new SinioServerError(message, response.status, body, code);
+    }
+    return new 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/esm/http.js.map

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

package/dist/esm/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/esm/index.js

@@ -0,0 +1,5 @@
+export { SinioClient, SDK_VERSION } from "./client.js";
+export { SinioApiError, SinioAuthError, SinioConnectionError, SinioError, SinioRateLimitError, SinioRequestError, SinioServerError, SinioValidationError, } from "./errors.js";
+export { MAX_EVENT_COUNT, MAX_ITEMS_PER_CALL } from "./serialize.js";
+export { ASSIGNMENT_RELATIONS, ENTITY_KINDS, EVENT_ROLES, INGESTION_MODES, LOCATION_LEVELS, REJECTION_CODES, isKnownRejectionCode, } from "./vocabularies.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/esm/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;