@skill3/sdk-angular 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,103 @@
-# Temporary Holding Version
+# @skill3/sdk-angular
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Angular client ของ Skill3 API (**ตัวต่อจาก `@digione/ngx-core`**): ยืนยัน site จากโดเมน (`X-Client-Site`), เข้าสู่ระบบผู้ใช้พร้อมต่ออายุ token อัตโนมัติ, และเรียก REST endpoint ใดก็ได้
+logic อยู่ใน `@skill3/sdk-core` แพ็กเกจนี้เพิ่ม `provideSkill3()`, service ที่ `inject()` ได้ พร้อม signal / observable และส่ง request ผ่าน `HttpClient` ของแอป
+
+ย้ายจาก ngx-core ดู `docs/migration/ngx-core-to-sdk-angular.md` ใน repo (storage key เดิม ผู้ใช้ไม่หลุด login)
+
+## ติดตั้ง
+
+```bash
+npm install @skill3/sdk-angular   # ติดตั้ง @skill3/sdk-core ให้ด้วย
+```
+
+peer dependency: `@angular/core`, `@angular/common` 22, `rxjs` ^7.4
+
+## ตั้งค่า
+
+```ts
+// app.config.ts
+import { provideHttpClient, withFetch } from '@angular/common/http';
+import { provideLocalStorage, provideSkill3 } from '@skill3/sdk-angular';
+import { environment } from '../environments/environment';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideHttpClient(withFetch()),   // แนะนำ (SSR); request ของ SDK วิ่งผ่าน HttpClient + interceptor ของแอป
+    provideSkill3({
+      scope: 'site',                  // 'site' | 'organ' | 'core' (ค่าเริ่มต้น 'organ')
+      environment,                    // apiUrl, apiUrls, apiUrlSystem, customApiUrl, defaultDomain, production, isMobile, authDomainOption
+      storage: provideLocalStorage(), // ค่าเริ่มต้นคือเก็บใน memory (หายเมื่อ reload)
+    }),
+  ],
+};
+```
+
+option เหมือน `provideDigione` ของ ngx-core ทุกตัว (ตารางเต็มใน README ของ core) และเพิ่ม:
+
+| option | ความหมาย |
+|---|---|
+| `isServer` | ค่าเริ่มต้นตรวจจาก `PLATFORM_ID` |
+| `useHttpClient` | ค่าเริ่มต้น `true`: ส่งผ่าน `HttpClient` (interceptor, XSRF, SSR transfer cache) · `false` → `fetch` ตรง |
+| `fetch`, `hostname` | เหมือน core (`hostname` ค่าเริ่มต้นจาก `DOCUMENT`) |
+
+### config ที่ต้อง inject ค่าอื่น (เช่น SSR)
+
+```ts
+provideSkill3(
+  () => ({ scope: 'site', environment, tokenRef: inject(REQUEST_TOKEN_REF), site: inject(REQUEST_SITE) }),
+  provideLocalStorage(), // storage ใส่เป็น argument ที่ 2 เมื่อใช้ factory
+);
+```
+
+### SSR
+
+- ทุก request ลงทะเบียน `PendingTasks` → SSR (zoneless) รอข้อมูลก่อน render
+- request ส่ง credentials เสมอ transfer cache ของ Angular จึงข้ามเป็นค่าเริ่มต้น (browser ยิงซ้ำหลัง hydrate) ถ้าไม่อยากยิงซ้ำ:
+
+```ts
+provideClientHydration(withHttpTransferCacheOptions({ includeRequestsWithCredentials: true }))
+```
+
+### Ionic Storage
+
+```ts
+import { Storage } from '@ionic/storage-angular';
+
+provideSkill3({ scope: 'site', environment, storage: provideCustomStorage(() => inject(Storage)) }),
+provideAppInitializer(() => inject(Storage).create()), // ต้อง create ก่อนมี request แรก
+```
+
+## ใช้งาน
+
+```ts
+const site = inject(CoreSiteService);
+const auth = inject(AuthService);
+const custom = inject(CustomService);
+
+await site.authDomain(location.hostname, { include: { setting: true } });
+
+const { data, total } = await custom.fetch.get('sites/web_languages', { query: { lang_code: 'th' } });
+const res = await custom.fetch.post('site/carts', { data: { product_id: 15, qty: 1 } }); // Skill3Response
+
+await auth.signInWithEmail(email, password);
+auth.user();          // signal
+auth.user$;           // observable (ส่งค่าปัจจุบันตอน subscribe)
+site.siteReady();     // signal
+site.onSiteTokenRenew().subscribe(() => {}); // ทุกครั้งที่ต่ออายุ site token อัตโนมัติเสร็จ
+await auth.signOut();
+```
+
+| เรียก | ได้ |
+|---|---|
+| `fetch.get` (ไม่ใส่ `single`) | `{ data, total: number \| null, headers }` (204 → `{ data: [], total: null, headers }`) |
+| `fetch.get(..., { single: true })`, `profile().object()` | body (204 → `null`) |
+| `fetch.post/put/delete`, `profile().create/update/delete/stream`, `signUpWithEmail`, `deleteAccount` | `Skill3Response` (`status`, `headers`, `body`, `url`) |
+
+error เป็น `Skill3HttpError` (`status`, `error` = body, `headers`) · `errorCode(err)` อ่าน code ของ API เหมือนเดิม
+
+interceptor ของแอปที่อ่าน **response body** ของ request จาก SDK จะเห็นเป็น `ArrayBuffer` (SDK parse เอง) interceptor ที่แก้ request / header / จับ error ไม่กระทบ
+
+## พัฒนา SDK
+
+ดู `CLAUDE.md` และ `docs/ARCHITECTURE.md` ใน repo

package/dist/index.cjs

@@ -0,0 +1,243 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthService: () => AuthService,
+  CoreSiteService: () => CoreSiteService,
+  SKILL3_CLIENT: () => SKILL3_CLIENT,
+  SKILL3_CONFIG: () => SKILL3_CONFIG,
+  StorageProvider: () => StorageProvider,
+  httpClientFetch: () => httpClientFetch,
+  provideCustomStorage: () => provideCustomStorage,
+  provideLocalStorage: () => provideLocalStorage,
+  provideSkill3: () => provideSkill3,
+  valueToObservable: () => valueToObservable,
+  valueToSignal: () => valueToSignal
+});
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("@skill3/sdk-core"), module.exports);
+
+// src/provide.ts
+var import_core3 = require("@angular/core");
+var import_common2 = require("@angular/common");
+var import_http2 = require("@angular/common/http");
+var import_sdk_core4 = require("@skill3/sdk-core");
+
+// src/http-client-fetch.ts
+var import_http = require("@angular/common/http");
+function httpClientFetch(http) {
+  return (input, init = {}) => new Promise((resolve, reject) => {
+    const signal2 = init.signal;
+    if (signal2?.aborted) return reject(signal2.reason);
+    let headers = new import_http.HttpHeaders();
+    new Headers(init.headers).forEach((value, key) => headers = headers.set(key, value));
+    let subscription;
+    const onAbort = () => {
+      subscription?.unsubscribe();
+      reject(signal2?.reason);
+    };
+    const done = () => signal2?.removeEventListener("abort", onAbort);
+    signal2?.addEventListener("abort", onAbort, { once: true });
+    subscription = http.request(init.method ?? "GET", input instanceof Request ? input.url : String(input), {
+      body: init.body ?? null,
+      headers,
+      withCredentials: init.credentials === "include",
+      observe: "response",
+      // not 'blob': the SSR transfer cache stores blob bodies as an empty string
+      responseType: "arraybuffer",
+      // keep the list total when the app enables the transfer cache
+      transferCache: { includeHeaders: ["x-total-count"] }
+    }).subscribe({
+      next: (res) => {
+        done();
+        toResponse(res.status, res.statusText, res.headers, res.body).then(resolve, reject);
+      },
+      error: (err) => {
+        done();
+        if (err instanceof import_http.HttpErrorResponse && err.status >= 200) {
+          toResponse(err.status, err.statusText, err.headers, err.error).then(resolve, reject);
+        } else {
+          reject(new TypeError("Failed to fetch", { cause: err }));
+        }
+      }
+    });
+  });
+}
+async function toResponse(status, statusText, httpHeaders, body) {
+  const headers = new Headers();
+  for (const key of httpHeaders.keys()) {
+    for (const value of httpHeaders.getAll(key) ?? []) headers.append(key, value);
+  }
+  const noBody = status === 204 || status === 205 || status === 304;
+  return new Response(noBody ? null : await toBodyInit(body), { status, statusText, headers });
+}
+async function toBodyInit(body) {
+  if (body === null || body === void 0) return null;
+  if (typeof body === "string" || body instanceof ArrayBuffer) return body;
+  if (typeof body.arrayBuffer === "function") return body.arrayBuffer();
+  return JSON.stringify(body);
+}
+
+// src/pending-tasks-http.ts
+var import_sdk_core = require("@skill3/sdk-core");
+var PendingTasksHttp = class extends import_sdk_core.Skill3Http {
+  constructor(config, store, state, tasks) {
+    super(config, store, state);
+    this.tasks = tasks;
+  }
+  tasks;
+  request(method, target, option) {
+    const done = this.tasks.add();
+    return super.request(method, target, option).finally(done);
+  }
+};
+
+// src/services.ts
+var import_rxjs2 = require("rxjs");
+var import_sdk_core2 = require("@skill3/sdk-core");
+
+// src/interop.ts
+var import_core = require("@angular/core");
+var import_rxjs = require("rxjs");
+function valueToSignal(value, destroyRef) {
+  const result = (0, import_core.signal)(value.get());
+  destroyRef.onDestroy(value.subscribe((next) => result.set(next)));
+  return result.asReadonly();
+}
+function valueToObservable(value) {
+  return new import_rxjs.Observable((subscriber) => {
+    subscriber.next(value.get());
+    return value.subscribe((next) => subscriber.next(next));
+  });
+}
+
+// src/services.ts
+var AuthService = class extends import_sdk_core2.AuthService {
+  /** Signed-in user as a signal (`null` when signed out). */
+  user;
+  /** Signed-in user as an observable (`null` when signed out). Emits the current user on subscribe. */
+  user$;
+  constructor(client, destroyRef) {
+    super(client.config, client.http, client.store, client.state);
+    this.user = valueToSignal(client.state.user, destroyRef);
+    this.user$ = valueToObservable(client.state.user);
+  }
+  /** Emits the stored user (when `dispatch`) and returns `user$`. */
+  async subscribeUser({
+    prefix_key,
+    dispatch = true
+  } = {}) {
+    const user = await this.getUser({ prefix_key });
+    if (dispatch) this.state.setUser(user);
+    return this.user$;
+  }
+};
+var CoreSiteService = class extends import_sdk_core2.CoreSiteService {
+  /** true once a site token is known. */
+  siteReady;
+  constructor(client, auth, destroyRef) {
+    super(client.config, client.http, client.store, client.state, auth);
+    this.siteReady = valueToSignal(client.state.siteReady, destroyRef);
+  }
+  /** Emits `true` now and every time an automatic site-token renewal finishes. */
+  onSiteTokenRenew() {
+    return new import_rxjs2.Observable(
+      (subscriber) => this.state.onSiteRenewed((renewed) => subscriber.next(renewed))
+    );
+  }
+};
+
+// src/storage.ts
+var import_core2 = require("@angular/core");
+var import_common = require("@angular/common");
+var import_sdk_core3 = require("@skill3/sdk-core");
+var StorageProvider = class {
+};
+function provideLocalStorage() {
+  return {
+    provide: StorageProvider,
+    useFactory: () => new import_sdk_core3.LocalStorageProvider((0, import_common.isPlatformBrowser)((0, import_core2.inject)(import_core2.PLATFORM_ID)) ? void 0 : null)
+  };
+}
+function provideCustomStorage(factory) {
+  return { provide: StorageProvider, useFactory: () => new import_sdk_core3.CustomStorageProvider(factory()) };
+}
+
+// src/provide.ts
+var SKILL3_CLIENT = new import_core3.InjectionToken("SKILL3_CLIENT");
+var SKILL3_CONFIG = new import_core3.InjectionToken("SKILL3_CONFIG");
+function provideSkill3(config = {}, storageProvider) {
+  const storage = storageProvider ?? (typeof config === "function" ? void 0 : config.storage);
+  const client = () => (0, import_core3.inject)(SKILL3_CLIENT);
+  return (0, import_core3.makeEnvironmentProviders)([
+    {
+      provide: SKILL3_CLIENT,
+      useFactory: () => createClient(typeof config === "function" ? config() : config)
+    },
+    storage ?? { provide: StorageProvider, useClass: import_sdk_core4.MemoryStorageProvider },
+    { provide: SKILL3_CONFIG, useFactory: () => client().config },
+    { provide: import_sdk_core4.Skill3State, useFactory: () => client().state },
+    { provide: import_sdk_core4.SessionStore, useFactory: () => client().store },
+    { provide: import_sdk_core4.Skill3Http, useFactory: () => client().http },
+    { provide: AuthService, useFactory: () => new AuthService(client(), (0, import_core3.inject)(import_core3.DestroyRef)) },
+    {
+      provide: CoreSiteService,
+      useFactory: () => new CoreSiteService(client(), (0, import_core3.inject)(AuthService), (0, import_core3.inject)(import_core3.DestroyRef))
+    },
+    { provide: import_sdk_core4.CustomService, useFactory: () => new import_sdk_core4.CustomService(client().http) }
+  ]);
+}
+function createClient({
+  storage: _storage,
+  useHttpClient = true,
+  ...config
+}) {
+  const fetch = config.fetch ?? (useHttpClient ? httpClientFetch((0, import_core3.inject)(import_http2.HttpClient)) : void 0);
+  const document = (0, import_core3.inject)(import_core3.DOCUMENT, { optional: true });
+  const tasks = (0, import_core3.inject)(import_core3.PendingTasks);
+  return (0, import_sdk_core4.createSkill3)(
+    {
+      ...config,
+      storage: (0, import_core3.inject)(StorageProvider),
+      isServer: config.isServer ?? (0, import_common2.isPlatformServer)((0, import_core3.inject)(import_core3.PLATFORM_ID)),
+      fetch,
+      hostname: config.hostname ?? (() => document?.location?.hostname)
+    },
+    { createHttp: (...args) => new PendingTasksHttp(...args, tasks) }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthService,
+  CoreSiteService,
+  SKILL3_CLIENT,
+  SKILL3_CONFIG,
+  StorageProvider,
+  httpClientFetch,
+  provideCustomStorage,
+  provideLocalStorage,
+  provideSkill3,
+  valueToObservable,
+  valueToSignal,
+  ...require("@skill3/sdk-core")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provide.ts","../src/http-client-fetch.ts","../src/pending-tasks-http.ts","../src/services.ts","../src/interop.ts","../src/storage.ts"],"sourcesContent":["/*\n * Public API Surface of @skill3/sdk-angular\n */\n\n// everything of the core; the local exports below replace the core ones with the same name\nexport * from '@skill3/sdk-core';\n\nexport { provideSkill3, SKILL3_CLIENT, SKILL3_CONFIG } from './provide';\nexport type { Skill3AngularConfig } from './provide';\nexport { AuthService, CoreSiteService } from './services';\nexport { StorageProvider, provideLocalStorage, provideCustomStorage } from './storage';\nexport { httpClientFetch } from './http-client-fetch';\nexport { valueToObservable, valueToSignal } from './interop';\n","import {\n  DOCUMENT,\n  DestroyRef,\n  EnvironmentProviders,\n  InjectionToken,\n  PLATFORM_ID,\n  PendingTasks,\n  Provider,\n  inject,\n  makeEnvironmentProviders,\n} from '@angular/core';\nimport { isPlatformServer } from '@angular/common';\nimport { HttpClient } from '@angular/common/http';\nimport {\n  CustomService,\n  MemoryStorageProvider,\n  SessionStore,\n  Skill3Http,\n  Skill3State,\n  createSkill3,\n  type ResolvedSkill3Config,\n  type Skill3Client,\n  type Skill3Config,\n} from '@skill3/sdk-core';\nimport { httpClientFetch } from './http-client-fetch';\nimport { PendingTasksHttp } from './pending-tasks-http';\nimport { AuthService, CoreSiteService } from './services';\nimport { StorageProvider } from './storage';\n\nexport interface Skill3AngularConfig extends Omit<Skill3Config, 'storage'> {\n  /** Storage provider, e.g. `provideLocalStorage()`. Default: in-memory (lost on reload). */\n  storage?: Provider;\n  /**\n   * Default true: send requests through `HttpClient` (interceptors and `withFetch()` of\n   * `provideHttpClient()`, SSR transfer cache). false → plain `fetch`. Ignored when `fetch` is set.\n   */\n  useHttpClient?: boolean;\n}\n\n/** The `Skill3Client` behind the injectable services. */\nexport const SKILL3_CLIENT = new InjectionToken<Skill3Client>('SKILL3_CLIENT');\n\n/** Config after defaults are applied. */\nexport const SKILL3_CONFIG = new InjectionToken<ResolvedSkill3Config>('SKILL3_CONFIG');\n\n/**\n * Registers the library.\n *\n * ```ts\n * bootstrapApplication(App, {\n *   providers: [\n *     provideHttpClient(withFetch()),\n *     provideSkill3({ scope: 'site', environment, storage: provideLocalStorage() }),\n *   ],\n * });\n * ```\n *\n * Pass a factory instead of an object when the config depends on other providers\n * (e.g. SSR request data). The factory runs in an injection context, so it cannot\n * return `storage`: pass the storage provider as the second argument instead.\n */\nexport function provideSkill3(\n  config: Skill3AngularConfig | (() => Skill3AngularConfig) = {},\n  storageProvider?: Provider,\n): EnvironmentProviders {\n  const storage = storageProvider ?? (typeof config === 'function' ? undefined : config.storage);\n  const client = () => inject(SKILL3_CLIENT);\n  return makeEnvironmentProviders([\n    {\n      provide: SKILL3_CLIENT,\n      useFactory: () => createClient(typeof config === 'function' ? config() : config),\n    },\n    storage ?? { provide: StorageProvider, useClass: MemoryStorageProvider },\n    { provide: SKILL3_CONFIG, useFactory: () => client().config },\n    { provide: Skill3State, useFactory: () => client().state },\n    { provide: SessionStore, useFactory: () => client().store },\n    { provide: Skill3Http, useFactory: () => client().http },\n    { provide: AuthService, useFactory: () => new AuthService(client(), inject(DestroyRef)) },\n    {\n      provide: CoreSiteService,\n      useFactory: () => new CoreSiteService(client(), inject(AuthService), inject(DestroyRef)),\n    },\n    { provide: CustomService, useFactory: () => new CustomService(client().http) },\n  ]);\n}\n\nfunction createClient({\n  storage: _storage,\n  useHttpClient = true,\n  ...config\n}: Skill3AngularConfig): Skill3Client {\n  // HttpClient is provided in root (Angular 22), provideHttpClient() only configures it\n  const fetch = config.fetch ?? (useHttpClient ? httpClientFetch(inject(HttpClient)) : undefined);\n  const document = inject(DOCUMENT, { optional: true });\n  const tasks = inject(PendingTasks);\n  return createSkill3(\n    {\n      ...config,\n      storage: inject(StorageProvider),\n      isServer: config.isServer ?? isPlatformServer(inject(PLATFORM_ID)),\n      fetch,\n      hostname: config.hostname ?? (() => document?.location?.hostname),\n    },\n    { createHttp: (...args) => new PendingTasksHttp(...args, tasks) },\n  );\n}\n","import { HttpClient, HttpErrorResponse, HttpHeaders } from '@angular/common/http';\nimport type { Subscription } from 'rxjs';\n\n/**\n * `fetch` that sends through Angular's `HttpClient`, so the app's interceptors, XSRF handling\n * and the SSR transfer cache still apply. Non-2xx answers resolve as a `Response` (like `fetch`);\n * only network failures reject.\n */\nexport function httpClientFetch(http: HttpClient): typeof fetch {\n  return (input, init = {}) =>\n    new Promise<Response>((resolve, reject) => {\n      const signal = init.signal;\n      if (signal?.aborted) return reject(signal.reason);\n\n      let headers = new HttpHeaders();\n      new Headers(init.headers).forEach((value, key) => (headers = headers.set(key, value)));\n\n      let subscription: Subscription | undefined;\n      const onAbort = () => {\n        subscription?.unsubscribe();\n        reject(signal?.reason);\n      };\n      const done = () => signal?.removeEventListener('abort', onAbort);\n      signal?.addEventListener('abort', onAbort, { once: true });\n\n      subscription = http\n        .request(init.method ?? 'GET', input instanceof Request ? input.url : String(input), {\n          body: init.body ?? null,\n          headers,\n          withCredentials: init.credentials === 'include',\n          observe: 'response',\n          // not 'blob': the SSR transfer cache stores blob bodies as an empty string\n          responseType: 'arraybuffer',\n          // keep the list total when the app enables the transfer cache\n          transferCache: { includeHeaders: ['x-total-count'] },\n        })\n        .subscribe({\n          next: (res) => {\n            done();\n            toResponse(res.status, res.statusText, res.headers, res.body).then(resolve, reject);\n          },\n          error: (err: unknown) => {\n            done();\n            if (err instanceof HttpErrorResponse && err.status >= 200) {\n              toResponse(err.status, err.statusText, err.headers, err.error).then(resolve, reject);\n            } else {\n              reject(new TypeError('Failed to fetch', { cause: err }));\n            }\n          },\n        });\n    });\n}\n\nasync function toResponse(\n  status: number,\n  statusText: string,\n  httpHeaders: HttpHeaders,\n  body: unknown,\n): Promise<Response> {\n  const headers = new Headers();\n  for (const key of httpHeaders.keys()) {\n    for (const value of httpHeaders.getAll(key) ?? []) headers.append(key, value);\n  }\n  const noBody = status === 204 || status === 205 || status === 304;\n  return new Response(noBody ? null : await toBodyInit(body), { status, statusText, headers });\n}\n\n/**\n * Blob → its bytes (read through `arrayBuffer()`, so a Blob of another realm or polyfill works);\n * text / buffer as is; anything an interceptor turned into an object goes back to JSON.\n */\nasync function toBodyInit(body: unknown): Promise<BodyInit | null> {\n  if (body === null || body === undefined) return null;\n  if (typeof body === 'string' || body instanceof ArrayBuffer) return body;\n  if (typeof (body as Blob).arrayBuffer === 'function') return (body as Blob).arrayBuffer();\n  return JSON.stringify(body);\n}\n","import { PendingTasks } from '@angular/core';\nimport {\n  Skill3Http,\n  type HttpMethod,\n  type RequestOptions,\n  type RequestTarget,\n  type ResolvedSkill3Config,\n  type SessionStore,\n  type Skill3Response,\n  type Skill3State,\n} from '@skill3/sdk-core';\n\n/**\n * `Skill3Http` that keeps the app unstable while a request runs (retries and token renewals\n * included). Zoneless SSR waits only for `PendingTasks`, and the library awaits storage before\n * `HttpClient` registers its own task, so without this the page renders before the data arrives.\n */\nexport class PendingTasksHttp extends Skill3Http {\n  constructor(\n    config: ResolvedSkill3Config,\n    store: SessionStore,\n    state: Skill3State,\n    private readonly tasks: PendingTasks,\n  ) {\n    super(config, store, state);\n  }\n\n  override request<T = any>(\n    method: HttpMethod,\n    target: RequestTarget,\n    option?: RequestOptions,\n  ): Promise<Skill3Response<T>> {\n    // add() rather than run(): run() returns nothing and reports rejections to the ErrorHandler\n    const done = this.tasks.add();\n    return super.request<T>(method, target, option).finally(done);\n  }\n}\n","import { DestroyRef, Signal } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport {\n  AuthService as BaseAuthService,\n  CoreSiteService as BaseCoreSiteService,\n  type AuthKeyOption,\n  type Skill3Client,\n} from '@skill3/sdk-core';\nimport { valueToObservable, valueToSignal } from './interop';\n\n/**\n * `AuthService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.\n * Inject it: `inject(AuthService)` (registered by `provideSkill3()`).\n */\nexport class AuthService extends BaseAuthService {\n  /** Signed-in user as a signal (`null` when signed out). */\n  readonly user: Signal<any>;\n  /** Signed-in user as an observable (`null` when signed out). Emits the current user on subscribe. */\n  readonly user$: Observable<any>;\n\n  constructor(client: Skill3Client, destroyRef: DestroyRef) {\n    super(client.config, client.http, client.store, client.state);\n    this.user = valueToSignal(client.state.user, destroyRef);\n    this.user$ = valueToObservable(client.state.user);\n  }\n\n  /** Emits the stored user (when `dispatch`) and returns `user$`. */\n  async subscribeUser({\n    prefix_key,\n    dispatch = true,\n  }: AuthKeyOption & { dispatch?: boolean } = {}): Promise<Observable<any>> {\n    const user = await this.getUser({ prefix_key });\n    if (dispatch) this.state.setUser(user);\n    return this.user$;\n  }\n}\n\n/**\n * `CoreSiteService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.\n * Inject it: `inject(CoreSiteService)` (registered by `provideSkill3()`).\n */\nexport class CoreSiteService extends BaseCoreSiteService {\n  /** true once a site token is known. */\n  readonly siteReady: Signal<boolean>;\n\n  constructor(client: Skill3Client, auth: AuthService, destroyRef: DestroyRef) {\n    super(client.config, client.http, client.store, client.state, auth);\n    this.siteReady = valueToSignal(client.state.siteReady, destroyRef);\n  }\n\n  /** Emits `true` now and every time an automatic site-token renewal finishes. */\n  onSiteTokenRenew(): Observable<boolean> {\n    return new Observable<boolean>((subscriber) =>\n      this.state.onSiteRenewed((renewed) => subscriber.next(renewed)),\n    );\n  }\n}\n","import { DestroyRef, Signal, signal } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport type { ReadonlyValue } from '@skill3/sdk-core';\n\n/** Signal that follows `value` until `destroyRef` is destroyed. */\nexport function valueToSignal<T>(value: ReadonlyValue<T>, destroyRef: DestroyRef): Signal<T> {\n  const result = signal(value.get());\n  destroyRef.onDestroy(value.subscribe((next) => result.set(next)));\n  return result.asReadonly();\n}\n\n/** Observable that emits the current value on subscribe, then every change (like `BehaviorSubject`). */\nexport function valueToObservable<T>(value: ReadonlyValue<T>): Observable<T> {\n  return new Observable<T>((subscriber) => {\n    subscriber.next(value.get());\n    return value.subscribe((next) => subscriber.next(next));\n  });\n}\n","import { PLATFORM_ID, Provider, inject } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\nimport {\n  CustomStorageProvider,\n  LocalStorageProvider,\n  type StorageLike,\n  type StorageProvider as CoreStorageProvider,\n} from '@skill3/sdk-core';\n\n/**\n * DI token of the storage the library keeps tokens and cached user/site in:\n * `{ provide: StorageProvider, useClass: MyStorage }`. Any class with the methods works\n * (the storages of `@skill3/sdk-core` included), extending this one is optional.\n */\nexport abstract class StorageProvider implements CoreStorageProvider {\n  abstract get(key: string): Promise<string | null>;\n  abstract set(key: string, value: string): Promise<unknown>;\n  abstract remove(key: string): Promise<unknown>;\n  abstract clear(): Promise<void>;\n  abstract length(): Promise<number | null>;\n  abstract keys(): Promise<string[]>;\n}\n\n/** `storage` option that keeps the session in `localStorage` (memory on the server). */\nexport function provideLocalStorage(): Provider {\n  return {\n    provide: StorageProvider,\n    useFactory: () =>\n      new LocalStorageProvider(isPlatformBrowser(inject(PLATFORM_ID)) ? undefined : null),\n  };\n}\n\n/**\n * `storage` option that wraps a promise-based storage resolved from DI.\n *\n * ```ts\n * storage: provideCustomStorage(() => {\n *   const storage = inject(Storage); // @ionic/storage-angular\n *   storage.create();\n *   return storage;\n * })\n * ```\n */\nexport function provideCustomStorage(factory: () => StorageLike): Provider {\n  return { provide: StorageProvider, useFactory: () => new CustomStorageProvider(factory()) };\n}\n"],"mappings":"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","names":["import_core","import_common","import_http","import_sdk_core","signal","import_rxjs","import_sdk_core","BaseAuthService","BaseCoreSiteService","import_core","import_sdk_core"]}

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+import { Skill3Client, ResolvedSkill3Config, Skill3Config, AuthService as AuthService$1, AuthKeyOption, CoreSiteService as CoreSiteService$1, StorageProvider as StorageProvider$1, StorageLike, ReadonlyValue } from '@skill3/sdk-core';
+export * from '@skill3/sdk-core';
+import { InjectionToken, Provider, EnvironmentProviders, Signal, DestroyRef } from '@angular/core';
+import { Observable } from 'rxjs';
+import { HttpClient } from '@angular/common/http';
+
+interface Skill3AngularConfig extends Omit<Skill3Config, 'storage'> {
+    /** Storage provider, e.g. `provideLocalStorage()`. Default: in-memory (lost on reload). */
+    storage?: Provider;
+    /**
+     * Default true: send requests through `HttpClient` (interceptors and `withFetch()` of
+     * `provideHttpClient()`, SSR transfer cache). false → plain `fetch`. Ignored when `fetch` is set.
+     */
+    useHttpClient?: boolean;
+}
+/** The `Skill3Client` behind the injectable services. */
+declare const SKILL3_CLIENT: InjectionToken<Skill3Client>;
+/** Config after defaults are applied. */
+declare const SKILL3_CONFIG: InjectionToken<ResolvedSkill3Config>;
+/**
+ * Registers the library.
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideHttpClient(withFetch()),
+ *     provideSkill3({ scope: 'site', environment, storage: provideLocalStorage() }),
+ *   ],
+ * });
+ * ```
+ *
+ * Pass a factory instead of an object when the config depends on other providers
+ * (e.g. SSR request data). The factory runs in an injection context, so it cannot
+ * return `storage`: pass the storage provider as the second argument instead.
+ */
+declare function provideSkill3(config?: Skill3AngularConfig | (() => Skill3AngularConfig), storageProvider?: Provider): EnvironmentProviders;
+
+/**
+ * `AuthService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.
+ * Inject it: `inject(AuthService)` (registered by `provideSkill3()`).
+ */
+declare class AuthService extends AuthService$1 {
+    /** Signed-in user as a signal (`null` when signed out). */
+    readonly user: Signal<any>;
+    /** Signed-in user as an observable (`null` when signed out). Emits the current user on subscribe. */
+    readonly user$: Observable<any>;
+    constructor(client: Skill3Client, destroyRef: DestroyRef);
+    /** Emits the stored user (when `dispatch`) and returns `user$`. */
+    subscribeUser({ prefix_key, dispatch, }?: AuthKeyOption & {
+        dispatch?: boolean;
+    }): Promise<Observable<any>>;
+}
+/**
+ * `CoreSiteService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.
+ * Inject it: `inject(CoreSiteService)` (registered by `provideSkill3()`).
+ */
+declare class CoreSiteService extends CoreSiteService$1 {
+    /** true once a site token is known. */
+    readonly siteReady: Signal<boolean>;
+    constructor(client: Skill3Client, auth: AuthService, destroyRef: DestroyRef);
+    /** Emits `true` now and every time an automatic site-token renewal finishes. */
+    onSiteTokenRenew(): Observable<boolean>;
+}
+
+/**
+ * DI token of the storage the library keeps tokens and cached user/site in:
+ * `{ provide: StorageProvider, useClass: MyStorage }`. Any class with the methods works
+ * (the storages of `@skill3/sdk-core` included), extending this one is optional.
+ */
+declare abstract class StorageProvider implements StorageProvider$1 {
+    abstract get(key: string): Promise<string | null>;
+    abstract set(key: string, value: string): Promise<unknown>;
+    abstract remove(key: string): Promise<unknown>;
+    abstract clear(): Promise<void>;
+    abstract length(): Promise<number | null>;
+    abstract keys(): Promise<string[]>;
+}
+/** `storage` option that keeps the session in `localStorage` (memory on the server). */
+declare function provideLocalStorage(): Provider;
+/**
+ * `storage` option that wraps a promise-based storage resolved from DI.
+ *
+ * ```ts
+ * storage: provideCustomStorage(() => {
+ *   const storage = inject(Storage); // @ionic/storage-angular
+ *   storage.create();
+ *   return storage;
+ * })
+ * ```
+ */
+declare function provideCustomStorage(factory: () => StorageLike): Provider;
+
+/**
+ * `fetch` that sends through Angular's `HttpClient`, so the app's interceptors, XSRF handling
+ * and the SSR transfer cache still apply. Non-2xx answers resolve as a `Response` (like `fetch`);
+ * only network failures reject.
+ */
+declare function httpClientFetch(http: HttpClient): typeof fetch;
+
+/** Signal that follows `value` until `destroyRef` is destroyed. */
+declare function valueToSignal<T>(value: ReadonlyValue<T>, destroyRef: DestroyRef): Signal<T>;
+/** Observable that emits the current value on subscribe, then every change (like `BehaviorSubject`). */
+declare function valueToObservable<T>(value: ReadonlyValue<T>): Observable<T>;
+
+export { AuthService, CoreSiteService, SKILL3_CLIENT, SKILL3_CONFIG, StorageProvider, httpClientFetch, provideCustomStorage, provideLocalStorage, provideSkill3, valueToObservable, valueToSignal };
+export type { Skill3AngularConfig };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import { Skill3Client, ResolvedSkill3Config, Skill3Config, AuthService as AuthService$1, AuthKeyOption, CoreSiteService as CoreSiteService$1, StorageProvider as StorageProvider$1, StorageLike, ReadonlyValue } from '@skill3/sdk-core';
+export * from '@skill3/sdk-core';
+import { InjectionToken, Provider, EnvironmentProviders, Signal, DestroyRef } from '@angular/core';
+import { Observable } from 'rxjs';
+import { HttpClient } from '@angular/common/http';
+
+interface Skill3AngularConfig extends Omit<Skill3Config, 'storage'> {
+    /** Storage provider, e.g. `provideLocalStorage()`. Default: in-memory (lost on reload). */
+    storage?: Provider;
+    /**
+     * Default true: send requests through `HttpClient` (interceptors and `withFetch()` of
+     * `provideHttpClient()`, SSR transfer cache). false → plain `fetch`. Ignored when `fetch` is set.
+     */
+    useHttpClient?: boolean;
+}
+/** The `Skill3Client` behind the injectable services. */
+declare const SKILL3_CLIENT: InjectionToken<Skill3Client>;
+/** Config after defaults are applied. */
+declare const SKILL3_CONFIG: InjectionToken<ResolvedSkill3Config>;
+/**
+ * Registers the library.
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideHttpClient(withFetch()),
+ *     provideSkill3({ scope: 'site', environment, storage: provideLocalStorage() }),
+ *   ],
+ * });
+ * ```
+ *
+ * Pass a factory instead of an object when the config depends on other providers
+ * (e.g. SSR request data). The factory runs in an injection context, so it cannot
+ * return `storage`: pass the storage provider as the second argument instead.
+ */
+declare function provideSkill3(config?: Skill3AngularConfig | (() => Skill3AngularConfig), storageProvider?: Provider): EnvironmentProviders;
+
+/**
+ * `AuthService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.
+ * Inject it: `inject(AuthService)` (registered by `provideSkill3()`).
+ */
+declare class AuthService extends AuthService$1 {
+    /** Signed-in user as a signal (`null` when signed out). */
+    readonly user: Signal<any>;
+    /** Signed-in user as an observable (`null` when signed out). Emits the current user on subscribe. */
+    readonly user$: Observable<any>;
+    constructor(client: Skill3Client, destroyRef: DestroyRef);
+    /** Emits the stored user (when `dispatch`) and returns `user$`. */
+    subscribeUser({ prefix_key, dispatch, }?: AuthKeyOption & {
+        dispatch?: boolean;
+    }): Promise<Observable<any>>;
+}
+/**
+ * `CoreSiteService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.
+ * Inject it: `inject(CoreSiteService)` (registered by `provideSkill3()`).
+ */
+declare class CoreSiteService extends CoreSiteService$1 {
+    /** true once a site token is known. */
+    readonly siteReady: Signal<boolean>;
+    constructor(client: Skill3Client, auth: AuthService, destroyRef: DestroyRef);
+    /** Emits `true` now and every time an automatic site-token renewal finishes. */
+    onSiteTokenRenew(): Observable<boolean>;
+}
+
+/**
+ * DI token of the storage the library keeps tokens and cached user/site in:
+ * `{ provide: StorageProvider, useClass: MyStorage }`. Any class with the methods works
+ * (the storages of `@skill3/sdk-core` included), extending this one is optional.
+ */
+declare abstract class StorageProvider implements StorageProvider$1 {
+    abstract get(key: string): Promise<string | null>;
+    abstract set(key: string, value: string): Promise<unknown>;
+    abstract remove(key: string): Promise<unknown>;
+    abstract clear(): Promise<void>;
+    abstract length(): Promise<number | null>;
+    abstract keys(): Promise<string[]>;
+}
+/** `storage` option that keeps the session in `localStorage` (memory on the server). */
+declare function provideLocalStorage(): Provider;
+/**
+ * `storage` option that wraps a promise-based storage resolved from DI.
+ *
+ * ```ts
+ * storage: provideCustomStorage(() => {
+ *   const storage = inject(Storage); // @ionic/storage-angular
+ *   storage.create();
+ *   return storage;
+ * })
+ * ```
+ */
+declare function provideCustomStorage(factory: () => StorageLike): Provider;
+
+/**
+ * `fetch` that sends through Angular's `HttpClient`, so the app's interceptors, XSRF handling
+ * and the SSR transfer cache still apply. Non-2xx answers resolve as a `Response` (like `fetch`);
+ * only network failures reject.
+ */
+declare function httpClientFetch(http: HttpClient): typeof fetch;
+
+/** Signal that follows `value` until `destroyRef` is destroyed. */
+declare function valueToSignal<T>(value: ReadonlyValue<T>, destroyRef: DestroyRef): Signal<T>;
+/** Observable that emits the current value on subscribe, then every change (like `BehaviorSubject`). */
+declare function valueToObservable<T>(value: ReadonlyValue<T>): Observable<T>;
+
+export { AuthService, CoreSiteService, SKILL3_CLIENT, SKILL3_CONFIG, StorageProvider, httpClientFetch, provideCustomStorage, provideLocalStorage, provideSkill3, valueToObservable, valueToSignal };
+export type { Skill3AngularConfig };

package/dist/index.js

@@ -0,0 +1,229 @@
+// src/index.ts
+export * from "@skill3/sdk-core";
+
+// src/provide.ts
+import {
+  DOCUMENT,
+  DestroyRef as DestroyRef2,
+  InjectionToken,
+  PLATFORM_ID as PLATFORM_ID2,
+  PendingTasks,
+  inject as inject2,
+  makeEnvironmentProviders
+} from "@angular/core";
+import { isPlatformServer } from "@angular/common";
+import { HttpClient as HttpClient2 } from "@angular/common/http";
+import {
+  CustomService,
+  MemoryStorageProvider,
+  SessionStore,
+  Skill3Http as Skill3Http2,
+  Skill3State,
+  createSkill3
+} from "@skill3/sdk-core";
+
+// src/http-client-fetch.ts
+import { HttpErrorResponse, HttpHeaders } from "@angular/common/http";
+function httpClientFetch(http) {
+  return (input, init = {}) => new Promise((resolve, reject) => {
+    const signal2 = init.signal;
+    if (signal2?.aborted) return reject(signal2.reason);
+    let headers = new HttpHeaders();
+    new Headers(init.headers).forEach((value, key) => headers = headers.set(key, value));
+    let subscription;
+    const onAbort = () => {
+      subscription?.unsubscribe();
+      reject(signal2?.reason);
+    };
+    const done = () => signal2?.removeEventListener("abort", onAbort);
+    signal2?.addEventListener("abort", onAbort, { once: true });
+    subscription = http.request(init.method ?? "GET", input instanceof Request ? input.url : String(input), {
+      body: init.body ?? null,
+      headers,
+      withCredentials: init.credentials === "include",
+      observe: "response",
+      // not 'blob': the SSR transfer cache stores blob bodies as an empty string
+      responseType: "arraybuffer",
+      // keep the list total when the app enables the transfer cache
+      transferCache: { includeHeaders: ["x-total-count"] }
+    }).subscribe({
+      next: (res) => {
+        done();
+        toResponse(res.status, res.statusText, res.headers, res.body).then(resolve, reject);
+      },
+      error: (err) => {
+        done();
+        if (err instanceof HttpErrorResponse && err.status >= 200) {
+          toResponse(err.status, err.statusText, err.headers, err.error).then(resolve, reject);
+        } else {
+          reject(new TypeError("Failed to fetch", { cause: err }));
+        }
+      }
+    });
+  });
+}
+async function toResponse(status, statusText, httpHeaders, body) {
+  const headers = new Headers();
+  for (const key of httpHeaders.keys()) {
+    for (const value of httpHeaders.getAll(key) ?? []) headers.append(key, value);
+  }
+  const noBody = status === 204 || status === 205 || status === 304;
+  return new Response(noBody ? null : await toBodyInit(body), { status, statusText, headers });
+}
+async function toBodyInit(body) {
+  if (body === null || body === void 0) return null;
+  if (typeof body === "string" || body instanceof ArrayBuffer) return body;
+  if (typeof body.arrayBuffer === "function") return body.arrayBuffer();
+  return JSON.stringify(body);
+}
+
+// src/pending-tasks-http.ts
+import {
+  Skill3Http
+} from "@skill3/sdk-core";
+var PendingTasksHttp = class extends Skill3Http {
+  constructor(config, store, state, tasks) {
+    super(config, store, state);
+    this.tasks = tasks;
+  }
+  tasks;
+  request(method, target, option) {
+    const done = this.tasks.add();
+    return super.request(method, target, option).finally(done);
+  }
+};
+
+// src/services.ts
+import { Observable as Observable2 } from "rxjs";
+import {
+  AuthService as BaseAuthService,
+  CoreSiteService as BaseCoreSiteService
+} from "@skill3/sdk-core";
+
+// src/interop.ts
+import { signal } from "@angular/core";
+import { Observable } from "rxjs";
+function valueToSignal(value, destroyRef) {
+  const result = signal(value.get());
+  destroyRef.onDestroy(value.subscribe((next) => result.set(next)));
+  return result.asReadonly();
+}
+function valueToObservable(value) {
+  return new Observable((subscriber) => {
+    subscriber.next(value.get());
+    return value.subscribe((next) => subscriber.next(next));
+  });
+}
+
+// src/services.ts
+var AuthService = class extends BaseAuthService {
+  /** Signed-in user as a signal (`null` when signed out). */
+  user;
+  /** Signed-in user as an observable (`null` when signed out). Emits the current user on subscribe. */
+  user$;
+  constructor(client, destroyRef) {
+    super(client.config, client.http, client.store, client.state);
+    this.user = valueToSignal(client.state.user, destroyRef);
+    this.user$ = valueToObservable(client.state.user);
+  }
+  /** Emits the stored user (when `dispatch`) and returns `user$`. */
+  async subscribeUser({
+    prefix_key,
+    dispatch = true
+  } = {}) {
+    const user = await this.getUser({ prefix_key });
+    if (dispatch) this.state.setUser(user);
+    return this.user$;
+  }
+};
+var CoreSiteService = class extends BaseCoreSiteService {
+  /** true once a site token is known. */
+  siteReady;
+  constructor(client, auth, destroyRef) {
+    super(client.config, client.http, client.store, client.state, auth);
+    this.siteReady = valueToSignal(client.state.siteReady, destroyRef);
+  }
+  /** Emits `true` now and every time an automatic site-token renewal finishes. */
+  onSiteTokenRenew() {
+    return new Observable2(
+      (subscriber) => this.state.onSiteRenewed((renewed) => subscriber.next(renewed))
+    );
+  }
+};
+
+// src/storage.ts
+import { PLATFORM_ID, inject } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
+import {
+  CustomStorageProvider,
+  LocalStorageProvider
+} from "@skill3/sdk-core";
+var StorageProvider = class {
+};
+function provideLocalStorage() {
+  return {
+    provide: StorageProvider,
+    useFactory: () => new LocalStorageProvider(isPlatformBrowser(inject(PLATFORM_ID)) ? void 0 : null)
+  };
+}
+function provideCustomStorage(factory) {
+  return { provide: StorageProvider, useFactory: () => new CustomStorageProvider(factory()) };
+}
+
+// src/provide.ts
+var SKILL3_CLIENT = new InjectionToken("SKILL3_CLIENT");
+var SKILL3_CONFIG = new InjectionToken("SKILL3_CONFIG");
+function provideSkill3(config = {}, storageProvider) {
+  const storage = storageProvider ?? (typeof config === "function" ? void 0 : config.storage);
+  const client = () => inject2(SKILL3_CLIENT);
+  return makeEnvironmentProviders([
+    {
+      provide: SKILL3_CLIENT,
+      useFactory: () => createClient(typeof config === "function" ? config() : config)
+    },
+    storage ?? { provide: StorageProvider, useClass: MemoryStorageProvider },
+    { provide: SKILL3_CONFIG, useFactory: () => client().config },
+    { provide: Skill3State, useFactory: () => client().state },
+    { provide: SessionStore, useFactory: () => client().store },
+    { provide: Skill3Http2, useFactory: () => client().http },
+    { provide: AuthService, useFactory: () => new AuthService(client(), inject2(DestroyRef2)) },
+    {
+      provide: CoreSiteService,
+      useFactory: () => new CoreSiteService(client(), inject2(AuthService), inject2(DestroyRef2))
+    },
+    { provide: CustomService, useFactory: () => new CustomService(client().http) }
+  ]);
+}
+function createClient({
+  storage: _storage,
+  useHttpClient = true,
+  ...config
+}) {
+  const fetch = config.fetch ?? (useHttpClient ? httpClientFetch(inject2(HttpClient2)) : void 0);
+  const document = inject2(DOCUMENT, { optional: true });
+  const tasks = inject2(PendingTasks);
+  return createSkill3(
+    {
+      ...config,
+      storage: inject2(StorageProvider),
+      isServer: config.isServer ?? isPlatformServer(inject2(PLATFORM_ID2)),
+      fetch,
+      hostname: config.hostname ?? (() => document?.location?.hostname)
+    },
+    { createHttp: (...args) => new PendingTasksHttp(...args, tasks) }
+  );
+}
+export {
+  AuthService,
+  CoreSiteService,
+  SKILL3_CLIENT,
+  SKILL3_CONFIG,
+  StorageProvider,
+  httpClientFetch,
+  provideCustomStorage,
+  provideLocalStorage,
+  provideSkill3,
+  valueToObservable,
+  valueToSignal
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provide.ts","../src/http-client-fetch.ts","../src/pending-tasks-http.ts","../src/services.ts","../src/interop.ts","../src/storage.ts"],"sourcesContent":["/*\n * Public API Surface of @skill3/sdk-angular\n */\n\n// everything of the core; the local exports below replace the core ones with the same name\nexport * from '@skill3/sdk-core';\n\nexport { provideSkill3, SKILL3_CLIENT, SKILL3_CONFIG } from './provide';\nexport type { Skill3AngularConfig } from './provide';\nexport { AuthService, CoreSiteService } from './services';\nexport { StorageProvider, provideLocalStorage, provideCustomStorage } from './storage';\nexport { httpClientFetch } from './http-client-fetch';\nexport { valueToObservable, valueToSignal } from './interop';\n","import {\n  DOCUMENT,\n  DestroyRef,\n  EnvironmentProviders,\n  InjectionToken,\n  PLATFORM_ID,\n  PendingTasks,\n  Provider,\n  inject,\n  makeEnvironmentProviders,\n} from '@angular/core';\nimport { isPlatformServer } from '@angular/common';\nimport { HttpClient } from '@angular/common/http';\nimport {\n  CustomService,\n  MemoryStorageProvider,\n  SessionStore,\n  Skill3Http,\n  Skill3State,\n  createSkill3,\n  type ResolvedSkill3Config,\n  type Skill3Client,\n  type Skill3Config,\n} from '@skill3/sdk-core';\nimport { httpClientFetch } from './http-client-fetch';\nimport { PendingTasksHttp } from './pending-tasks-http';\nimport { AuthService, CoreSiteService } from './services';\nimport { StorageProvider } from './storage';\n\nexport interface Skill3AngularConfig extends Omit<Skill3Config, 'storage'> {\n  /** Storage provider, e.g. `provideLocalStorage()`. Default: in-memory (lost on reload). */\n  storage?: Provider;\n  /**\n   * Default true: send requests through `HttpClient` (interceptors and `withFetch()` of\n   * `provideHttpClient()`, SSR transfer cache). false → plain `fetch`. Ignored when `fetch` is set.\n   */\n  useHttpClient?: boolean;\n}\n\n/** The `Skill3Client` behind the injectable services. */\nexport const SKILL3_CLIENT = new InjectionToken<Skill3Client>('SKILL3_CLIENT');\n\n/** Config after defaults are applied. */\nexport const SKILL3_CONFIG = new InjectionToken<ResolvedSkill3Config>('SKILL3_CONFIG');\n\n/**\n * Registers the library.\n *\n * ```ts\n * bootstrapApplication(App, {\n *   providers: [\n *     provideHttpClient(withFetch()),\n *     provideSkill3({ scope: 'site', environment, storage: provideLocalStorage() }),\n *   ],\n * });\n * ```\n *\n * Pass a factory instead of an object when the config depends on other providers\n * (e.g. SSR request data). The factory runs in an injection context, so it cannot\n * return `storage`: pass the storage provider as the second argument instead.\n */\nexport function provideSkill3(\n  config: Skill3AngularConfig | (() => Skill3AngularConfig) = {},\n  storageProvider?: Provider,\n): EnvironmentProviders {\n  const storage = storageProvider ?? (typeof config === 'function' ? undefined : config.storage);\n  const client = () => inject(SKILL3_CLIENT);\n  return makeEnvironmentProviders([\n    {\n      provide: SKILL3_CLIENT,\n      useFactory: () => createClient(typeof config === 'function' ? config() : config),\n    },\n    storage ?? { provide: StorageProvider, useClass: MemoryStorageProvider },\n    { provide: SKILL3_CONFIG, useFactory: () => client().config },\n    { provide: Skill3State, useFactory: () => client().state },\n    { provide: SessionStore, useFactory: () => client().store },\n    { provide: Skill3Http, useFactory: () => client().http },\n    { provide: AuthService, useFactory: () => new AuthService(client(), inject(DestroyRef)) },\n    {\n      provide: CoreSiteService,\n      useFactory: () => new CoreSiteService(client(), inject(AuthService), inject(DestroyRef)),\n    },\n    { provide: CustomService, useFactory: () => new CustomService(client().http) },\n  ]);\n}\n\nfunction createClient({\n  storage: _storage,\n  useHttpClient = true,\n  ...config\n}: Skill3AngularConfig): Skill3Client {\n  // HttpClient is provided in root (Angular 22), provideHttpClient() only configures it\n  const fetch = config.fetch ?? (useHttpClient ? httpClientFetch(inject(HttpClient)) : undefined);\n  const document = inject(DOCUMENT, { optional: true });\n  const tasks = inject(PendingTasks);\n  return createSkill3(\n    {\n      ...config,\n      storage: inject(StorageProvider),\n      isServer: config.isServer ?? isPlatformServer(inject(PLATFORM_ID)),\n      fetch,\n      hostname: config.hostname ?? (() => document?.location?.hostname),\n    },\n    { createHttp: (...args) => new PendingTasksHttp(...args, tasks) },\n  );\n}\n","import { HttpClient, HttpErrorResponse, HttpHeaders } from '@angular/common/http';\nimport type { Subscription } from 'rxjs';\n\n/**\n * `fetch` that sends through Angular's `HttpClient`, so the app's interceptors, XSRF handling\n * and the SSR transfer cache still apply. Non-2xx answers resolve as a `Response` (like `fetch`);\n * only network failures reject.\n */\nexport function httpClientFetch(http: HttpClient): typeof fetch {\n  return (input, init = {}) =>\n    new Promise<Response>((resolve, reject) => {\n      const signal = init.signal;\n      if (signal?.aborted) return reject(signal.reason);\n\n      let headers = new HttpHeaders();\n      new Headers(init.headers).forEach((value, key) => (headers = headers.set(key, value)));\n\n      let subscription: Subscription | undefined;\n      const onAbort = () => {\n        subscription?.unsubscribe();\n        reject(signal?.reason);\n      };\n      const done = () => signal?.removeEventListener('abort', onAbort);\n      signal?.addEventListener('abort', onAbort, { once: true });\n\n      subscription = http\n        .request(init.method ?? 'GET', input instanceof Request ? input.url : String(input), {\n          body: init.body ?? null,\n          headers,\n          withCredentials: init.credentials === 'include',\n          observe: 'response',\n          // not 'blob': the SSR transfer cache stores blob bodies as an empty string\n          responseType: 'arraybuffer',\n          // keep the list total when the app enables the transfer cache\n          transferCache: { includeHeaders: ['x-total-count'] },\n        })\n        .subscribe({\n          next: (res) => {\n            done();\n            toResponse(res.status, res.statusText, res.headers, res.body).then(resolve, reject);\n          },\n          error: (err: unknown) => {\n            done();\n            if (err instanceof HttpErrorResponse && err.status >= 200) {\n              toResponse(err.status, err.statusText, err.headers, err.error).then(resolve, reject);\n            } else {\n              reject(new TypeError('Failed to fetch', { cause: err }));\n            }\n          },\n        });\n    });\n}\n\nasync function toResponse(\n  status: number,\n  statusText: string,\n  httpHeaders: HttpHeaders,\n  body: unknown,\n): Promise<Response> {\n  const headers = new Headers();\n  for (const key of httpHeaders.keys()) {\n    for (const value of httpHeaders.getAll(key) ?? []) headers.append(key, value);\n  }\n  const noBody = status === 204 || status === 205 || status === 304;\n  return new Response(noBody ? null : await toBodyInit(body), { status, statusText, headers });\n}\n\n/**\n * Blob → its bytes (read through `arrayBuffer()`, so a Blob of another realm or polyfill works);\n * text / buffer as is; anything an interceptor turned into an object goes back to JSON.\n */\nasync function toBodyInit(body: unknown): Promise<BodyInit | null> {\n  if (body === null || body === undefined) return null;\n  if (typeof body === 'string' || body instanceof ArrayBuffer) return body;\n  if (typeof (body as Blob).arrayBuffer === 'function') return (body as Blob).arrayBuffer();\n  return JSON.stringify(body);\n}\n","import { PendingTasks } from '@angular/core';\nimport {\n  Skill3Http,\n  type HttpMethod,\n  type RequestOptions,\n  type RequestTarget,\n  type ResolvedSkill3Config,\n  type SessionStore,\n  type Skill3Response,\n  type Skill3State,\n} from '@skill3/sdk-core';\n\n/**\n * `Skill3Http` that keeps the app unstable while a request runs (retries and token renewals\n * included). Zoneless SSR waits only for `PendingTasks`, and the library awaits storage before\n * `HttpClient` registers its own task, so without this the page renders before the data arrives.\n */\nexport class PendingTasksHttp extends Skill3Http {\n  constructor(\n    config: ResolvedSkill3Config,\n    store: SessionStore,\n    state: Skill3State,\n    private readonly tasks: PendingTasks,\n  ) {\n    super(config, store, state);\n  }\n\n  override request<T = any>(\n    method: HttpMethod,\n    target: RequestTarget,\n    option?: RequestOptions,\n  ): Promise<Skill3Response<T>> {\n    // add() rather than run(): run() returns nothing and reports rejections to the ErrorHandler\n    const done = this.tasks.add();\n    return super.request<T>(method, target, option).finally(done);\n  }\n}\n","import { DestroyRef, Signal } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport {\n  AuthService as BaseAuthService,\n  CoreSiteService as BaseCoreSiteService,\n  type AuthKeyOption,\n  type Skill3Client,\n} from '@skill3/sdk-core';\nimport { valueToObservable, valueToSignal } from './interop';\n\n/**\n * `AuthService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.\n * Inject it: `inject(AuthService)` (registered by `provideSkill3()`).\n */\nexport class AuthService extends BaseAuthService {\n  /** Signed-in user as a signal (`null` when signed out). */\n  readonly user: Signal<any>;\n  /** Signed-in user as an observable (`null` when signed out). Emits the current user on subscribe. */\n  readonly user$: Observable<any>;\n\n  constructor(client: Skill3Client, destroyRef: DestroyRef) {\n    super(client.config, client.http, client.store, client.state);\n    this.user = valueToSignal(client.state.user, destroyRef);\n    this.user$ = valueToObservable(client.state.user);\n  }\n\n  /** Emits the stored user (when `dispatch`) and returns `user$`. */\n  async subscribeUser({\n    prefix_key,\n    dispatch = true,\n  }: AuthKeyOption & { dispatch?: boolean } = {}): Promise<Observable<any>> {\n    const user = await this.getUser({ prefix_key });\n    if (dispatch) this.state.setUser(user);\n    return this.user$;\n  }\n}\n\n/**\n * `CoreSiteService` of `@skill3/sdk-core` with the signal / observable API of ngx-core.\n * Inject it: `inject(CoreSiteService)` (registered by `provideSkill3()`).\n */\nexport class CoreSiteService extends BaseCoreSiteService {\n  /** true once a site token is known. */\n  readonly siteReady: Signal<boolean>;\n\n  constructor(client: Skill3Client, auth: AuthService, destroyRef: DestroyRef) {\n    super(client.config, client.http, client.store, client.state, auth);\n    this.siteReady = valueToSignal(client.state.siteReady, destroyRef);\n  }\n\n  /** Emits `true` now and every time an automatic site-token renewal finishes. */\n  onSiteTokenRenew(): Observable<boolean> {\n    return new Observable<boolean>((subscriber) =>\n      this.state.onSiteRenewed((renewed) => subscriber.next(renewed)),\n    );\n  }\n}\n","import { DestroyRef, Signal, signal } from '@angular/core';\nimport { Observable } from 'rxjs';\nimport type { ReadonlyValue } from '@skill3/sdk-core';\n\n/** Signal that follows `value` until `destroyRef` is destroyed. */\nexport function valueToSignal<T>(value: ReadonlyValue<T>, destroyRef: DestroyRef): Signal<T> {\n  const result = signal(value.get());\n  destroyRef.onDestroy(value.subscribe((next) => result.set(next)));\n  return result.asReadonly();\n}\n\n/** Observable that emits the current value on subscribe, then every change (like `BehaviorSubject`). */\nexport function valueToObservable<T>(value: ReadonlyValue<T>): Observable<T> {\n  return new Observable<T>((subscriber) => {\n    subscriber.next(value.get());\n    return value.subscribe((next) => subscriber.next(next));\n  });\n}\n","import { PLATFORM_ID, Provider, inject } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\nimport {\n  CustomStorageProvider,\n  LocalStorageProvider,\n  type StorageLike,\n  type StorageProvider as CoreStorageProvider,\n} from '@skill3/sdk-core';\n\n/**\n * DI token of the storage the library keeps tokens and cached user/site in:\n * `{ provide: StorageProvider, useClass: MyStorage }`. Any class with the methods works\n * (the storages of `@skill3/sdk-core` included), extending this one is optional.\n */\nexport abstract class StorageProvider implements CoreStorageProvider {\n  abstract get(key: string): Promise<string | null>;\n  abstract set(key: string, value: string): Promise<unknown>;\n  abstract remove(key: string): Promise<unknown>;\n  abstract clear(): Promise<void>;\n  abstract length(): Promise<number | null>;\n  abstract keys(): Promise<string[]>;\n}\n\n/** `storage` option that keeps the session in `localStorage` (memory on the server). */\nexport function provideLocalStorage(): Provider {\n  return {\n    provide: StorageProvider,\n    useFactory: () =>\n      new LocalStorageProvider(isPlatformBrowser(inject(PLATFORM_ID)) ? undefined : null),\n  };\n}\n\n/**\n * `storage` option that wraps a promise-based storage resolved from DI.\n *\n * ```ts\n * storage: provideCustomStorage(() => {\n *   const storage = inject(Storage); // @ionic/storage-angular\n *   storage.create();\n *   return storage;\n * })\n * ```\n */\nexport function provideCustomStorage(factory: () => StorageLike): Provider {\n  return { provide: StorageProvider, useFactory: () => new CustomStorageProvider(factory()) };\n}\n"],"mappings":"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","names":["DestroyRef","PLATFORM_ID","inject","HttpClient","Skill3Http","signal","Observable","Observable","inject","Skill3Http","DestroyRef","HttpClient","PLATFORM_ID"]}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@skill3/sdk-angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Angular bindings for @skill3/sdk-core (successor of @digione/ngx-core): provideSkill3, injectable services with signals and observables",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@skill3/sdk-core": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@angular/common": "^22.0.0",
+    "@angular/core": "^22.0.0",
+    "rxjs": "^7.4.0"
+  },
+  "devDependencies": {
+    "@angular/common": "^22.2.3",
+    "@angular/compiler": "^22.2.3",
+    "@angular/core": "^22.2.3",
+    "@angular/platform-browser": "^22.2.3",
+    "rxjs": "~7.8.0"
+  }
+}