@sinio/sdk 0.0.0-stage → 0.1.0

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,4 @@
+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 type * from "./types.ts";

package/dist/cjs/index.js

@@ -0,0 +1,18 @@
+"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;
+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_ITEMS_PER_CALL", { enumerable: true, get: function () { return serialize_ts_1.MAX_ITEMS_PER_CALL; } });
+//# 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,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA"}

package/dist/cjs/package.json

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

package/dist/cjs/serialize.d.ts

@@ -0,0 +1,11 @@
+import type { AssignmentInput, EntityInput, LocationInput, 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 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>;

package/dist/cjs/serialize.js

@@ -0,0 +1,111 @@
+"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.toWireEvent = toWireEvent;
+exports.toWireEntity = toWireEntity;
+exports.toWireLocation = toWireLocation;
+exports.toWireAssignment = toWireAssignment;
+const errors_ts_1 = require("./errors.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;
+}
+function toWireEvent(event, index) {
+    if (!event.sourceEventId) {
+        throw new errors_ts_1.SinioValidationError(`events[${index}].sourceEventId is required`);
+    }
+    if (!event.type) {
+        throw new errors_ts_1.SinioValidationError(`events[${index}].type is required`);
+    }
+    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`);
+    }
+    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 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,
+    });
+}
+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`);
+    }
+    return compact({
+        external_id: entity.externalId,
+        kind: entity.kind,
+        subkind: entity.subkind,
+        label: entity.label,
+        location: entity.location,
+        attributes: entity.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`);
+    }
+    return compact({
+        external_id: location.externalId,
+        kind: location.kind,
+        name: location.name,
+        parent: location.parent,
+    });
+}
+function toWireAssignment(assignment, index) {
+    if (!assignment.credential || !assignment.subject) {
+        throw new errors_ts_1.SinioValidationError(`assignments[${index}] requires both credential and subject`);
+    }
+    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`),
+    });
+}
+//# 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,114 @@
+/** Ingestion mode. `backfill` persists history without triggering alerts. */
+export type IngestionMode = "webhook" | "backfill";
+/** Kinds accepted by `POST /v1/entities`. */
+export type EntityKind = "device" | "subject" | "asset" | "actor" | "credential";
+/** Levels accepted by `POST /v1/locations`. */
+export type LocationLevel = "site" | "zone" | "point";
+/** 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
+ * identifier from the source. Anything else (ticket number, firmware, ...)
+ * belongs in `payload`. The API refuses any other key.
+ */
+export interface EventRoles {
+    readonly device?: string;
+    readonly subject?: string;
+    readonly location?: string;
+    readonly actor?: 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`. Required for publisher-level keys, forbidden for project-level ones. */
+    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?: Record<string, unknown>;
+    /** 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;
+    readonly subkind?: string;
+    readonly label?: string;
+    /** External id of the location the entity sits in. */
+    readonly location?: string;
+    readonly attributes?: Record<string, unknown>;
+}
+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;
+    readonly relation?: string;
+    readonly validFrom: Timestamp;
+    readonly validTo?: Timestamp | null;
+}
+export interface EventRejection {
+    readonly sourceEventId: string;
+    readonly code: string;
+    readonly message: string;
+}
+export interface ReferenceRejection {
+    readonly externalId: string;
+    readonly code: string;
+    readonly message: string;
+}
+export interface AssignmentRejection {
+    readonly credential: string;
+    readonly subject: string;
+    readonly code: string;
+    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: string[];
+    readonly accepted: number;
+    readonly pendingClassification: number;
+    readonly duplicates: number;
+    readonly revisions: number;
+    readonly rejected: number;
+    readonly rejections: 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: ReferenceRejection[];
+}
+export interface AssignmentsResult {
+    readonly accepted: number;
+    readonly rejected: number;
+    readonly rejections: AssignmentRejection[];
+}
+export interface SendEventsOptions {
+    /** Defaults to `webhook`. */
+    readonly mode?: IngestionMode;
+    /** Overrides the client-level source code for this call. */
+    readonly sourceCode?: string;
+}
+/** Project override, for publisher-level API keys covering several projects. */
+export interface ProjectOptions {
+    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/esm/client.d.ts

@@ -0,0 +1,69 @@
+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 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`; optional when the key is already bound to a source. */
+    readonly sourceCode?: string;
+    /** Default project `external_id`, for publisher-level keys covering several projects. */
+    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,172 @@
+import { SinioValidationError } from "./errors.js";
+import { Transport } from "./http.js";
+import { MAX_ITEMS_PER_CALL, chunk, toWireAssignment, toWireEntity, toWireEvent, toWireLocation, } from "./serialize.js";
+export const SDK_VERSION = "0.1.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 wire = events.map((event, index) => toWireEvent(this.project === undefined || event.project !== undefined ? event : { ...event, project: 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 body = { events: part, mode: options.mode ?? "webhook" };
+            const response = asRecord(await this.transport.post(this.eventsPath, body, { ...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,
+            });
+            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",
+                    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 = {}) {
+        return this.upsertReference("/v1/entities", "entities", entities.map(toWireEntity), 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(toWireLocation), 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 = assignments.map(toWireAssignment);
+        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));
+            Object.assign(merged, {
+                accepted: merged.accepted + asNumber(response["accepted"]),
+                rejected: 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",
+                    message: asString(item["message"]) ?? "",
+                });
+            }
+        }
+        return merged;
+    }
+    async upsertReference(path, key, wire, options) {
+        this.assertBearerMode(path);
+        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));
+            Object.assign(merged, {
+                accepted: merged.accepted + asNumber(response["accepted"]),
+                rejected: 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",
+                    message: asString(item["message"]) ?? "",
+                });
+            }
+        }
+        return merged;
+    }
+    withProject(body, options) {
+        const project = 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.`);
+        }
+    }
+}
+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,34 @@
+/** 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. */
+    readonly code: string | null;
+    constructor(message: string, status: number, body: unknown, code?: string | 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. */
+    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":"AAAA,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,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;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"}