@scalix-world/sdk 1.1.0 → 1.2.0

package/dist/services/realtime.js

@@ -0,0 +1,297 @@
+export class RealtimeChannel {
+    name;
+    client;
+    opts;
+    listeners = new Map();
+    _presenceState = new Map();
+    subscribed = false;
+    constructor(name, client, opts) {
+        this.name = name;
+        this.client = client;
+        this.opts = opts;
+    }
+    on(event, optsOrCallback, maybeCallback) {
+        let key;
+        let cb;
+        if (typeof optsOrCallback === 'function') {
+            key = event;
+            cb = optsOrCallback;
+        }
+        else {
+            key = `${event}:${optsOrCallback.event}`;
+            cb = maybeCallback;
+        }
+        if (!this.listeners.has(key)) {
+            this.listeners.set(key, new Set());
+        }
+        this.listeners.get(key).add(cb);
+        return this;
+    }
+    async subscribe() {
+        try {
+            await this.client._join(this.name, this.opts);
+            this.subscribed = true;
+            return 'SUBSCRIBED';
+        }
+        catch {
+            return 'CHANNEL_ERROR';
+        }
+    }
+    async unsubscribe() {
+        if (!this.subscribed)
+            return;
+        await this.client._leave(this.name);
+        this.subscribed = false;
+    }
+    async send(opts) {
+        await this.client._broadcast(this.name, opts.event, opts.payload);
+    }
+    async track(state) {
+        await this.client._presenceTrack(this.name, state);
+    }
+    async untrack() {
+        await this.client._presenceUntrack(this.name);
+    }
+    presenceState() {
+        return new Map(this._presenceState);
+    }
+    /** @internal */
+    get _isSubscribed() {
+        return this.subscribed;
+    }
+    /** @internal */
+    _dispatch(event, payload) {
+        const keys = [event, '*'];
+        for (const key of keys) {
+            const cbs = this.listeners.get(key);
+            if (cbs) {
+                for (const cb of cbs) {
+                    try {
+                        cb(payload);
+                    }
+                    catch { /* swallow listener errors */ }
+                }
+            }
+        }
+        if (event === 'presence_state') {
+            this._presenceState.clear();
+            for (const [k, v] of Object.entries(payload)) {
+                this._presenceState.set(k, v);
+            }
+            this._dispatch('presence:sync', payload);
+        }
+        if (event === 'presence_diff') {
+            const joins = (payload.joins ?? {});
+            const leaves = (payload.leaves ?? []);
+            for (const [k, v] of Object.entries(joins)) {
+                this._presenceState.set(k, v);
+            }
+            for (const k of leaves) {
+                this._presenceState.delete(k);
+            }
+            if (Object.keys(joins).length > 0) {
+                this._dispatch('presence:join', { joins });
+            }
+            if (leaves.length > 0) {
+                this._dispatch('presence:leave', { leaves });
+            }
+        }
+    }
+}
+export class RealtimeService {
+    ws = null;
+    channels = new Map();
+    heartbeatTimer = null;
+    refCounter = 0;
+    pendingReplies = new Map();
+    config;
+    connected = false;
+    tenantId = null;
+    reconnectAttempt = 0;
+    reconnectTimer = null;
+    maxReconnectAttempts = 10;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect(tenantId) {
+        if (this.connected)
+            return;
+        this.tenantId = tenantId;
+        this.reconnectAttempt = 0;
+        await this.establishConnection(tenantId);
+    }
+    async establishConnection(tenantId) {
+        const base = this.config.baseUrl.replace(/^http/, 'ws');
+        const url = `${base}/api/v1/tenants/${tenantId}/realtime/v2/ws?token=${this.config.apiKey}`;
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(url);
+            this.ws.onopen = () => {
+                this.connected = true;
+                this.reconnectAttempt = 0;
+                this.startHeartbeat();
+                resolve();
+            };
+            this.ws.onerror = () => {
+                if (!this.connected)
+                    reject(new Error('WebSocket connection failed'));
+            };
+            this.ws.onclose = () => {
+                this.connected = false;
+                this.stopHeartbeat();
+                this.rejectPending();
+                if (this.tenantId) {
+                    this.scheduleReconnect();
+                }
+            };
+            this.ws.onmessage = (event) => {
+                try {
+                    const msg = JSON.parse(event.data);
+                    this.handleMessage(msg);
+                }
+                catch { /* ignore parse errors */ }
+            };
+        });
+    }
+    disconnect() {
+        this.tenantId = null;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.stopHeartbeat();
+        this.rejectPending();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.connected = false;
+        this.channels.clear();
+    }
+    channel(name, opts) {
+        const existing = this.channels.get(name);
+        if (existing)
+            return existing;
+        const ch = new RealtimeChannel(name, this, opts);
+        this.channels.set(name, ch);
+        return ch;
+    }
+    /** @internal */
+    async _join(name, opts) {
+        const payload = {};
+        if (opts?.filter)
+            payload.filter = opts.filter;
+        if (opts?.selfSend)
+            payload.self_send = opts.selfSend;
+        await this.sendAndWait(name, 'phx_join', payload);
+    }
+    /** @internal */
+    async _leave(name) {
+        await this.sendAndWait(name, 'phx_leave', {});
+        this.channels.delete(name);
+    }
+    /** @internal */
+    async _broadcast(name, event, payload) {
+        await this.sendAndWait(name, 'broadcast', { event, payload });
+    }
+    /** @internal */
+    async _presenceTrack(name, state) {
+        await this.sendAndWait(name, 'presence', { action: 'track', state });
+    }
+    /** @internal */
+    async _presenceUntrack(name) {
+        await this.sendAndWait(name, 'presence', { action: 'untrack' });
+    }
+    scheduleReconnect() {
+        if (this.reconnectAttempt >= this.maxReconnectAttempts || !this.tenantId)
+            return;
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempt) + Math.random() * 1000, 30000);
+        this.reconnectAttempt++;
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = null;
+            if (!this.tenantId)
+                return;
+            try {
+                await this.establishConnection(this.tenantId);
+                await this.resubscribeChannels();
+            }
+            catch {
+                if (this.tenantId) {
+                    this.scheduleReconnect();
+                }
+            }
+        }, delay);
+    }
+    async resubscribeChannels() {
+        for (const [, ch] of this.channels) {
+            if (ch._isSubscribed) {
+                try {
+                    await ch.subscribe();
+                }
+                catch { /* best-effort resubscribe */ }
+            }
+        }
+    }
+    rejectPending() {
+        for (const [ref, pending] of this.pendingReplies) {
+            pending.reject(new Error('connection closed'));
+            this.pendingReplies.delete(ref);
+        }
+    }
+    handleMessage(msg) {
+        if (msg.event === 'phx_reply' && msg.ref) {
+            const pending = this.pendingReplies.get(msg.ref);
+            if (pending) {
+                this.pendingReplies.delete(msg.ref);
+                const status = msg.payload.status;
+                if (status === 'ok') {
+                    pending.resolve(msg.payload);
+                }
+                else {
+                    pending.reject(new Error(msg.payload.reason ?? 'channel error'));
+                }
+            }
+            return;
+        }
+        const channel = this.channels.get(msg.topic);
+        if (channel) {
+            channel._dispatch(msg.event, msg.payload);
+        }
+    }
+    sendAndWait(topic, event, payload) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || !this.connected) {
+                return reject(new Error('not connected'));
+            }
+            const ref = String(++this.refCounter);
+            this.pendingReplies.set(ref, { resolve, reject });
+            const msg = { ref, topic, event, payload };
+            this.ws.send(JSON.stringify(msg));
+            setTimeout(() => {
+                if (this.pendingReplies.has(ref)) {
+                    this.pendingReplies.delete(ref);
+                    reject(new Error('timeout'));
+                }
+            }, 10000);
+        });
+    }
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => {
+            if (this.ws && this.connected) {
+                const msg = {
+                    ref: String(++this.refCounter),
+                    topic: 'heartbeat',
+                    event: 'heartbeat',
+                    payload: {},
+                };
+                this.ws.send(JSON.stringify(msg));
+            }
+        }, 30000);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/dist/services/realtime.js.map

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

package/dist/services/run.d.ts

@@ -0,0 +1,54 @@
+import { BaseService } from './base.js';
+export interface RunService_ {
+    id: string;
+    name: string;
+    image_ref: string;
+    port: number;
+    min_instances: number;
+    max_instances: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface DeployServiceOptions {
+    name: string;
+    image: string;
+    port?: number;
+    min_instances?: number;
+    max_instances?: number;
+    env?: Record<string, string>;
+}
+export interface ScaleOptions {
+    min_instances?: number;
+    max_instances?: number;
+}
+export interface Revision {
+    id: string;
+    revision_number: number;
+    image_ref: string;
+    created_at: string;
+    status: string;
+}
+export interface ServiceInstance {
+    id: string;
+    status: string;
+    created_at: string;
+}
+export declare class RunService extends BaseService {
+    list(): Promise<{
+        services: RunService_[];
+    }>;
+    get(id: string): Promise<RunService_>;
+    deploy(options: DeployServiceOptions): Promise<RunService_>;
+    scale(id: string, options: ScaleOptions): Promise<RunService_>;
+    delete(id: string): Promise<void>;
+    rollback(id: string, revision?: number): Promise<RunService_>;
+    revisions(id: string): Promise<{
+        revisions: Revision[];
+    }>;
+    instances(id: string): Promise<{
+        instances: ServiceInstance[];
+    }>;
+    metrics(id: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/services/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/services/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAW,SAAQ,WAAW;IACnC,IAAI,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAI5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIrC,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAa3D,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAM9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM7D,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IAIzD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAIhE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAG5D"}

package/dist/services/run.js

@@ -0,0 +1,44 @@
+import { BaseService } from './base.js';
+export class RunService extends BaseService {
+    async list() {
+        return this.request('GET', '/v1/run/services');
+    }
+    async get(id) {
+        return this.request('GET', `/v1/run/services/${encodeURIComponent(id)}`);
+    }
+    async deploy(options) {
+        return this.request('POST', '/v1/run/services', {
+            body: {
+                name: options.name,
+                image_ref: options.image,
+                port: options.port ?? 8080,
+                min_instances: options.min_instances ?? 0,
+                max_instances: options.max_instances ?? 10,
+                ...(options.env ? { env: options.env } : {}),
+            },
+        });
+    }
+    async scale(id, options) {
+        return this.request('PUT', `/v1/run/services/${encodeURIComponent(id)}`, {
+            body: options,
+        });
+    }
+    async delete(id) {
+        await this.requestRaw('DELETE', `/v1/run/services/${encodeURIComponent(id)}`);
+    }
+    async rollback(id, revision) {
+        return this.request('POST', `/v1/run/services/${encodeURIComponent(id)}/rollback`, {
+            body: { revision },
+        });
+    }
+    async revisions(id) {
+        return this.request('GET', `/v1/run/services/${encodeURIComponent(id)}/revisions`);
+    }
+    async instances(id) {
+        return this.request('GET', `/v1/run/services/${encodeURIComponent(id)}/instances`);
+    }
+    async metrics(id) {
+        return this.request('GET', `/v1/run/services/${encodeURIComponent(id)}/metrics`);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/services/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/services/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA0CxC,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAA6B;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE;YAC9C,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,KAAK;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;gBAC1B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC;gBACzC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;gBAC1C,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EAAU,EAAE,OAAqB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YACvE,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,QAAiB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE;YACjF,IAAI,EAAE,EAAE,QAAQ,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/services/search.d.ts

@@ -0,0 +1,32 @@
+import { BaseService } from './base.js';
+export interface SearchResult {
+    title?: string;
+    url?: string;
+    snippet?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+export interface SearchResponse {
+    query?: string;
+    results?: SearchResult[];
+    [key: string]: unknown;
+}
+export interface SearchSource {
+    id?: string;
+    url: string;
+    [key: string]: unknown;
+}
+/** Scalix Search — original-source curated search index. */
+export declare class SearchService extends BaseService {
+    /** Run a query against the curated index. */
+    search(query: string): Promise<SearchResponse>;
+    /** List the registered source feeds. */
+    listSources(): Promise<SearchSource[]>;
+    /** Add or update a source feed in the index. */
+    upsertSource(source: SearchSource): Promise<SearchSource>;
+    /** Index statistics (documents, sources, last crawl). */
+    stats(): Promise<Record<string, unknown>>;
+    /** Trigger an ingest/crawl run. */
+    runIngest(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/services/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4DAA4D;AAC5D,qBAAa,aAAc,SAAQ,WAAW;IAC5C,6CAA6C;IACvC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIpD,wCAAwC;IAClC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI5C,gDAAgD;IAC1C,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D,yDAAyD;IACnD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/C,mCAAmC;IAC7B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGpD"}

package/dist/services/search.js

@@ -0,0 +1,25 @@
+import { BaseService } from './base.js';
+/** Scalix Search — original-source curated search index. */
+export class SearchService extends BaseService {
+    /** Run a query against the curated index. */
+    async search(query) {
+        return this.request('GET', `/v1/search?q=${encodeURIComponent(query)}`);
+    }
+    /** List the registered source feeds. */
+    async listSources() {
+        return this.request('GET', '/v1/search/sources');
+    }
+    /** Add or update a source feed in the index. */
+    async upsertSource(source) {
+        return this.request('POST', '/v1/search/sources', { body: source });
+    }
+    /** Index statistics (documents, sources, last crawl). */
+    async stats() {
+        return this.request('GET', '/v1/search/stats');
+    }
+    /** Trigger an ingest/crawl run. */
+    async runIngest() {
+        return this.request('POST', '/v1/search/ingest/run', { body: {} });
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/services/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAsBxC,4DAA4D;AAC5D,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,6CAA6C;IAC7C,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,OAAO,CAAiB,KAAK,EAAE,gBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,OAAO,CAAiB,KAAK,EAAE,oBAAoB,CAAC,CAAC;IACnE,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,YAAY,CAAC,MAAoB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAe,MAAM,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,OAAO,CAA0B,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAC1E,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,OAAO,CAA0B,MAAM,EAAE,uBAAuB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/services/shield.d.ts

@@ -0,0 +1,48 @@
+import { BaseService } from './base.js';
+export interface ShieldConfig {
+    enabled: boolean;
+    inject_noai_headers?: boolean;
+    tdm_reservation?: boolean;
+    block_impersonators?: boolean;
+    category_defaults?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface CrawlerPolicy {
+    action: string;
+    rate_limit_per_min?: number;
+}
+export interface CustomRule {
+    id: string;
+    name: string;
+    ua_pattern: string;
+    policy: CrawlerPolicy;
+    created_at: string;
+}
+/** Scalix Shield — AI-crawler control and bot policies. */
+export declare class ShieldService extends BaseService {
+    /** Current shield configuration for the scope. */
+    getConfig(): Promise<ShieldConfig>;
+    /** Replace the shield configuration. */
+    updateConfig(config: ShieldConfig): Promise<ShieldConfig>;
+    /** List known crawlers and their effective policies. */
+    listCrawlers(): Promise<Record<string, unknown>>;
+    /** Set the policy for a known crawler. */
+    setCrawlerPolicy(id: string, policy: CrawlerPolicy): Promise<Record<string, unknown>>;
+    /** Clear a crawler's policy (revert to defaults). */
+    clearCrawlerPolicy(id: string): Promise<Record<string, unknown>>;
+    /** Override the IP ranges used to verify a crawler. */
+    setCrawlerIpRanges(id: string, ranges: string[]): Promise<Record<string, unknown>>;
+    /** Create a custom user-agent rule. */
+    createCustomRule(rule: Record<string, unknown>): Promise<CustomRule>;
+    /** Update a custom rule's policy. */
+    updateCustomRule(id: string, policy: CrawlerPolicy): Promise<Record<string, unknown>>;
+    /** Delete a custom rule. */
+    deleteCustomRule(id: string): Promise<Record<string, unknown>>;
+    /** List recent shield events (blocked/flagged requests). */
+    listEvents(page?: number, limit?: number): Promise<Record<string, unknown>>;
+    /** Shield statistics (requests seen, blocked, by category). */
+    stats(): Promise<Record<string, unknown>>;
+    /** The generated robots.txt for the scope. */
+    robotsTxt(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=shield.d.ts.map

package/dist/services/shield.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shield.d.ts","sourceRoot":"","sources":["../../src/services/shield.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,qBAAa,aAAc,SAAQ,WAAW;IAC5C,kDAAkD;IAC5C,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAIxC,wCAAwC;IAClC,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D,wDAAwD;IAClD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAItD,0CAA0C;IACpC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQ3F,qDAAqD;IAC/C,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOtE,uDAAuD;IACjD,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQxF,uCAAuC;IACjC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1E,qCAAqC;IAC/B,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQ3F,4BAA4B;IACtB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOpE,4DAA4D;IACtD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQjF,+DAA+D;IACzD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/C,8CAA8C;IACxC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGpD"}

package/dist/services/shield.js

@@ -0,0 +1,59 @@
+import { BaseService } from './base.js';
+/** Scalix Shield — AI-crawler control and bot policies. */
+export class ShieldService extends BaseService {
+    /** Current shield configuration for the scope. */
+    async getConfig() {
+        return this.request('GET', '/v1/shield/config');
+    }
+    /** Replace the shield configuration. */
+    async updateConfig(config) {
+        return this.request('PUT', '/v1/shield/config', { body: config });
+    }
+    /** List known crawlers and their effective policies. */
+    async listCrawlers() {
+        return this.request('GET', '/v1/shield/crawlers');
+    }
+    /** Set the policy for a known crawler. */
+    async setCrawlerPolicy(id, policy) {
+        return this.request('PUT', `/v1/shield/crawlers/${encodeURIComponent(id)}/policy`, { body: policy });
+    }
+    /** Clear a crawler's policy (revert to defaults). */
+    async clearCrawlerPolicy(id) {
+        return this.request('DELETE', `/v1/shield/crawlers/${encodeURIComponent(id)}/policy`);
+    }
+    /** Override the IP ranges used to verify a crawler. */
+    async setCrawlerIpRanges(id, ranges) {
+        return this.request('PUT', `/v1/shield/crawlers/${encodeURIComponent(id)}/ip-ranges`, { body: { ranges } });
+    }
+    /** Create a custom user-agent rule. */
+    async createCustomRule(rule) {
+        return this.request('POST', '/v1/shield/custom', { body: rule });
+    }
+    /** Update a custom rule's policy. */
+    async updateCustomRule(id, policy) {
+        return this.request('PUT', `/v1/shield/custom/${encodeURIComponent(id)}`, { body: policy });
+    }
+    /** Delete a custom rule. */
+    async deleteCustomRule(id) {
+        return this.request('DELETE', `/v1/shield/custom/${encodeURIComponent(id)}`);
+    }
+    /** List recent shield events (blocked/flagged requests). */
+    async listEvents(page, limit) {
+        const qs = new URLSearchParams();
+        if (page !== undefined)
+            qs.set('page', String(page));
+        if (limit !== undefined)
+            qs.set('limit', String(limit));
+        const suffix = qs.toString() ? `?${qs.toString()}` : '';
+        return this.request('GET', `/v1/shield/events${suffix}`);
+    }
+    /** Shield statistics (requests seen, blocked, by category). */
+    async stats() {
+        return this.request('GET', '/v1/shield/stats');
+    }
+    /** The generated robots.txt for the scope. */
+    async robotsTxt() {
+        return this.request('GET', '/v1/shield/robots-txt');
+    }
+}
+//# sourceMappingURL=shield.js.map

package/dist/services/shield.js.map

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