@ysk-kit/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YSK Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/http.d.ts

@@ -0,0 +1,18 @@
+import { type Platform } from '@ysk-kit/contracts';
+import type { TokenStore } from './token-store';
+export declare class HttpClient {
+    private readonly opts;
+    private refreshing;
+    constructor(opts: {
+        baseUrl: string;
+        tokenStore: TokenStore;
+        platform: Platform;
+        fetchImpl?: typeof fetch;
+        onRefreshed?: (access: string, refresh: string) => Promise<void>;
+    });
+    request<T>(path: string, init?: RequestInit, didRefresh?: boolean): Promise<T>;
+    requestLocation(path: string): Promise<string>;
+    private refreshOnce;
+    private doRefresh;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,OAAO,CAAC,UAAU,CAAiC;gBAGhC,IAAI,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,UAAU,CAAC;QACvB,QAAQ,EAAE,QAAQ,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;QACzB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAClE;IAGG,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAsChF,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BpD,OAAO,CAAC,WAAW;YASL,SAAS;CAuCxB"}

package/dist/http.js

@@ -0,0 +1,113 @@
+import { ErrSchema } from '@ysk-kit/contracts';
+import { AppError } from '@ysk-kit/domain-kernel';
+export class HttpClient {
+    opts;
+    refreshing = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async request(path, init = {}, didRefresh = false) {
+        const fetchImpl = this.opts.fetchImpl ?? fetch;
+        const token = await this.opts.tokenStore.get();
+        const headers = new Headers(init.headers);
+        if (!headers.has('content-type') && init.body)
+            headers.set('content-type', 'application/json');
+        headers.set('x-ysk-platform', this.opts.platform);
+        if (token)
+            headers.set('authorization', `Bearer ${token}`);
+        const res = await fetchImpl(`${this.opts.baseUrl}${path}`, { ...init, headers });
+        const json = await res.json().catch(() => null);
+        const failed = ErrSchema.safeParse(json);
+        if (failed.success &&
+            failed.data.error.code === 'UNAUTHENTICATED' &&
+            !didRefresh &&
+            token &&
+            !path.startsWith('/v1/auth/')) {
+            const ok = await this.refreshOnce();
+            if (ok)
+                return this.request(path, init, true);
+        }
+        if (failed.success) {
+            throw new AppError(failed.data.error.code, failed.data.error.message, res.status, failed.data.error.details);
+        }
+        if (!res.ok) {
+            throw new AppError('INTERNAL', `HTTP ${res.status}`, res.status);
+        }
+        if (typeof json === 'object' && json !== null && 'ok' in json && 'data' in json) {
+            return json.data;
+        }
+        throw new AppError('INTERNAL', 'Malformed response', res.status);
+    }
+    async requestLocation(path) {
+        const fetchImpl = this.opts.fetchImpl ?? fetch;
+        const token = await this.opts.tokenStore.get();
+        const headers = new Headers();
+        headers.set('x-ysk-platform', this.opts.platform);
+        if (token)
+            headers.set('authorization', `Bearer ${token}`);
+        const res = await fetchImpl(`${this.opts.baseUrl}${path}`, {
+            method: 'GET',
+            headers,
+            redirect: 'manual',
+        });
+        if (res.status === 302 || res.status === 301) {
+            const location = res.headers.get('location');
+            if (location)
+                return location;
+        }
+        const json = await res.json().catch(() => null);
+        const failed = ErrSchema.safeParse(json);
+        if (failed.success) {
+            throw new AppError(failed.data.error.code, failed.data.error.message, res.status, failed.data.error.details);
+        }
+        throw new AppError('NOT_FOUND', 'Invoice PDF not found', res.status);
+    }
+    refreshOnce() {
+        if (!this.refreshing) {
+            this.refreshing = this.doRefresh().finally(() => {
+                this.refreshing = null;
+            });
+        }
+        return this.refreshing;
+    }
+    async doRefresh() {
+        const refresh = await this.opts.tokenStore.getRefresh?.();
+        if (!refresh) {
+            await this.opts.tokenStore.clear();
+            return false;
+        }
+        try {
+            const fetchImpl = this.opts.fetchImpl ?? fetch;
+            const res = await fetchImpl(`${this.opts.baseUrl}/v1/auth/refresh`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'x-ysk-platform': this.opts.platform,
+                },
+                body: JSON.stringify({ refreshToken: refresh }),
+            });
+            const json = await res.json();
+            if (typeof json === 'object' &&
+                json !== null &&
+                'ok' in json &&
+                json.ok === true &&
+                'data' in json) {
+                const data = json.data;
+                if (this.opts.tokenStore.setPair) {
+                    await this.opts.tokenStore.setPair(data.accessToken, data.refreshToken);
+                }
+                else {
+                    await this.opts.tokenStore.set(data.accessToken);
+                }
+                await this.opts.onRefreshed?.(data.accessToken, data.refreshToken);
+                return true;
+            }
+        }
+        catch {
+            /* fall through */
+        }
+        await this.opts.tokenStore.clear();
+        return false;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,341 @@
+import type { Platform } from '@ysk-kit/contracts';
+import { connectRealtime } from './realtime';
+import { createWebStorageTokenStore, memoryTokenStore, type TokenStore } from './token-store';
+export declare function createYskClient(opts: {
+    baseUrl: string;
+    platform: Platform;
+    tokenStore?: TokenStore;
+    fetchImpl?: typeof fetch;
+}): {
+    auth: {
+        register: (body: import("@ysk-kit/contracts").RegisterCommand) => Promise<{
+            accessToken: string;
+            refreshToken: string;
+            expiresIn: number;
+            user: {
+                id: string;
+                email: string | null;
+                phone: string | null;
+                displayName: string;
+                role: "USER" | "ADMIN" | "OPS";
+                status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+                createdAt: string;
+            };
+        }>;
+        login: (body: import("@ysk-kit/contracts").LoginPasswordCommand) => Promise<{
+            accessToken: string;
+            refreshToken: string;
+            expiresIn: number;
+            user: {
+                id: string;
+                email: string | null;
+                phone: string | null;
+                displayName: string;
+                role: "USER" | "ADMIN" | "OPS";
+                status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+                createdAt: string;
+            };
+        }>;
+        requestOtp: (body: import("@ysk-kit/contracts").RequestOtpCommand) => Promise<{
+            sent: true;
+        }>;
+        verifyOtp: (body: import("@ysk-kit/contracts").VerifyOtpCommand) => Promise<{
+            accessToken: string;
+            refreshToken: string;
+            expiresIn: number;
+            user: {
+                id: string;
+                email: string | null;
+                phone: string | null;
+                displayName: string;
+                role: "USER" | "ADMIN" | "OPS";
+                status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+                createdAt: string;
+            };
+        }>;
+        refresh: (body: import("@ysk-kit/contracts").RefreshCommand) => Promise<{
+            accessToken: string;
+            refreshToken: string;
+            expiresIn: number;
+            user: {
+                id: string;
+                email: string | null;
+                phone: string | null;
+                displayName: string;
+                role: "USER" | "ADMIN" | "OPS";
+                status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+                createdAt: string;
+            };
+        }>;
+        logout: () => Promise<void>;
+        me: () => Promise<{
+            id: string;
+            email: string | null;
+            phone: string | null;
+            displayName: string;
+            role: "USER" | "ADMIN" | "OPS";
+            status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+            createdAt: string;
+        }>;
+        requestAdminOtp: (body: import("@ysk-kit/contracts").RequestAdminOtpCommand) => Promise<{
+            sent: true;
+        }>;
+        verifyAdminOtp: (body: import("@ysk-kit/contracts").VerifyAdminOtpCommand) => Promise<{
+            accessToken: string;
+            refreshToken: string;
+            expiresIn: number;
+            user: {
+                id: string;
+                email: string | null;
+                phone: string | null;
+                displayName: string;
+                role: "USER" | "ADMIN" | "OPS";
+                status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+                createdAt: string;
+            };
+        }>;
+        forgot: (body: {
+            email: string;
+        }) => Promise<{
+            accepted: true;
+        }>;
+        reset: (body: {
+            token: string;
+            password: string;
+        }) => Promise<{
+            accepted: true;
+        }>;
+    };
+    apiKeys: {
+        list: () => Promise<{
+            id: string;
+            name: string;
+            prefix: string;
+            last4: string;
+            permissions: ("user.create" | "user.suspend" | "audit.read" | "file.upload" | "llm.use" | "billing.checkout")[];
+            createdAt: string;
+            lastUsedAt: string | null;
+        }[]>;
+        create: (body: import("@ysk-kit/contracts").CreateApiKeyCommand) => Promise<{
+            id: string;
+            name: string;
+            prefix: string;
+            last4: string;
+            permissions: ("user.create" | "user.suspend" | "audit.read" | "file.upload" | "llm.use" | "billing.checkout")[];
+            createdAt: string;
+            lastUsedAt: string | null;
+            token: string;
+        }>;
+        revoke: (id: string) => Promise<{
+            revoked: true;
+        }>;
+    };
+    audit: {
+        list: (query?: {
+            cursor?: string;
+            limit?: number;
+        }) => Promise<{
+            items: {
+                id: string;
+                actorId: string | null;
+                action: "user.create" | "user.suspend" | "file.upload" | "auth.register" | "auth.login" | "auth.logout" | "auth.reset" | "org.create" | "org.invite" | "org.member.remove" | "api_key.create" | "api_key.revoke";
+                resourceType: string;
+                resourceId: string;
+                createdAt: string;
+            }[];
+            nextCursor: string | null;
+        }>;
+    };
+    billing: {
+        plans: () => Promise<{
+            code: "free" | "pro";
+            name: string;
+            amountHkdCents: number;
+            interval: "month";
+        }[]>;
+        subscription: (organizationId: string) => Promise<{
+            planCode: "free" | "pro";
+            status: "active" | "canceled";
+            currentPeriodEnd: string | null;
+            seatCount: number;
+        }>;
+        invoices: (organizationId: string) => Promise<{
+            id: string;
+            number: string | null;
+            status: string;
+            amountDue: number;
+            currency: string;
+            hostedInvoiceUrl: string | null;
+            createdAt: string;
+        }[]>;
+        invoicePdfUrl: (id: string, organizationId: string) => Promise<string>;
+        checkout: (body: import("@ysk-kit/contracts").CheckoutCommand) => Promise<{
+            url: string;
+        }>;
+        cancel: (body: import("@ysk-kit/contracts").CancelCommand) => Promise<{
+            canceled: true;
+        }>;
+        portal: (body: import("@ysk-kit/contracts").PortalCommand) => Promise<{
+            url: string;
+        }>;
+    };
+    users: {
+        list: (query?: {
+            cursor?: string;
+            limit?: number;
+        }) => Promise<{
+            items: {
+                id: string;
+                email: string | null;
+                phone: string | null;
+                displayName: string;
+                role: "USER" | "ADMIN" | "OPS";
+                status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+                createdAt: string;
+            }[];
+            nextCursor: string | null;
+        }>;
+        create: (body: import("@ysk-kit/contracts").CreateUserCommand) => Promise<{
+            id: string;
+            email: string | null;
+            phone: string | null;
+            displayName: string;
+            role: "USER" | "ADMIN" | "OPS";
+            status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+            createdAt: string;
+        }>;
+        suspend: (id: string) => Promise<{
+            id: string;
+            email: string | null;
+            phone: string | null;
+            displayName: string;
+            role: "USER" | "ADMIN" | "OPS";
+            status: "ACTIVE" | "INVITED" | "SUSPENDED" | "DELETED";
+            createdAt: string;
+        }>;
+    };
+    notifications: {
+        list: () => Promise<{
+            items: {
+                id: string;
+                type: "auth.reset" | "auth.welcome" | "user.created" | "org.invited";
+                title: string;
+                body: string;
+                readAt: string | null;
+                createdAt: string;
+            }[];
+            nextCursor: string | null;
+        }>;
+        markRead: (id: string) => Promise<{
+            read: true;
+        }>;
+        unread: () => Promise<import("@ysk-kit/contracts").NotificationDto[]>;
+    };
+    devices: {
+        list: () => Promise<{
+            id: string;
+            platform: "ios" | "android";
+            tokenSuffix: string;
+            createdAt: string;
+        }[]>;
+        register: (body: import("@ysk-kit/contracts").RegisterDeviceCommand) => Promise<{
+            id: string;
+            platform: "ios" | "android";
+            tokenSuffix: string;
+            createdAt: string;
+        }>;
+        remove: (id: string) => Promise<{
+            removed: true;
+        }>;
+    };
+    organizations: {
+        create: (body: import("@ysk-kit/contracts").CreateOrganizationCommand) => Promise<{
+            id: string;
+            name: string;
+            createdAt: string;
+        }>;
+        list: () => Promise<{
+            id: string;
+            name: string;
+            createdAt: string;
+        }[]>;
+        get: (organizationId: string) => Promise<{
+            id: string;
+            name: string;
+            createdAt: string;
+        }>;
+        update: (organizationId: string, body: import("@ysk-kit/contracts").UpdateOrganizationCommand) => Promise<{
+            id: string;
+            name: string;
+            createdAt: string;
+        }>;
+        members: (organizationId: string) => Promise<{
+            id: string;
+            organizationId: string;
+            userId: string;
+            email: string | null;
+            displayName: string;
+            role: "ADMIN" | "OWNER" | "MEMBER";
+            createdAt: string;
+        }[]>;
+        invite: (organizationId: string, body: import("@ysk-kit/contracts").InviteMemberCommand) => Promise<{
+            id: string;
+            organizationId: string;
+            email: string;
+            role: "ADMIN" | "MEMBER";
+            createdAt: string;
+            expiresAt: string;
+        }>;
+        invites: (organizationId: string) => Promise<{
+            id: string;
+            organizationId: string;
+            email: string;
+            role: "ADMIN" | "MEMBER";
+            createdAt: string;
+            expiresAt: string;
+        }[]>;
+        revokeInvite: (organizationId: string, id: string) => Promise<{
+            removed: true;
+        }>;
+        removeMember: (organizationId: string, userId: string) => Promise<{
+            removed: true;
+        }>;
+        leave: (organizationId: string) => Promise<{
+            left: true;
+        }>;
+        acceptInvite: (body: import("@ysk-kit/contracts").AcceptInviteCommand) => Promise<{
+            accepted: true;
+        }>;
+    };
+    llm: {
+        complete: (body: import("@ysk-kit/contracts").LlmCompleteCommand) => Promise<{
+            text: string;
+            model: string;
+            usage: {
+                promptTokens: number;
+                completionTokens: number;
+                totalTokens: number;
+            };
+        }>;
+        models: () => Promise<{
+            items: {
+                id: string;
+            }[];
+        }>;
+        stream: (body: import("@ysk-kit/contracts").LlmCompleteCommand, handlers: {
+            onDelta: (delta: string) => void;
+            onDone: (usage?: import("@ysk-kit/contracts").LlmUsage) => void;
+            onError?: (message: string) => void;
+        }) => Promise<void>;
+    };
+    connectRealtime: () => Promise<{
+        on: (event: string, handler: (payload: unknown) => void) => void;
+        close: () => void;
+    }>;
+};
+export type YskClient = ReturnType<typeof createYskClient>;
+export type { DevicePort } from './ports/device';
+export type { FilePickerPort } from './ports/file-picker';
+export type { TokenStore } from './token-store';
+export { connectRealtime, createWebStorageTokenStore, memoryTokenStore };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAU7C,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9F,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAV6D,CAAC;iBACpD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAO,CAAC;iBAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAEkD,CAAC;mBAE9D,CAAC;;;;;;;EA+BzB;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+import { HttpClient } from './http';
+import { connectRealtime } from './realtime';
+import { apiKeysResource } from './resources/api-keys';
+import { auditResource } from './resources/audit';
+import { authResource } from './resources/auth';
+import { billingResource } from './resources/billing';
+import { devicesResource } from './resources/devices';
+import { llmResource } from './resources/llm';
+import { notificationsResource } from './resources/notifications';
+import { organizationsResource } from './resources/organizations';
+import { usersResource } from './resources/users';
+import { createWebStorageTokenStore, memoryTokenStore } from './token-store';
+export function createYskClient(opts) {
+    const tokenStore = opts.tokenStore ?? memoryTokenStore();
+    const baseUrl = opts.baseUrl.replace(/\/$/, '');
+    const http = new HttpClient({
+        baseUrl,
+        platform: opts.platform,
+        tokenStore,
+        ...(opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}),
+    });
+    return {
+        auth: authResource(http, tokenStore),
+        apiKeys: apiKeysResource(http),
+        audit: auditResource(http),
+        billing: billingResource(http),
+        users: usersResource(http),
+        notifications: notificationsResource(http),
+        devices: devicesResource(http),
+        organizations: organizationsResource(http),
+        llm: llmResource(http, {
+            baseUrl,
+            platform: opts.platform,
+            tokenStore,
+            ...(opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}),
+        }),
+        connectRealtime: () => connectRealtime({ baseUrl, platform: opts.platform, tokenStore }),
+    };
+}
+export { connectRealtime, createWebStorageTokenStore, memoryTokenStore };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAmB,MAAM,eAAe,CAAC;AAE9F,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,gBAAgB,EAAE,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;QAC1B,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC;QACpC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC;QAC1B,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC;QAC1B,aAAa,EAAE,qBAAqB,CAAC,IAAI,CAAC;QAC1C,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC;QAC9B,aAAa,EAAE,qBAAqB,CAAC,IAAI,CAAC;QAC1C,GAAG,EAAE,WAAW,CAAC,IAAI,EAAE;YACrB,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;QACF,eAAe,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC;AAMD,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/ports/device.d.ts

@@ -0,0 +1,5 @@
+export interface DevicePort {
+    platform: 'ios' | 'android';
+    registerPushToken(token: string): Promise<void>;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/ports/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/ports/device.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

package/dist/ports/device.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=device.js.map

package/dist/ports/device.js.map

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

package/dist/ports/file-picker.d.ts

@@ -0,0 +1,7 @@
+export interface FilePickerPort {
+    pickImage(): Promise<{
+        uri: string;
+        mime: string;
+    } | null>;
+}
+//# sourceMappingURL=file-picker.d.ts.map

package/dist/ports/file-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-picker.d.ts","sourceRoot":"","sources":["../../src/ports/file-picker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CAC5D"}

package/dist/ports/file-picker.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-picker.js.map

package/dist/ports/file-picker.js.map

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

package/dist/realtime.d.ts

@@ -0,0 +1,11 @@
+import type { Platform } from '@ysk-kit/contracts';
+import type { TokenStore } from './token-store';
+export declare const connectRealtime: (opts: {
+    baseUrl: string;
+    platform: Platform;
+    tokenStore: TokenStore;
+}) => Promise<{
+    on: (event: string, handler: (payload: unknown) => void) => void;
+    close: () => void;
+}>;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAO,MAAM,eAAe,GAAU,MAAM;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;CACxB,KAAG,OAAO,CAAC;IACV,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAcA,CAAC"}

package/dist/realtime.js

@@ -0,0 +1,17 @@
+import { io } from 'socket.io-client';
+export const connectRealtime = async (opts) => {
+    const token = await opts.tokenStore.get();
+    const socket = io(opts.baseUrl, {
+        auth: { token, platform: opts.platform },
+        transports: ['websocket', 'polling'],
+    });
+    return {
+        on: (event, handler) => {
+            socket.on(event, handler);
+        },
+        close: () => {
+            socket.close();
+        },
+    };
+};
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAe,MAAM,kBAAkB,CAAC;AAGnD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAIrC,EAGE,EAAE;IACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAW,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE;QACtC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;QACxC,UAAU,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACrC,CAAC,CAAC;IACH,OAAO;QACL,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACrB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}