@smartcorehub/localization-sdk 1.0.3474

package/LICENSE

@@ -0,0 +1,83 @@
+SMARTCOREHUB SOFTWARE LICENSE / LICENCA DE SOFTWARE SMARTCOREHUB
+
+Copyright (c) 2026 SmartCoreHub. All rights reserved.
+Copyright (c) 2026 SmartCoreHub. Todos os direitos reservados.
+
+================================================================
+PORTUGUES (PT-BR)
+================================================================
+
+1. CONCESSAO PARA USO NAO COMERCIAL
+Fica autorizado, gratuitamente, o uso nao comercial deste software, incluindo
+estudo, avaliacao, testes, desenvolvimento interno e projetos pessoais, desde
+que seja mantido este aviso de direitos autorais e esta licenca.
+
+2. USO COMERCIAL
+Qualquer uso comercial deste software exige autorizacao previa e expressa da
+SmartCoreHub, mediante:
+- aquisicao de licenca comercial valida; ou
+- contratacao de servicos oficiais da SmartCoreHub que incluam o direito de uso.
+
+Sem uma das autorizacoes acima, e proibido usar, distribuir, sublicenciar,
+incorporar, revender, oferecer como servico, ou explorar economicamente este
+software, no todo ou em parte.
+
+3. DEFINICAO DE USO COMERCIAL
+Para esta licenca, considera-se uso comercial qualquer uso direto ou indireto
+com finalidade de lucro, vantagem economica, atividade empresarial, prestacao
+de servicos a terceiros, ou uso em ambiente corporativo para atividade-fim.
+
+4. RESTRICOES GERAIS
+Nao e permitido remover avisos de autoria, copyright, marca ou licenca.
+Qualquer violacao destes termos encerra automaticamente a permissao de uso.
+
+5. ISENCA DE GARANTIAS E RESPONSABILIDADE
+O software e fornecido "no estado em que se encontra", sem garantias de qualquer
+natureza, expressas ou implicitas. Em nenhuma hipotese a SmartCoreHub sera
+responsavel por danos diretos, indiretos, incidentais, especiais, exemplares
+ou consequenciais, decorrentes do uso ou da impossibilidade de uso do software.
+
+6. CONTATO PARA LICENCA COMERCIAL
+Para aquisicao de licenca comercial ou contratacao de servicos, entre em contato
+com a SmartCoreHub pelos canais oficiais.
+
+================================================================
+ENGLISH
+================================================================
+
+1. NON-COMMERCIAL USE GRANT
+You are granted permission, free of charge, to use this software for
+non-commercial purposes, including study, evaluation, testing, internal
+development, and personal projects, provided that this copyright notice
+and this license are preserved.
+
+2. COMMERCIAL USE
+Any commercial use of this software requires prior written authorization
+from SmartCoreHub through:
+- purchase of a valid commercial license; or
+- subscription to official SmartCoreHub services that include usage rights.
+
+Without one of the authorizations above, it is prohibited to use,
+distribute, sublicense, embed, resell, offer as a service, or otherwise
+commercially exploit this software, in whole or in part.
+
+3. DEFINITION OF COMMERCIAL USE
+For the purposes of this license, commercial use means any direct or
+indirect use for profit, economic advantage, business activity, service
+delivery to third parties, or use in a corporate environment for core
+business operations.
+
+4. GENERAL RESTRICTIONS
+You may not remove authorship, copyright, trademark, or license notices.
+Any breach of these terms automatically terminates your right to use this
+software.
+
+5. DISCLAIMER OF WARRANTIES AND LIABILITY
+THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED. IN NO EVENT SHALL SMARTCOREHUB BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF OR IN CONNECTION WITH THE USE OF OR INABILITY TO USE THE SOFTWARE.
+
+6. CONTACT FOR COMMERCIAL LICENSE
+To purchase a commercial license or contract official services, contact
+SmartCoreHub through its official channels.

package/README.md

@@ -0,0 +1,202 @@
+# @smartcorehub/localization-sdk
+
+SDK TypeScript para consumir a API de localizacao da SmartCoreHub em projetos Angular, React, Next.js, Node.js e TypeScript puro.
+
+## O que este pacote entrega
+
+- Cliente tipado para localizacao
+- Autenticacao por header X-Auth-Token
+- Tratamento de erros padronizado
+- Cache configuravel para listagem
+- Integracao Angular via provider e service
+
+## Requisitos
+
+- Node.js 18+
+- npm 9+
+
+## Como instalar o pacote no projeto consumidor
+
+Quando o pacote estiver publicado no npm:
+
+~~~bash
+npm install @smartcorehub/localization-sdk
+~~~
+
+## Primeiro uso rapido (TypeScript, React, Next.js, Node)
+
+~~~ts
+import { createLocalizationClient } from '@smartcorehub/localization-sdk';
+
+const localizationClient = createLocalizationClient({
+	baseUrl: 'https://api.smartcorehub.io/',
+	token: 'SEU_TOKEN',
+	timeoutMs: 10000,
+	cache: {
+		enabled: true,
+		ttlMs: 60000
+	}
+});
+
+const current = await localizationClient.getCurrentLanguage('home.title');
+const byLanguage = await localizationClient.getByLanguage('home.title', 'pt-BR');
+const list = await localizationClient.listResources();
+~~~
+
+## Integracao com Angular
+
+Use o provider para registrar o SDK na injecao de dependencia.
+
+~~~ts
+import { ApplicationConfig } from '@angular/core';
+import { provideLocalization } from '@smartcorehub/localization-sdk';
+
+export const appConfig: ApplicationConfig = {
+	providers: [
+		provideLocalization({
+			baseUrl: 'https://api.smartcorehub.io/',
+			token: 'SEU_TOKEN',
+			cache: { enabled: true, ttlMs: 60000 }
+		})
+	]
+};
+~~~
+
+Consumindo no service/componente Angular:
+
+~~~ts
+import { Component, inject } from '@angular/core';
+import { LocalizationService } from '@smartcorehub/localization-sdk';
+
+@Component({
+	selector: 'app-home-title',
+	template: '{{ title }}'
+})
+export class HomeTitleComponent {
+	private readonly localizationService = inject(LocalizationService);
+	title = '';
+
+	ngOnInit(): void {
+		this.localizationService.getCurrentLanguage('home.title').subscribe((result) => {
+			this.title = result.value;
+		});
+	}
+}
+~~~
+
+## Integracao com React
+
+~~~tsx
+import { useEffect, useState } from 'react';
+import { createLocalizationClient } from '@smartcorehub/localization-sdk';
+
+const client = createLocalizationClient({
+	baseUrl: 'https://api.smartcorehub.io/',
+	token: 'SEU_TOKEN'
+});
+
+export function HomeTitle() {
+	const [title, setTitle] = useState('');
+
+	useEffect(() => {
+		client.getCurrentLanguage('home.title').then((response) => {
+			setTitle(response.value);
+		});
+	}, []);
+
+	return <h1>{title}</h1>;
+}
+~~~
+
+## Integracao com Next.js
+
+Uso recomendado em Server Components, Route Handlers ou Server Actions.
+
+~~~ts
+import { createLocalizationClient } from '@smartcorehub/localization-sdk';
+
+export async function getHomeTitle() {
+	const client = createLocalizationClient({
+		baseUrl: process.env.LOCALIZATION_API_URL ?? '',
+		token: process.env.LOCALIZATION_API_TOKEN ?? ''
+	});
+
+	return client.getCurrentLanguage('home.title');
+}
+~~~
+
+## Tratamento de erros
+
+O SDK mapeia erros HTTP para classes especificas:
+
+- LocalizationAuthError para 401 e 403
+- ResourceNotFoundError para 404
+- LocalizationServerError para 5xx
+- LocalizationTimeoutError para timeout
+- LocalizationNetworkError para erros de rede
+
+~~~ts
+import {
+	LocalizationAuthError,
+	ResourceNotFoundError
+} from '@smartcorehub/localization-sdk';
+
+try {
+	await localizationClient.getCurrentLanguage('home.title');
+} catch (error) {
+	if (error instanceof LocalizationAuthError) {
+		console.error('Token invalido ou sem permissao');
+	}
+
+	if (error instanceof ResourceNotFoundError) {
+		console.error('Recurso nao encontrado');
+	}
+}
+~~~
+
+## Cache configuravel
+
+Por padrao, voce pode usar o MemoryCacheProvider.
+
+~~~ts
+import { createLocalizationClient, MemoryCacheProvider } from '@smartcorehub/localization-sdk';
+
+const client = createLocalizationClient({
+	baseUrl: 'https://api.smartcorehub.io/',
+	token: 'SEU_TOKEN',
+	cache: {
+		enabled: true,
+		provider: new MemoryCacheProvider(),
+		ttlMs: 120000
+	}
+});
+~~~
+
+## Comandos para desenvolvimento do pacote
+
+No diretorio do pacote:
+
+~~~bash
+npm install
+npm run build
+npm test
+~~~
+
+Para detalhes de publicacao em pipeline classico, consulte NPM-PUBLISH-GUIDE.md.
+
+Para automacao completa de CI/CD da publicacao, consulte NPM-AUTOMATION-GUIDE.md.
+
+Para fluxo interno de contribuicao e troubleshooting de desenvolvimento, consulte o arquivo DEVELOPMENT-GUIDE.md.
+
+## Licensing / Licenciamento
+
+### English
+This project is provided for non-commercial use.
+Commercial use requires prior authorization from SmartCoreHub through a valid commercial license purchase or an active service contract.
+See the LICENSE file in this project for full terms.
+
+### Portugues (PT-BR)
+Este projeto e fornecido para uso nao comercial.
+O uso comercial exige autorizacao previa da SmartCoreHub, por meio de aquisicao de licenca comercial valida ou contrato de servico ativo.
+Consulte o arquivo LICENSE deste projeto para os termos completos.
+

package/dist/index.d.mts

@@ -0,0 +1,150 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { Observable } from 'rxjs';
+
+interface AuthProvider {
+    getToken(): Promise<string | null>;
+}
+
+interface CacheProvider {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface HttpRequest {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly query?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+    readonly timeoutMs?: number;
+}
+interface HttpResponse<T> {
+    readonly status: number;
+    readonly headers: Headers;
+    readonly data: T;
+}
+interface SDKMiddleware {
+    onRequest?(request: Request): Promise<Request>;
+    onResponse?(response: Response): Promise<Response>;
+    onError?(error: Error): Promise<void>;
+}
+interface HttpTransport {
+    request<T>(request: HttpRequest): Promise<HttpResponse<T>>;
+}
+
+interface SDKLogger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+interface LocalizationClientOptions {
+    readonly baseUrl: string;
+    readonly token?: string;
+    readonly authProvider?: AuthProvider;
+    readonly timeoutMs?: number;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly middleware?: readonly SDKMiddleware[];
+    readonly fetchFn?: typeof fetch;
+    readonly cache?: {
+        readonly enabled?: boolean;
+        readonly provider?: CacheProvider;
+        readonly ttlMs?: number;
+    };
+    readonly logger?: SDKLogger;
+}
+
+interface ResourceResponse {
+    readonly key: string;
+    readonly value: string;
+    readonly language: string;
+    readonly lastUpdated?: string;
+}
+
+interface LocalizationClient {
+    getCurrentLanguage(resourceKey: string): Promise<ResourceResponse>;
+    getByLanguage(resourceKey: string, languageKey: string): Promise<ResourceResponse>;
+    listResources(): Promise<readonly ResourceResponse[]>;
+    invalidateCache(key?: string): Promise<void>;
+}
+
+declare function createLocalizationClient(options: LocalizationClientOptions): LocalizationClient;
+
+declare class XAuthTokenProvider implements AuthProvider {
+    private readonly token;
+    constructor(token: string);
+    getToken(): Promise<string | null>;
+}
+
+declare class MemoryCacheProvider implements CacheProvider {
+    private readonly store;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
+interface FetchHttpTransportOptions {
+    readonly baseUrl: string;
+    readonly fetchFn?: typeof fetch;
+    readonly defaultHeaders?: Readonly<Record<string, string>>;
+    readonly middleware?: readonly SDKMiddleware[];
+    readonly timeoutMs: number;
+}
+declare class FetchHttpTransport implements HttpTransport {
+    private readonly options;
+    private readonly fetchFn;
+    constructor(options: FetchHttpTransportOptions);
+    request<T>(request: HttpRequest): Promise<HttpResponse<T>>;
+    private resolveUrl;
+    private runRequestMiddleware;
+    private runResponseMiddleware;
+    private runErrorMiddleware;
+    private parseResponse;
+    private toError;
+    private isAbortError;
+}
+
+interface SDKErrorMetadata {
+    readonly requestId?: string;
+    readonly statusCode?: number;
+    readonly traceId?: string;
+    readonly timestamp?: string;
+}
+declare class LocalizationError extends Error {
+    readonly metadata?: SDKErrorMetadata | undefined;
+    constructor(message: string, metadata?: SDKErrorMetadata | undefined);
+}
+declare class LocalizationAuthError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class ResourceNotFoundError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class LocalizationServerError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class LocalizationNetworkError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class LocalizationTimeoutError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+
+declare function provideLocalization(options: LocalizationClientOptions): EnvironmentProviders;
+
+declare class LocalizationService {
+    private readonly client;
+    getCurrentLanguage(resourceKey: string): Observable<ResourceResponse>;
+    getByLanguage(resourceKey: string, languageKey: string): Observable<ResourceResponse>;
+    listResources(): Observable<readonly ResourceResponse[]>;
+    invalidateCache(key?: string): Observable<void>;
+}
+
+declare const LOCALIZATION_SDK_OPTIONS: InjectionToken<LocalizationClientOptions>;
+declare const LOCALIZATION_CLIENT: InjectionToken<LocalizationClient>;
+
+export { type AuthProvider, type CacheProvider, FetchHttpTransport, type HttpRequest, type HttpResponse, type HttpTransport, LOCALIZATION_CLIENT, LOCALIZATION_SDK_OPTIONS, LocalizationAuthError, type LocalizationClient, type LocalizationClientOptions, LocalizationError, LocalizationNetworkError, LocalizationServerError, LocalizationService, LocalizationTimeoutError, MemoryCacheProvider, ResourceNotFoundError, type ResourceResponse, type SDKLogger, type SDKMiddleware, XAuthTokenProvider, createLocalizationClient, provideLocalization };

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+import { EnvironmentProviders, InjectionToken } from '@angular/core';
+import { Observable } from 'rxjs';
+
+interface AuthProvider {
+    getToken(): Promise<string | null>;
+}
+
+interface CacheProvider {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface HttpRequest {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly query?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+    readonly timeoutMs?: number;
+}
+interface HttpResponse<T> {
+    readonly status: number;
+    readonly headers: Headers;
+    readonly data: T;
+}
+interface SDKMiddleware {
+    onRequest?(request: Request): Promise<Request>;
+    onResponse?(response: Response): Promise<Response>;
+    onError?(error: Error): Promise<void>;
+}
+interface HttpTransport {
+    request<T>(request: HttpRequest): Promise<HttpResponse<T>>;
+}
+
+interface SDKLogger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+interface LocalizationClientOptions {
+    readonly baseUrl: string;
+    readonly token?: string;
+    readonly authProvider?: AuthProvider;
+    readonly timeoutMs?: number;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly middleware?: readonly SDKMiddleware[];
+    readonly fetchFn?: typeof fetch;
+    readonly cache?: {
+        readonly enabled?: boolean;
+        readonly provider?: CacheProvider;
+        readonly ttlMs?: number;
+    };
+    readonly logger?: SDKLogger;
+}
+
+interface ResourceResponse {
+    readonly key: string;
+    readonly value: string;
+    readonly language: string;
+    readonly lastUpdated?: string;
+}
+
+interface LocalizationClient {
+    getCurrentLanguage(resourceKey: string): Promise<ResourceResponse>;
+    getByLanguage(resourceKey: string, languageKey: string): Promise<ResourceResponse>;
+    listResources(): Promise<readonly ResourceResponse[]>;
+    invalidateCache(key?: string): Promise<void>;
+}
+
+declare function createLocalizationClient(options: LocalizationClientOptions): LocalizationClient;
+
+declare class XAuthTokenProvider implements AuthProvider {
+    private readonly token;
+    constructor(token: string);
+    getToken(): Promise<string | null>;
+}
+
+declare class MemoryCacheProvider implements CacheProvider {
+    private readonly store;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+
+interface FetchHttpTransportOptions {
+    readonly baseUrl: string;
+    readonly fetchFn?: typeof fetch;
+    readonly defaultHeaders?: Readonly<Record<string, string>>;
+    readonly middleware?: readonly SDKMiddleware[];
+    readonly timeoutMs: number;
+}
+declare class FetchHttpTransport implements HttpTransport {
+    private readonly options;
+    private readonly fetchFn;
+    constructor(options: FetchHttpTransportOptions);
+    request<T>(request: HttpRequest): Promise<HttpResponse<T>>;
+    private resolveUrl;
+    private runRequestMiddleware;
+    private runResponseMiddleware;
+    private runErrorMiddleware;
+    private parseResponse;
+    private toError;
+    private isAbortError;
+}
+
+interface SDKErrorMetadata {
+    readonly requestId?: string;
+    readonly statusCode?: number;
+    readonly traceId?: string;
+    readonly timestamp?: string;
+}
+declare class LocalizationError extends Error {
+    readonly metadata?: SDKErrorMetadata | undefined;
+    constructor(message: string, metadata?: SDKErrorMetadata | undefined);
+}
+declare class LocalizationAuthError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class ResourceNotFoundError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class LocalizationServerError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class LocalizationNetworkError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+declare class LocalizationTimeoutError extends LocalizationError {
+    constructor(message?: string, metadata?: SDKErrorMetadata);
+}
+
+declare function provideLocalization(options: LocalizationClientOptions): EnvironmentProviders;
+
+declare class LocalizationService {
+    private readonly client;
+    getCurrentLanguage(resourceKey: string): Observable<ResourceResponse>;
+    getByLanguage(resourceKey: string, languageKey: string): Observable<ResourceResponse>;
+    listResources(): Observable<readonly ResourceResponse[]>;
+    invalidateCache(key?: string): Observable<void>;
+}
+
+declare const LOCALIZATION_SDK_OPTIONS: InjectionToken<LocalizationClientOptions>;
+declare const LOCALIZATION_CLIENT: InjectionToken<LocalizationClient>;
+
+export { type AuthProvider, type CacheProvider, FetchHttpTransport, type HttpRequest, type HttpResponse, type HttpTransport, LOCALIZATION_CLIENT, LOCALIZATION_SDK_OPTIONS, LocalizationAuthError, type LocalizationClient, type LocalizationClientOptions, LocalizationError, LocalizationNetworkError, LocalizationServerError, LocalizationService, LocalizationTimeoutError, MemoryCacheProvider, ResourceNotFoundError, type ResourceResponse, type SDKLogger, type SDKMiddleware, XAuthTokenProvider, createLocalizationClient, provideLocalization };

package/dist/index.js

@@ -0,0 +1 @@
+'use strict';var core=require('@angular/core'),rxjs=require('rxjs');var re=Object.create;var q=Object.defineProperty;var oe=Object.getOwnPropertyDescriptor;var $=(r,e)=>(e=Symbol[r])?e:Symbol.for("Symbol."+r),v=r=>{throw TypeError(r)};var ne=(r,e,t)=>e in r?q(r,e,{enumerable:true,configurable:true,writable:true,value:t}):r[e]=t;var j=(r,e)=>q(r,"name",{value:e,configurable:true});var V=r=>[,,,re(null)],X=["class","method","getter","setter","accessor","field","value","get","set"],w=r=>r!==void 0&&typeof r!="function"?v("Function expected"):r,ie=(r,e,t,o,n)=>({kind:X[r],name:e,metadata:o,addInitializer:a=>t._?v("Already initialized"):n.push(w(a||null))}),ae=(r,e)=>ne(e,$("metadata"),r[3]),J=(r,e,t,o)=>{for(var n=0,a=r[e>>1],l=a&&a.length;n<l;n++)a[n].call(t);return o},Y=(r,e,t,o,n,a)=>{var s,p,f,i=e&7,m=false,H=0,te=r[H]||(r[H]=[]),u=i&&((n=n.prototype),i<5&&(i>3||!m)&&oe(n,t));j(n,t);for(var N=o.length-1;N>=0;N--)f=ie(i,t,p={},r[3],te),s=(0, o[N])(n,f),p._=1,w(s)&&(n=s);return ae(r,n),u&&q(n,t,u),m?i^4?a:u:n};var g=class{constructor(e){this.token=e;}async getToken(){return this.token?.trim()?this.token:null}};var L=class{constructor(){this.store=new Map;}async get(e){let t=this.store.get(e);return t?t.expiresAt!==void 0&&Date.now()>t.expiresAt?(this.store.delete(e),null):t.value:null}async set(e,t,o){let n=o&&o>0?Date.now()+o:void 0;this.store.set(e,{value:t,expiresAt:n});}async delete(e){this.store.delete(e);}async clear(){this.store.clear();}};var c=class extends Error{constructor(t,o){super(t);this.metadata=o;this.name="LocalizationError";}},C=class extends c{constructor(e="Authentication failed",t){super(e,t),this.name="LocalizationAuthError";}},T=class extends c{constructor(e="Resource not found",t){super(e,t),this.name="ResourceNotFoundError";}},R=class extends c{constructor(e="Localization server error",t){super(e,t),this.name="LocalizationServerError";}},E=class extends c{constructor(e="Network error while contacting localization API",t){super(e,t),this.name="LocalizationNetworkError";}},x=class extends c{constructor(e="Localization request timeout",t){super(e,t),this.name="LocalizationTimeoutError";}};var P=class extends Error{constructor(t,o,n){super(`Request failed with status ${t}`);this.statusCode=t;this.responseBody=o;this.responseHeaders=n;this.name="HttpStatusError";}},z=class extends Error{constructor(t){super(`Request timed out after ${t}ms`);this.timeoutMs=t;this.name="HttpTimeoutError";}},O=class extends Error{constructor(t){super("Network error while sending request");this.causeError=t;this.name="HttpNetworkError";}},A=class{constructor(e){this.options=e;this.fetchFn=e.fetchFn??fetch;}async request(e){let t=e.timeoutMs??this.options.timeoutMs,o=new AbortController,n=setTimeout(()=>o.abort(),t),a=new Request(this.resolveUrl(e),{method:e.method,headers:{"Content-Type":"application/json",...this.options.defaultHeaders,...e.headers},body:e.body===void 0?void 0:JSON.stringify(e.body),signal:o.signal});try{let l=await this.runRequestMiddleware(a),s;try{s=await this.fetchFn(l);}catch(h){throw this.isAbortError(h)?new z(t):new O(h)}let p=await this.runResponseMiddleware(s);if(!p.ok){let h=await p.text();throw new P(p.status,h,p.headers)}let f=await this.parseResponse(p);return {status:p.status,headers:p.headers,data:f}}catch(l){throw await this.runErrorMiddleware(this.toError(l)),l}finally{clearTimeout(n);}}resolveUrl(e){let t=new URL(e.path,this.options.baseUrl);return e.query&&Object.entries(e.query).forEach(([o,n])=>{n!==void 0&&t.searchParams.set(o,String(n));}),t.toString()}async runRequestMiddleware(e){let t=e;for(let o of this.options.middleware??[])o.onRequest&&(t=await o.onRequest(t));return t}async runResponseMiddleware(e){let t=e;for(let o of this.options.middleware??[])o.onResponse&&(t=await o.onResponse(t));return t}async runErrorMiddleware(e){for(let t of this.options.middleware??[])t.onError&&await t.onError(e);}async parseResponse(e){return e.status===204?null:(e.headers.get("content-type")??"").includes("application/json")?await e.json():await e.text()}toError(e){return e instanceof Error?e:new Error("Unknown request error")}isAbortError(e){return e instanceof DOMException&&e.name==="AbortError"}};var Q="localization:listResources",I=class{constructor(e){this.dependencies=e;}async getCurrentLanguage(e){this.validateRequired(e,"resourceKey");let t=await this.send({method:"GET",path:"api/localization/client/currentlanguage",query:{resourceKey:e}});return {key:e,value:t??"",language:"current"}}async getByLanguage(e,t){this.validateRequired(e,"resourceKey"),this.validateRequired(t,"languageKey");let o=await this.send({method:"GET",path:"api/localization/client/bylanguage",query:{resourceKey:e,languageKey:t}});return {key:e,value:o??"",language:t}}async listResources(){let e=await this.dependencies.cacheProvider?.get(Q);if(e)return e;let o=(await this.send({method:"GET",path:"api/localization/client/list"})??[]).map(n=>({key:n.resourceKey,value:n.value,language:n.languageKey}));return await this.dependencies.cacheProvider?.set(Q,o,this.dependencies.cacheTtlMs),o}async invalidateCache(e){if(this.dependencies.cacheProvider){if(e){await this.dependencies.cacheProvider.delete(e);return}await this.dependencies.cacheProvider.clear();}}async send(e){try{let t=await this.dependencies.authProvider?.getToken(),o=t?{...e.headers,"X-Auth-Token":t}:e.headers;return (await this.dependencies.httpTransport.request({...e,headers:o})).data}catch(t){throw this.mapError(t)}}mapError(e){return e instanceof c?e:e instanceof z?new x(e.message):e instanceof O?new E(e.message):e instanceof P?e.statusCode===401||e.statusCode===403?new C("Invalid token for localization endpoint",{statusCode:e.statusCode}):e.statusCode===404?new T("Localization resource was not found",{statusCode:e.statusCode}):e.statusCode>=500?new R("Localization API is unavailable",{statusCode:e.statusCode}):new c(e.message,{statusCode:e.statusCode}):new c("Unexpected localization SDK error")}validateRequired(e,t){if(!e?.trim())throw new c(`${t} is required`)}};function K(r){le(r);let t=r.cache?.enabled??false?r.cache?.provider??new L:void 0,o=new A({baseUrl:r.baseUrl,fetchFn:r.fetchFn,timeoutMs:r.timeoutMs??1e4,defaultHeaders:r.headers,middleware:r.middleware});return new I({httpTransport:o,authProvider:r.authProvider??(r.token?new g(r.token):void 0),cacheProvider:t,cacheTtlMs:r.cache?.ttlMs})}function le(r){if(!r?.baseUrl?.trim())throw new c("baseUrl is required to create localization client")}var _=new core.InjectionToken("LOCALIZATION_SDK_OPTIONS"),b=new core.InjectionToken("LOCALIZATION_CLIENT");function ue(r){return core.makeEnvironmentProviders([{provide:_,useValue:r},{provide:b,useFactory:()=>K(r)}])}var ee,F;ee=[core.Injectable({providedIn:"root"})];exports.LocalizationService=class y{constructor(){this.client=core.inject(b);}getCurrentLanguage(e){return rxjs.from(this.client.getCurrentLanguage(e))}getByLanguage(e,t){return rxjs.from(this.client.getByLanguage(e,t))}listResources(){return rxjs.from(this.client.listResources())}invalidateCache(e){return rxjs.from(this.client.invalidateCache(e))}};F=V(),exports.LocalizationService=Y(F,0,"LocalizationService",ee,exports.LocalizationService),J(F,1,exports.LocalizationService);exports.FetchHttpTransport=A;exports.LOCALIZATION_CLIENT=b;exports.LOCALIZATION_SDK_OPTIONS=_;exports.LocalizationAuthError=C;exports.LocalizationError=c;exports.LocalizationNetworkError=E;exports.LocalizationServerError=R;exports.LocalizationTimeoutError=x;exports.MemoryCacheProvider=L;exports.ResourceNotFoundError=T;exports.XAuthTokenProvider=g;exports.createLocalizationClient=K;exports.provideLocalization=ue;

package/dist/index.mjs

@@ -0,0 +1 @@
+import {InjectionToken,Injectable,makeEnvironmentProviders,inject}from'@angular/core';import {from}from'rxjs';var re=Object.create;var q=Object.defineProperty;var oe=Object.getOwnPropertyDescriptor;var $=(r,e)=>(e=Symbol[r])?e:Symbol.for("Symbol."+r),v=r=>{throw TypeError(r)};var ne=(r,e,t)=>e in r?q(r,e,{enumerable:true,configurable:true,writable:true,value:t}):r[e]=t;var j=(r,e)=>q(r,"name",{value:e,configurable:true});var V=r=>[,,,re(null)],X=["class","method","getter","setter","accessor","field","value","get","set"],w=r=>r!==void 0&&typeof r!="function"?v("Function expected"):r,ie=(r,e,t,o,n)=>({kind:X[r],name:e,metadata:o,addInitializer:a=>t._?v("Already initialized"):n.push(w(a||null))}),ae=(r,e)=>ne(e,$("metadata"),r[3]),J=(r,e,t,o)=>{for(var n=0,a=r[e>>1],l=a&&a.length;n<l;n++)a[n].call(t);return o},Y=(r,e,t,o,n,a)=>{var s,p,f,i=e&7,m=false,H=0,te=r[H]||(r[H]=[]),u=i&&((n=n.prototype),i<5&&(i>3||!m)&&oe(n,t));j(n,t);for(var N=o.length-1;N>=0;N--)f=ie(i,t,p={},r[3],te),s=(0, o[N])(n,f),p._=1,w(s)&&(n=s);return ae(r,n),u&&q(n,t,u),m?i^4?a:u:n};var g=class{constructor(e){this.token=e;}async getToken(){return this.token?.trim()?this.token:null}};var L=class{constructor(){this.store=new Map;}async get(e){let t=this.store.get(e);return t?t.expiresAt!==void 0&&Date.now()>t.expiresAt?(this.store.delete(e),null):t.value:null}async set(e,t,o){let n=o&&o>0?Date.now()+o:void 0;this.store.set(e,{value:t,expiresAt:n});}async delete(e){this.store.delete(e);}async clear(){this.store.clear();}};var c=class extends Error{constructor(t,o){super(t);this.metadata=o;this.name="LocalizationError";}},C=class extends c{constructor(e="Authentication failed",t){super(e,t),this.name="LocalizationAuthError";}},T=class extends c{constructor(e="Resource not found",t){super(e,t),this.name="ResourceNotFoundError";}},R=class extends c{constructor(e="Localization server error",t){super(e,t),this.name="LocalizationServerError";}},E=class extends c{constructor(e="Network error while contacting localization API",t){super(e,t),this.name="LocalizationNetworkError";}},x=class extends c{constructor(e="Localization request timeout",t){super(e,t),this.name="LocalizationTimeoutError";}};var P=class extends Error{constructor(t,o,n){super(`Request failed with status ${t}`);this.statusCode=t;this.responseBody=o;this.responseHeaders=n;this.name="HttpStatusError";}},z=class extends Error{constructor(t){super(`Request timed out after ${t}ms`);this.timeoutMs=t;this.name="HttpTimeoutError";}},O=class extends Error{constructor(t){super("Network error while sending request");this.causeError=t;this.name="HttpNetworkError";}},A=class{constructor(e){this.options=e;this.fetchFn=e.fetchFn??fetch;}async request(e){let t=e.timeoutMs??this.options.timeoutMs,o=new AbortController,n=setTimeout(()=>o.abort(),t),a=new Request(this.resolveUrl(e),{method:e.method,headers:{"Content-Type":"application/json",...this.options.defaultHeaders,...e.headers},body:e.body===void 0?void 0:JSON.stringify(e.body),signal:o.signal});try{let l=await this.runRequestMiddleware(a),s;try{s=await this.fetchFn(l);}catch(h){throw this.isAbortError(h)?new z(t):new O(h)}let p=await this.runResponseMiddleware(s);if(!p.ok){let h=await p.text();throw new P(p.status,h,p.headers)}let f=await this.parseResponse(p);return {status:p.status,headers:p.headers,data:f}}catch(l){throw await this.runErrorMiddleware(this.toError(l)),l}finally{clearTimeout(n);}}resolveUrl(e){let t=new URL(e.path,this.options.baseUrl);return e.query&&Object.entries(e.query).forEach(([o,n])=>{n!==void 0&&t.searchParams.set(o,String(n));}),t.toString()}async runRequestMiddleware(e){let t=e;for(let o of this.options.middleware??[])o.onRequest&&(t=await o.onRequest(t));return t}async runResponseMiddleware(e){let t=e;for(let o of this.options.middleware??[])o.onResponse&&(t=await o.onResponse(t));return t}async runErrorMiddleware(e){for(let t of this.options.middleware??[])t.onError&&await t.onError(e);}async parseResponse(e){return e.status===204?null:(e.headers.get("content-type")??"").includes("application/json")?await e.json():await e.text()}toError(e){return e instanceof Error?e:new Error("Unknown request error")}isAbortError(e){return e instanceof DOMException&&e.name==="AbortError"}};var Q="localization:listResources",I=class{constructor(e){this.dependencies=e;}async getCurrentLanguage(e){this.validateRequired(e,"resourceKey");let t=await this.send({method:"GET",path:"api/localization/client/currentlanguage",query:{resourceKey:e}});return {key:e,value:t??"",language:"current"}}async getByLanguage(e,t){this.validateRequired(e,"resourceKey"),this.validateRequired(t,"languageKey");let o=await this.send({method:"GET",path:"api/localization/client/bylanguage",query:{resourceKey:e,languageKey:t}});return {key:e,value:o??"",language:t}}async listResources(){let e=await this.dependencies.cacheProvider?.get(Q);if(e)return e;let o=(await this.send({method:"GET",path:"api/localization/client/list"})??[]).map(n=>({key:n.resourceKey,value:n.value,language:n.languageKey}));return await this.dependencies.cacheProvider?.set(Q,o,this.dependencies.cacheTtlMs),o}async invalidateCache(e){if(this.dependencies.cacheProvider){if(e){await this.dependencies.cacheProvider.delete(e);return}await this.dependencies.cacheProvider.clear();}}async send(e){try{let t=await this.dependencies.authProvider?.getToken(),o=t?{...e.headers,"X-Auth-Token":t}:e.headers;return (await this.dependencies.httpTransport.request({...e,headers:o})).data}catch(t){throw this.mapError(t)}}mapError(e){return e instanceof c?e:e instanceof z?new x(e.message):e instanceof O?new E(e.message):e instanceof P?e.statusCode===401||e.statusCode===403?new C("Invalid token for localization endpoint",{statusCode:e.statusCode}):e.statusCode===404?new T("Localization resource was not found",{statusCode:e.statusCode}):e.statusCode>=500?new R("Localization API is unavailable",{statusCode:e.statusCode}):new c(e.message,{statusCode:e.statusCode}):new c("Unexpected localization SDK error")}validateRequired(e,t){if(!e?.trim())throw new c(`${t} is required`)}};function K(r){le(r);let t=r.cache?.enabled??false?r.cache?.provider??new L:void 0,o=new A({baseUrl:r.baseUrl,fetchFn:r.fetchFn,timeoutMs:r.timeoutMs??1e4,defaultHeaders:r.headers,middleware:r.middleware});return new I({httpTransport:o,authProvider:r.authProvider??(r.token?new g(r.token):void 0),cacheProvider:t,cacheTtlMs:r.cache?.ttlMs})}function le(r){if(!r?.baseUrl?.trim())throw new c("baseUrl is required to create localization client")}var _=new InjectionToken("LOCALIZATION_SDK_OPTIONS"),b=new InjectionToken("LOCALIZATION_CLIENT");function ue(r){return makeEnvironmentProviders([{provide:_,useValue:r},{provide:b,useFactory:()=>K(r)}])}var ee,F;ee=[Injectable({providedIn:"root"})];var y=class{constructor(){this.client=inject(b);}getCurrentLanguage(e){return from(this.client.getCurrentLanguage(e))}getByLanguage(e,t){return from(this.client.getByLanguage(e,t))}listResources(){return from(this.client.listResources())}invalidateCache(e){return from(this.client.invalidateCache(e))}};F=V(),y=Y(F,0,"LocalizationService",ee,y),J(F,1,y);export{A as FetchHttpTransport,b as LOCALIZATION_CLIENT,_ as LOCALIZATION_SDK_OPTIONS,C as LocalizationAuthError,c as LocalizationError,E as LocalizationNetworkError,R as LocalizationServerError,y as LocalizationService,x as LocalizationTimeoutError,L as MemoryCacheProvider,T as ResourceNotFoundError,g as XAuthTokenProvider,K as createLocalizationClient,ue as provideLocalization};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "description": "TypeScript SDK for SmartCoreHub localization API",
+  "license": "SEE LICENSE IN LICENSE",
+  "scripts": {
+    "lint": "eslint src/**/*.ts",
+    "version:auto": "node ./scripts/auto-version.cjs",
+    "prebuild": "npm run version:auto",
+    "build": "tsup",
+    "prebuild:prod": "npm run version:auto",
+    "build:prod": "tsup --config tsup.config.prod.ts",
+    "test": "jest --config jest.config.js"
+  },
+  "main": "./dist/index.js",
+  "name": "@smartcorehub/localization-sdk",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.0.3474",
+  "devDependencies": {
+    "@angular/core": "^20.3.15",
+    "@angular/common": "^20.3.15",
+    "@angular/compiler": "^20.3.15",
+    "@angular/compiler-cli": "^20.3.15",
+    "@angular/platform-browser": "^20.3.15",
+    "@angular/platform-browser-dynamic": "^20.3.15",
+    "jest-preset-angular": "^16.0.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "jest-html-reporter": "^4.4.0",
+    "jest-html-reporters": "^3.1.7",
+    "jest": "^30.2.0",
+    "jest-junit": "^16.0.0",
+    "jest-sonar": "^0.2.16",
+    "jest-stare": "^2.5.3",
+    "@types/jest": "^30.0.0",
+    "ts-jest": "^29.0.0",
+    "rxjs": "^7.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "whatwg-fetch": "^3.6.20",
+    "zone.js": "~0.15.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=16",
+    "rxjs": ">=7"
+  },
+  "peerDependenciesMeta": {
+    "@angular/core": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  },
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts"
+}