@tapizlabs/sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to `@tapizlabs/sdk` will be documented here.
+
+## 0.1.0
+
+- Initial publish-ready SDK package.
+- Added framework-agnostic Tapiz API resources.
+- Added runtime config, adapters, public entrypoints, contracts and error handling.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tapiz Labs
+
+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/README.md

@@ -0,0 +1,288 @@
+# @tapizlabs/sdk
+
+Framework-agnostic TypeScript SDK for Tapiz frontends.
+
+The SDK contains API clients, contracts, error handling and runtime configuration for Tapiz services. It does not depend on React, Angular, Vue, or any UI framework.
+
+## Install
+
+```bash
+npm install @tapizlabs/sdk
+```
+
+For local development next to `tapiz-reactjs-ui`:
+
+```json
+{
+  "dependencies": {
+    "@tapizlabs/sdk": "file:../tapiz-sdk"
+  }
+}
+```
+
+
+## Publish workflow
+
+This package is ready for public npm publishing.
+
+```bash
+npm ci
+npm run typecheck
+npm test
+npm run build
+npm run pack:check
+npm publish --access public
+```
+
+For scoped public npm packages, the package uses:
+
+```json
+{
+  "publishConfig": {
+    "access": "public"
+  }
+}
+```
+
+Release version helpers:
+
+```bash
+npm run release:patch
+npm run release:minor
+npm run release:major
+```
+
+Then push the tag and publish through GitHub Releases or run `npm publish --access public` locally.
+
+## Local development with tapiz-reactjs-ui
+
+For day-to-day development, `tapiz-reactjs-ui` can use your local SDK checkout instead of the published npm version:
+
+```bash
+cd ../tapiz-reactjs-ui
+npm run sdk:use-local
+npm install
+```
+
+Because a `file:../tapiz-sdk` dependency reads the built SDK output, keep this running in a second terminal while editing SDK source:
+
+```bash
+cd ../tapiz-sdk
+npm run dev:watch
+```
+
+When you want `tapiz-reactjs-ui` to consume the published package again:
+
+```bash
+cd ../tapiz-reactjs-ui
+npm run sdk:use-registry
+npm install
+```
+
+## Configure
+
+```ts
+// src/lib/env.ts
+const raw = import.meta.env;
+export const env = {
+  restApiUrl: raw.VITE_TAPIZ_REST_API_URL as string,
+  excelApiUrl: raw.VITE_TAPIZ_EXCEL_API_URL as string,
+  pdfApiUrl: raw.VITE_TAPIZ_PDF_API_URL as string,
+  prodUrl: raw.VITE_TAPIZ_PROD_URL as string | undefined,
+  devEnv: raw.VITE_TAPIZ_DEV_ENV as string | undefined,
+  qrExpirySeconds: raw.VITE_TAPIZ_QR_EXPIRY_SECONDS as string | undefined,
+};
+
+// src/lib/tapizSdk.ts
+import { createTapizSdk } from "@tapizlabs/sdk";
+import { env } from "./env";
+
+export const tapiz = createTapizSdk({
+  baseUrls: {
+    restApi: env.restApiUrl,
+    excelApi: env.excelApiUrl,
+    pdfApi: env.pdfApiUrl,
+    prodUrl: env.prodUrl,
+  },
+  runtime: {
+    devEnv: env.devEnv,
+    qrExpirySeconds: env.qrExpirySeconds,
+  },
+});
+```
+
+You can also configure once and import resource clients directly:
+
+```ts
+import { configureTapizSdk } from "@tapizlabs/sdk/config";
+import { authService } from "@tapizlabs/sdk/auth";
+
+configureTapizSdk({
+  baseUrls: {
+    restApi: "https://api.tapiz.rs/api",
+    excelApi: "https://tapiz-excel-api.vercel.app",
+    pdfApi: "https://tapiz-pdf-api.vercel.app",
+  },
+});
+
+await authService.login("demo@example.com", "password");
+```
+
+## Public imports
+
+Prefer public SDK entrypoints instead of deep file paths:
+
+```ts
+import { authService } from "@tapizlabs/sdk/auth";
+import { subjectService } from "@tapizlabs/sdk/subjects";
+import { scoreSheetService, excelService } from "@tapizlabs/sdk/score-sheets";
+import { documentService, downloadDocumentPdf } from "@tapizlabs/sdk/documents";
+import apiClient from "@tapizlabs/sdk/client";
+import type { TapizSdkConfig } from "@tapizlabs/sdk/config";
+```
+
+Available resource entrypoints include:
+
+```txt
+@tapizlabs/sdk/activity-log
+@tapizlabs/sdk/admin
+@tapizlabs/sdk/analytics
+@tapizlabs/sdk/attendance
+@tapizlabs/sdk/audit
+@tapizlabs/sdk/auth
+@tapizlabs/sdk/dashboard
+@tapizlabs/sdk/documents
+@tapizlabs/sdk/drafts
+@tapizlabs/sdk/faculty-manager
+@tapizlabs/sdk/forms
+@tapizlabs/sdk/grades
+@tapizlabs/sdk/knowledge
+@tapizlabs/sdk/license
+@tapizlabs/sdk/materials
+@tapizlabs/sdk/news
+@tapizlabs/sdk/notifications
+@tapizlabs/sdk/office-hours
+@tapizlabs/sdk/plan
+@tapizlabs/sdk/posts
+@tapizlabs/sdk/reports
+@tapizlabs/sdk/score-sheets
+@tapizlabs/sdk/settings
+@tapizlabs/sdk/students
+@tapizlabs/sdk/subjects
+@tapizlabs/sdk/todos
+```
+
+## React example
+
+```ts
+// src/lib/tapiz.ts
+import { createTapizSdk } from "@tapizlabs/sdk";
+import { env } from "./env";
+
+export const tapiz = createTapizSdk({
+  baseUrls: {
+    restApi: env.restApiUrl,
+    excelApi: env.excelApiUrl,
+    pdfApi: env.pdfApiUrl,
+    prodUrl: env.prodUrl,
+  },
+  runtime: {
+    devEnv: env.devEnv,
+    qrExpirySeconds: env.qrExpirySeconds,
+  },
+});
+```
+
+```ts
+import { useMutation } from "@tanstack/react-query";
+import { tapiz } from "../../lib/tapiz";
+
+export function useLogin() {
+  return useMutation({
+    mutationFn: ({ email, password }: { email: string; password: string }) =>
+      tapiz.auth.login(email, password),
+  });
+}
+```
+
+## Angular example
+
+```ts
+// app/tapiz-api.service.ts
+import { Injectable } from "@angular/core";
+import { from } from "rxjs";
+import { createTapizSdk } from "@tapizlabs/sdk";
+
+const tapiz = createTapizSdk({
+  baseUrls: {
+    restApi: "https://api.tapiz.rs/api",
+    excelApi: "https://tapiz-excel-api.vercel.app",
+    pdfApi: "https://tapiz-pdf-api.vercel.app",
+  },
+});
+
+@Injectable({ providedIn: "root" })
+export class TapizApiService {
+  login(email: string, password: string) {
+    return from(tapiz.auth.login(email, password));
+  }
+
+  getSubjects() {
+    return from(tapiz.subjects.getAll());
+  }
+}
+```
+
+## Runtime adapters
+
+Browser adapters are provided by default. For SSR, tests, or non-browser runtimes, pass explicit adapters:
+
+```ts
+createTapizSdk({
+  baseUrls: {
+    restApi: "https://api.tapiz.rs/api",
+    excelApi: "https://tapiz-excel-api.vercel.app",
+    pdfApi: "https://tapiz-pdf-api.vercel.app",
+  },
+  storage: {
+    getItem: (key) => memory.get(key) ?? null,
+    setItem: (key, value) => memory.set(key, value),
+    removeItem: (key) => memory.delete(key),
+  },
+  events: {
+    dispatch: (eventName) => console.info("Tapiz event", eventName),
+  },
+  downloads: {
+    downloadBlob: async (blob, filename) => {
+      // SSR/test/desktop-specific file handling goes here.
+    },
+  },
+});
+```
+
+## Error handling
+
+Axios errors are normalized into `TapizApiError` by the SDK client.
+
+```ts
+import { TapizApiError } from "@tapizlabs/sdk/errors";
+
+try {
+  await tapiz.subjects.getAll();
+} catch (error) {
+  if (error instanceof TapizApiError) {
+    console.error(error.status, error.code, error.message, error.details);
+  }
+}
+```
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+`prepublishOnly` runs typecheck and build before publishing.

package/dist/adapters/defaultAdapters.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedTapizSdkConfig } from "../config/sdkConfig";
+export declare const createBrowserStorageAdapter: () => ResolvedTapizSdkConfig["storage"];
+export declare const createBrowserEventAdapter: () => ResolvedTapizSdkConfig["events"];
+export declare const createBrowserDownloadAdapter: () => ResolvedTapizSdkConfig["downloads"];
+//# sourceMappingURL=defaultAdapters.d.ts.map

package/dist/adapters/defaultAdapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultAdapters.d.ts","sourceRoot":"","sources":["../../src/adapters/defaultAdapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,eAAO,MAAM,2BAA2B,QAAO,sBAAsB,CAAC,SAAS,CAI7E,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAAO,sBAAsB,CAAC,QAAQ,CAM1E,CAAC;AAEH,eAAO,MAAM,4BAA4B,QAAO,sBAAsB,CAAC,WAAW,CAehF,CAAC"}

package/dist/adapters/defaultAdapters.js

@@ -0,0 +1,30 @@
+const safeWindow = () => (typeof window === "undefined" ? undefined : window);
+export const createBrowserStorageAdapter = () => ({
+    getItem: (key) => safeWindow()?.localStorage?.getItem(key) ?? null,
+    setItem: (key, value) => safeWindow()?.localStorage?.setItem(key, value),
+    removeItem: (key) => safeWindow()?.localStorage?.removeItem(key),
+});
+export const createBrowserEventAdapter = () => ({
+    dispatch: (eventName) => {
+        const w = safeWindow();
+        if (!w)
+            return;
+        w.dispatchEvent(new Event(eventName));
+    },
+});
+export const createBrowserDownloadAdapter = () => ({
+    downloadBlob: (blob, filename) => {
+        const w = safeWindow();
+        const d = typeof document === "undefined" ? undefined : document;
+        if (!w || !d) {
+            throw new Error("[tapiz-sdk] No download adapter is available in this runtime.");
+        }
+        const objectUrl = w.URL.createObjectURL(blob);
+        const anchor = d.createElement("a");
+        anchor.href = objectUrl;
+        anchor.download = filename;
+        anchor.click();
+        w.URL.revokeObjectURL(objectUrl);
+    },
+});
+//# sourceMappingURL=defaultAdapters.js.map

package/dist/adapters/defaultAdapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultAdapters.js","sourceRoot":"","sources":["../../src/adapters/defaultAdapters.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAsC,EAAE,CAAC,CAAC;IACnF,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI;IAClE,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;IACxE,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAqC,EAAE,CAAC,CAAC;IAChF,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,CAAC,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAwC,EAAE,CAAC,CAAC;IACtF,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC/B,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;QACxB,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/client/apiClient.d.ts

@@ -0,0 +1,4 @@
+declare const apiClient: import("axios").AxiosInstance;
+export declare function ensureFreshToken(): Promise<string | null>;
+export default apiClient;
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/client/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/client/apiClient.ts"],"names":[],"mappings":"AAsFA,QAAA,MAAM,SAAS,+BAEb,CAAC;AA2BH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG/D;AAED,eAAe,SAAS,CAAC"}

package/dist/client/apiClient.js

@@ -0,0 +1,103 @@
+import axios from "axios";
+import { jwtDecode } from "jwt-decode";
+import { getTapizSdkConfig } from "../config/sdkConfig";
+import { toTapizApiError } from "../errors/TapizApiError";
+import { storedAuthUserSchema } from "../models/auth/authUserSchema";
+let refreshInFlight = null;
+const isAuthEndpoint = (url) => getTapizSdkConfig().auth.authEndpoints.some((endpoint) => url?.includes(endpoint));
+const getStoredToken = () => {
+    const { storage, auth } = getTapizSdkConfig();
+    return storage.getItem(auth.tokenStorageKey);
+};
+const removeStoredAuthState = () => {
+    const { storage, events, auth } = getTapizSdkConfig();
+    storage.removeItem(auth.tokenStorageKey);
+    storage.removeItem(auth.userStorageKey);
+    storage.removeItem(auth.facultyLogoUrlStorageKey);
+    events.dispatch(auth.authUpdatedEventName);
+};
+async function tryRefreshToken() {
+    const { storage, events, auth, baseUrls } = getTapizSdkConfig();
+    const token = storage.getItem(auth.tokenStorageKey);
+    if (!token)
+        return null;
+    try {
+        const { exp, role } = jwtDecode(token);
+        const secondsLeft = exp - Date.now() / 1000;
+        if (secondsLeft <= 0)
+            return null;
+        if (role && !auth.refreshableRoles.includes(role))
+            return token;
+        if (secondsLeft > auth.refreshThresholdSeconds)
+            return token;
+    }
+    catch {
+        return null;
+    }
+    if (!refreshInFlight) {
+        refreshInFlight = axios
+            .post(`${baseUrls.restApi}/auth/refresh`, {}, { headers: { Authorization: `Bearer ${storage.getItem(auth.tokenStorageKey)}` } })
+            .then((res) => {
+            const newToken = res.data.token;
+            storage.setItem(auth.tokenStorageKey, newToken);
+            if (res.data.facultyLogoUrl != null) {
+                storage.setItem(auth.facultyLogoUrlStorageKey, res.data.facultyLogoUrl);
+            }
+            const stored = storage.getItem(auth.userStorageKey);
+            if (stored) {
+                try {
+                    const parsedUser = storedAuthUserSchema.safeParse(JSON.parse(stored));
+                    if (parsedUser.success) {
+                        storage.setItem(auth.userStorageKey, JSON.stringify({ ...parsedUser.data, token: newToken }));
+                    }
+                    else {
+                        storage.removeItem(auth.userStorageKey);
+                    }
+                }
+                catch {
+                    storage.removeItem(auth.userStorageKey);
+                }
+            }
+            events.dispatch(auth.authUpdatedEventName);
+            return newToken;
+        })
+            .catch(() => {
+            removeStoredAuthState();
+            return null;
+        })
+            .finally(() => {
+            refreshInFlight = null;
+        });
+    }
+    return refreshInFlight;
+}
+const apiClient = axios.create({
+    headers: { "Content-Type": "application/json" },
+});
+apiClient.interceptors.request.use(async (config) => {
+    config.baseURL = config.baseURL ?? getTapizSdkConfig().baseUrls.restApi;
+    if (isAuthEndpoint(config.url)) {
+        const token = getStoredToken();
+        if (token)
+            config.headers.Authorization = `Bearer ${token}`;
+        return config;
+    }
+    const freshToken = await tryRefreshToken();
+    if (freshToken)
+        config.headers.Authorization = `Bearer ${freshToken}`;
+    return config;
+});
+apiClient.interceptors.response.use((res) => res, (err) => {
+    const url = err.config?.url;
+    const isSafe = getTapizSdkConfig().auth.safe401Endpoints.some((safeEndpoint) => url?.includes(safeEndpoint));
+    if (err.response?.status === 401 && !isAuthEndpoint(url) && !isSafe) {
+        removeStoredAuthState();
+    }
+    return Promise.reject(toTapizApiError(err));
+});
+export async function ensureFreshToken() {
+    const fresh = await tryRefreshToken();
+    return fresh ?? getStoredToken();
+}
+export default apiClient;
+//# sourceMappingURL=apiClient.js.map

package/dist/client/apiClient.js.map

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

package/dist/config/sdkConfig.d.ts

@@ -0,0 +1,72 @@
+export interface TapizSdkConfig {
+    baseUrls: {
+        restApi: string;
+        excelApi: string;
+        pdfApi: string;
+        prodUrl?: string;
+    };
+    runtime?: {
+        devEnv?: string;
+        qrExpirySeconds?: string;
+    };
+    auth?: {
+        refreshThresholdSeconds?: number;
+        refreshableRoles?: readonly string[];
+        authEndpoints?: readonly string[];
+        safe401Endpoints?: readonly string[];
+        tokenStorageKey?: string;
+        userStorageKey?: string;
+        facultyLogoUrlStorageKey?: string;
+        authUpdatedEventName?: string;
+    };
+    scoreSheets?: {
+        maxVersions?: number;
+        localVersionStorageKeyPrefix?: string;
+        autoVersionCreatedByName?: string;
+    };
+    storage?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+        removeItem(key: string): void;
+    };
+    events?: {
+        dispatch(eventName: string): void;
+    };
+    downloads?: {
+        downloadBlob(blob: Blob, filename: string): void;
+    };
+}
+export type ResolvedTapizSdkConfig = {
+    baseUrls: {
+        restApi: string;
+        excelApi: string;
+        pdfApi: string;
+        prodUrl?: string;
+    };
+    runtime: {
+        devEnv?: string;
+        qrExpirySeconds?: string;
+    };
+    auth: {
+        refreshThresholdSeconds: number;
+        refreshableRoles: readonly string[];
+        authEndpoints: readonly string[];
+        safe401Endpoints: readonly string[];
+        tokenStorageKey: string;
+        userStorageKey: string;
+        facultyLogoUrlStorageKey: string;
+        authUpdatedEventName: string;
+    };
+    scoreSheets: {
+        maxVersions: number;
+        localVersionStorageKeyPrefix: string;
+        autoVersionCreatedByName: string;
+    };
+    storage: NonNullable<TapizSdkConfig["storage"]>;
+    events: NonNullable<TapizSdkConfig["events"]>;
+    downloads: NonNullable<TapizSdkConfig["downloads"]>;
+};
+export declare function configureTapizSdk(config: TapizSdkConfig): void;
+export declare function getTapizSdkConfig(): ResolvedTapizSdkConfig;
+export declare function resetTapizSdkConfigForTests(): void;
+//# sourceMappingURL=sdkConfig.d.ts.map

package/dist/config/sdkConfig.d.ts.map

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

package/dist/config/sdkConfig.js

@@ -0,0 +1,91 @@
+import { createBrowserDownloadAdapter, createBrowserEventAdapter, createBrowserStorageAdapter, } from "../adapters/defaultAdapters";
+const defaultSdkConfig = {
+    runtime: {},
+    auth: {
+        refreshThresholdSeconds: 30 * 60,
+        refreshableRoles: ["assistant", "student"],
+        authEndpoints: [
+            "/auth/login",
+            "/auth/refresh",
+            "/auth/register",
+            "/auth/verify-2fa",
+            "/auth/admin/totp/init",
+            "/auth/admin/totp/confirm",
+        ],
+        safe401Endpoints: ["/auth/2fa/totp/confirm"],
+        tokenStorageKey: "token",
+        userStorageKey: "user",
+        facultyLogoUrlStorageKey: "facultyLogoUrl",
+        authUpdatedEventName: "auth-updated",
+    },
+    scoreSheets: {
+        maxVersions: 30,
+        localVersionStorageKeyPrefix: "sheet_versions",
+        autoVersionCreatedByName: "Auto",
+    },
+    storage: createBrowserStorageAdapter(),
+    events: createBrowserEventAdapter(),
+    downloads: createBrowserDownloadAdapter(),
+};
+let configuredSdkConfig = null;
+function assertBaseUrl(name, value) {
+    if (!value) {
+        throw new Error(`[tapiz-sdk] Missing required SDK base URL: baseUrls.${name}. Call configureTapizSdk(...) or createTapizSdk(...) before using API services.`);
+    }
+    return value;
+}
+export function configureTapizSdk(config) {
+    configuredSdkConfig = {
+        ...(configuredSdkConfig ?? {}),
+        ...config,
+        baseUrls: {
+            ...(configuredSdkConfig?.baseUrls ?? {}),
+            ...config.baseUrls,
+        },
+        runtime: {
+            ...(configuredSdkConfig?.runtime ?? {}),
+            ...config.runtime,
+        },
+        auth: {
+            ...(configuredSdkConfig?.auth ?? {}),
+            ...config.auth,
+        },
+        scoreSheets: {
+            ...(configuredSdkConfig?.scoreSheets ?? {}),
+            ...config.scoreSheets,
+        },
+        storage: config.storage ?? configuredSdkConfig?.storage,
+        events: config.events ?? configuredSdkConfig?.events,
+        downloads: config.downloads ?? configuredSdkConfig?.downloads,
+    };
+}
+export function getTapizSdkConfig() {
+    const baseUrls = configuredSdkConfig?.baseUrls;
+    return {
+        baseUrls: {
+            restApi: assertBaseUrl("restApi", baseUrls?.restApi),
+            excelApi: assertBaseUrl("excelApi", baseUrls?.excelApi),
+            pdfApi: assertBaseUrl("pdfApi", baseUrls?.pdfApi),
+            prodUrl: baseUrls?.prodUrl,
+        },
+        runtime: {
+            ...defaultSdkConfig.runtime,
+            ...configuredSdkConfig?.runtime,
+        },
+        auth: {
+            ...defaultSdkConfig.auth,
+            ...configuredSdkConfig?.auth,
+        },
+        scoreSheets: {
+            ...defaultSdkConfig.scoreSheets,
+            ...configuredSdkConfig?.scoreSheets,
+        },
+        storage: configuredSdkConfig?.storage ?? defaultSdkConfig.storage,
+        events: configuredSdkConfig?.events ?? defaultSdkConfig.events,
+        downloads: configuredSdkConfig?.downloads ?? defaultSdkConfig.downloads,
+    };
+}
+export function resetTapizSdkConfigForTests() {
+    configuredSdkConfig = null;
+}
+//# sourceMappingURL=sdkConfig.js.map

package/dist/config/sdkConfig.js.map

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

package/dist/constants/SessionTypes.d.ts

@@ -0,0 +1,6 @@
+export type SessionType = "Predavanja" | "Računarske vežbe" | "Auditorne vežbe" | "Laboratorijske vežbe" | "Konsultacije";
+export declare const ALL_SESSION_TYPES: SessionType[];
+export declare const TYPE_COLORS: Record<SessionType, string>;
+export declare const TYPE_ACTIVE_COLORS: Record<SessionType, string>;
+export declare const TYPE_DOT_LEGEND: Record<SessionType, string>;
+//# sourceMappingURL=SessionTypes.d.ts.map

package/dist/constants/SessionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTypes.d.ts","sourceRoot":"","sources":["../../src/constants/SessionTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,sBAAsB,GACtB,cAAc,CAAC;AAEnB,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAM1C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMnD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAM1D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMvD,CAAC"}