@constantant/openapi-resource-mocks 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+## 0.1.1 (2026-06-08)
+
+### 🩹 Fixes
+
+- **openapi-resource-mocks:** add comment to empty destroy() to satisfy no-empty-function lint rule ([868fb39](https://github.com/constantant/angular-openapi-gen/commit/868fb39))
+
+### ❤️ Thank You
+
+- Claude Sonnet 4.6
+- kk
+
+# Changelog

package/README.md

@@ -0,0 +1,293 @@
+# @constantant/openapi-resource-mocks
+
+Mock bus for [`@constantant/openapi-resource-gen`](https://www.npmjs.com/package/@constantant/openapi-resource-gen) tokens.
+
+Provides zero-HTTP, pure-DI mocks for Angular `InjectionToken`-based data-access libs — with a cross-boundary API so **Playwright E2E tests** and a future **Chrome Extension devtools panel** can observe and control every token's state from outside the Angular context.
+
+---
+
+## Install
+
+```bash
+npm install -D @constantant/openapi-resource-mocks
+```
+
+Peer dependencies: `@angular/core >=22`, `@angular/common >=22`.
+
+---
+
+## Core concept
+
+Each mock token is registered in a `MockResourceBus`. The bus:
+
+- Exposes `window.__openApiMocks__` — a plain object keyed by token name, accessible from Playwright's `page.evaluate()` or a Chrome Extension content script.
+- Emits DOM events (`openapi-mock-event`) on every state change so the extension can observe in real time.
+- Listens for DOM events (`openapi-mock-control`) so the extension can push data into the app.
+
+---
+
+## Setup
+
+Add `provideMockResourceBus()` once, then one `provideMockResource()` per token:
+
+```typescript
+// app.config.mock.ts (used in tests / E2E variant)
+import { provideMockResourceBus, provideMockResource } from '@constantant/openapi-resource-mocks';
+import { FIND_PETS_BY_STATUS, UPLOAD_FILE } from '@myapp/petstore-data-access';
+
+export const mockProviders = [
+  provideMockResourceBus(),
+  provideMockResource(FIND_PETS_BY_STATUS, 'FIND_PETS_BY_STATUS'),
+  provideMockResource(UPLOAD_FILE, 'UPLOAD_FILE'),
+];
+```
+
+---
+
+## Unit tests / Storybook (in-process control)
+
+```typescript
+import { TestBed } from '@angular/core/testing';
+import { injectMockResource, provideMockResourceBus, provideMockResource } from '@constantant/openapi-resource-mocks';
+import type { FindPetsByStatusResponse } from '@myapp/petstore-data-access';
+
+TestBed.configureTestingModule({
+  providers: [
+    provideMockResourceBus(),
+    provideMockResource(FIND_PETS_BY_STATUS, 'FIND_PETS_BY_STATUS'),
+  ],
+});
+
+const mock = TestBed.runInInjectionContext(() =>
+  injectMockResource<FindPetsByStatusResponse>('FIND_PETS_BY_STATUS'),
+);
+
+// Preset states
+mock.resolve([{ id: 1, name: 'Rex', status: 'available' }]);
+mock.setLoading();
+mock.fail(new Error('network'));
+mock.reset();
+
+// Delayed response (loading → data after 500 ms)
+mock.resolveAfter(500, []);
+```
+
+Types come from the generated lib — no hand-written interfaces needed.
+
+---
+
+## File upload / download progress
+
+### In-process (unit tests / Storybook)
+
+```typescript
+const mock = TestBed.runInInjectionContext(() =>
+  injectMockResource<UploadResponse>('UPLOAD_FILE'),
+);
+
+// Animate through 10 steps over 2 s, then resolve
+mock.simulateProgress('upload', 4_000_000, 2000, { id: 'abc123' });
+
+// Or drive progress manually for precise test control
+mock.setProgress('upload', 1_000_000, 4_000_000); // 25 %
+mock.setProgress('upload', 4_000_000, 4_000_000); // 100 %
+mock.resolve({ id: 'abc123' });
+
+// Download progress (total unknown — streaming)
+mock.setProgress('download', 16_384);
+
+// Simulate failure mid-upload — progress is preserved so the UI can show "failed at 25%"
+mock.setProgress('upload', 1_000_000, 4_000_000);
+mock.fail(new Error('connection reset'));
+console.log(mock.progress()); // { type: 'upload', loaded: 1_000_000, total: 4_000_000 }
+```
+
+### E2E (Playwright)
+
+```typescript
+// Animate upload progress then resolve
+await page.evaluate(() =>
+  window.__openApiMocks__['UPLOAD_FILE'].simulateProgress('upload', 4_000_000, 2000, { id: 'abc123' }),
+);
+await expect(page.locator('[data-testid="progress-bar"]')).toBeVisible();
+
+// Manual steps
+await page.evaluate(() =>
+  window.__openApiMocks__['UPLOAD_FILE'].setProgress('upload', 1_000_000, 4_000_000),
+);
+await expect(page.locator('[data-testid="progress-bar"]')).toHaveAttribute('aria-valuenow', '25');
+
+// Fail mid-upload
+await page.evaluate(() => window.__openApiMocks__['UPLOAD_FILE'].fail(new Error('timeout')));
+const state = await page.evaluate(() => window.__openApiMocks__['UPLOAD_FILE'].getState());
+console.log(state.progress); // { type: 'upload', loaded: 1_000_000, total: 4_000_000 }
+```
+
+### Chrome Extension → app
+
+```javascript
+// Animate upload
+document.dispatchEvent(new CustomEvent('openapi-mock-control', {
+  detail: {
+    key: 'UPLOAD_FILE',
+    action: 'simulateProgress',
+    progressType: 'upload',
+    total: 4_000_000,
+    delayMs: 2000,
+    value: { id: 'abc123' },
+    steps: 20,        // optional, default 10
+  },
+}));
+
+// Single progress step
+document.dispatchEvent(new CustomEvent('openapi-mock-control', {
+  detail: { key: 'UPLOAD_FILE', action: 'setProgress', progressType: 'download', loaded: 512, total: 1024 },
+}));
+```
+
+---
+
+## E2E tests (Playwright)
+
+```typescript
+// Resolve with data
+await page.evaluate(() =>
+  window.__openApiMocks__['FIND_PETS_BY_STATUS'].resolve([
+    { id: 1, name: 'Rex', status: 'available' },
+  ]),
+);
+await expect(page.locator('mat-row')).toHaveCount(1);
+
+// Test loading skeleton
+await page.evaluate(() => window.__openApiMocks__['FIND_PETS_BY_STATUS'].setLoading());
+await expect(page.locator('mat-progress-bar')).toBeVisible();
+
+// Simulate slow network
+await page.evaluate(() =>
+  window.__openApiMocks__['FIND_PETS_BY_STATUS'].resolveAfter(1000, []),
+);
+
+// Inspect current state (includes progress if active)
+const state = await page.evaluate(() =>
+  window.__openApiMocks__['FIND_PETS_BY_STATUS'].getState(),
+);
+
+// Full event history (requests + responses + progress ticks)
+const history = await page.evaluate(() =>
+  window.__openApiMocks__['FIND_PETS_BY_STATUS'].getHistory(),
+);
+```
+
+---
+
+## Chrome Extension integration
+
+**Extension content script → app (control):**
+
+```javascript
+document.dispatchEvent(new CustomEvent('openapi-mock-control', {
+  detail: { key: 'FIND_PETS_BY_STATUS', action: 'resolve', value: [...] },
+}));
+// actions: resolve | resolveAfter | setLoading | fail | reset
+//          setProgress | simulateProgress
+// resolveAfter:     delayMs: number
+// setProgress:      progressType: 'upload'|'download', loaded: number, total?: number
+// simulateProgress: progressType, total: number, delayMs: number, value, steps?: number
+```
+
+**App → extension (observe):**
+
+```javascript
+document.addEventListener('openapi-mock-event', (e) => {
+  const { key, event } = e.detail;
+  // event.type: 'request' | 'resolve' | 'loading' | 'error' | 'reset' | 'progress'
+  devtoolsPanel.update(key, event);
+});
+```
+
+---
+
+## API reference
+
+### `provideMockResourceBus()`
+
+Returns `EnvironmentProviders`. Call once in your root providers or TestBed setup.
+
+### `provideMockResource(token, key, initialState?)`
+
+Returns `FactoryProvider`. Registers `token` in the bus under `key`.
+
+`initialState` can be `{ value: T }`, `{ loading: true }`, or `{ error: unknown }`.
+
+### `injectMockResource<T>(key)`
+
+Must be called inside an injection context (e.g. `TestBed.runInInjectionContext`). Returns `MockResourceRef<T>`.
+
+### `createMockResourceRef<T>(initialState?)`
+
+Creates a standalone ref without the bus — useful when passing the ref to `provideMockResource` yourself for fine-grained test setup.
+
+### `MockResourceRef<T>`
+
+| Member | Description |
+|--------|-------------|
+| `value: Signal<T \| undefined>` | Current response data |
+| `status: Signal<ResourceStatus>` | `'idle' \| 'loading' \| 'reloading' \| 'resolved' \| 'error' \| 'local'` |
+| `error: Signal<unknown>` | Current error, if any |
+| `isLoading: Signal<boolean>` | `true` while status is `'loading'` or `'reloading'` |
+| `progress: Signal<MockProgress \| undefined>` | Current transfer progress, if active |
+| `hasValue(): boolean` | `true` when value is set |
+| `resolve(value: T)` | Set value, clear error and progress → `'resolved'` |
+| `resolveAfter(ms, value)` | Set loading immediately, resolve after delay |
+| `setLoading()` | Clear error → `'loading'` |
+| `fail(error)` | Set error → `'error'` (progress preserved) |
+| `reset()` | Clear all including progress → `'idle'` |
+| `setProgress(type, loaded, total?)` | Set progress and status → `'loading'` |
+| `simulateProgress(type, totalBytes, durationMs, finalValue, steps?)` | Animate incremental progress over `durationMs` ms then resolve |
+| `set(value)` | Local mutation → `'local'` (ResourceRef interface) |
+| `update(fn)` | Local update → `'local'` (ResourceRef interface) |
+| `onRequest(cb)` | Subscribe to factory invocations; returns unsubscribe fn |
+| `reload()` | No-op, returns `false` |
+
+### `MockProgress`
+
+```typescript
+interface MockProgress {
+  type: 'upload' | 'download';
+  loaded: number;   // bytes transferred
+  total?: number;   // total bytes (undefined for streaming / unknown-length responses)
+}
+```
+
+### `window.__openApiMocks__[key]`
+
+| Member | Description |
+|--------|-------------|
+| `resolve(value)` | Set value (JSON-serializable) |
+| `resolveAfter(ms, value)` | Delayed resolve |
+| `setLoading()` | Start loading state |
+| `fail(error)` | Set error state |
+| `reset()` | Return to idle |
+| `setProgress(type, loaded, total?)` | Set transfer progress |
+| `simulateProgress(type, totalBytes, durationMs, finalValue, steps?)` | Animate progress then resolve |
+| `getState()` | `{ status, value, error, progress }` snapshot |
+| `getHistory()` | Array of all `MockEvent` entries (requests, responses, progress ticks) |
+| `onEvent(cb)` | Subscribe to all events; returns unsubscribe fn |
+
+### `MockEvent` types
+
+```typescript
+type MockEvent =
+  | { type: 'request';  args: unknown[]; ts: number }   // factory called by component
+  | { type: 'resolve';  value: unknown; ts: number }
+  | { type: 'loading';  ts: number }
+  | { type: 'error';    error: unknown; ts: number }
+  | { type: 'reset';    ts: number }
+  | { type: 'progress'; progressType: 'upload' | 'download'; loaded: number; total?: number; ts: number };
+```
+
+---
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@constantant/openapi-resource-mocks",
+  "version": "0.1.1",
+  "description": "Mock bus for @constantant/openapi-resource-gen tokens — unit tests, E2E, and Chrome Extension devtools",
+  "license": "MIT",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=22.0.0",
+    "@angular/core": ">=22.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "keywords": [
+    "angular",
+    "testing",
+    "mock",
+    "httpResource",
+    "InjectionToken",
+    "openapi",
+    "e2e",
+    "devtools"
+  ],
+  "type": "commonjs"
+}

package/src/index.d.ts

@@ -0,0 +1,7 @@
+export { createMockResourceRef } from './lib/mock-resource-ref';
+export type { MockResourceRef, MockResourceRefInternal, MockResourceState } from './lib/mock-resource-ref';
+export { MockResourceBus, provideMockResourceBus } from './lib/mock-resource-bus';
+export type { WindowMockEntry } from './lib/mock-resource-bus';
+export { provideMockResource } from './lib/provide-mock-resource';
+export { injectMockResource } from './lib/inject-mock-resource';
+export type { MockEvent, MockProgress } from './lib/mock-events';

package/src/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectMockResource = exports.provideMockResource = exports.provideMockResourceBus = exports.MockResourceBus = exports.createMockResourceRef = void 0;
+var mock_resource_ref_1 = require("./lib/mock-resource-ref");
+Object.defineProperty(exports, "createMockResourceRef", { enumerable: true, get: function () { return mock_resource_ref_1.createMockResourceRef; } });
+var mock_resource_bus_1 = require("./lib/mock-resource-bus");
+Object.defineProperty(exports, "MockResourceBus", { enumerable: true, get: function () { return mock_resource_bus_1.MockResourceBus; } });
+Object.defineProperty(exports, "provideMockResourceBus", { enumerable: true, get: function () { return mock_resource_bus_1.provideMockResourceBus; } });
+var provide_mock_resource_1 = require("./lib/provide-mock-resource");
+Object.defineProperty(exports, "provideMockResource", { enumerable: true, get: function () { return provide_mock_resource_1.provideMockResource; } });
+var inject_mock_resource_1 = require("./lib/inject-mock-resource");
+Object.defineProperty(exports, "injectMockResource", { enumerable: true, get: function () { return inject_mock_resource_1.injectMockResource; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../tools/openapi-resource-mocks/src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAgE;AAAvD,0HAAA,qBAAqB,OAAA;AAE9B,6DAAkF;AAAzE,oHAAA,eAAe,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAEhD,qEAAkE;AAAzD,4HAAA,mBAAmB,OAAA;AAC5B,mEAAgE;AAAvD,0HAAA,kBAAkB,OAAA"}

package/src/lib/inject-mock-resource.d.ts

@@ -0,0 +1,2 @@
+import type { MockResourceRef } from './mock-resource-ref';
+export declare function injectMockResource<T>(key: string): MockResourceRef<T>;

package/src/lib/inject-mock-resource.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectMockResource = injectMockResource;
+const core_1 = require("@angular/core");
+const mock_resource_bus_1 = require("./mock-resource-bus");
+function injectMockResource(key) {
+    const bus = (0, core_1.inject)(mock_resource_bus_1.MockResourceBus);
+    const ref = bus.get(key);
+    if (!ref) {
+        throw new Error(`[openapi-resource-mocks] No mock registered for key "${key}". ` +
+            `Ensure provideMockResource(token, "${key}") is in the providers array ` +
+            `before calling injectMockResource("${key}").`);
+    }
+    return ref;
+}
+//# sourceMappingURL=inject-mock-resource.js.map

package/src/lib/inject-mock-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-mock-resource.js","sourceRoot":"","sources":["../../../../../tools/openapi-resource-mocks/src/lib/inject-mock-resource.ts"],"names":[],"mappings":";;AAIA,gDAWC;AAfD,wCAAuC;AACvC,2DAAsD;AAGtD,SAAgB,kBAAkB,CAAI,GAAW;IAC/C,MAAM,GAAG,GAAG,IAAA,aAAM,EAAC,mCAAe,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,wDAAwD,GAAG,KAAK;YAC9D,sCAAsC,GAAG,+BAA+B;YACxE,sCAAsC,GAAG,KAAK,CACjD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/src/lib/mock-events.d.ts

@@ -0,0 +1,30 @@
+export type MockEvent = {
+    type: 'request';
+    args: unknown[];
+    ts: number;
+} | {
+    type: 'resolve';
+    value: unknown;
+    ts: number;
+} | {
+    type: 'loading';
+    ts: number;
+} | {
+    type: 'error';
+    error: unknown;
+    ts: number;
+} | {
+    type: 'reset';
+    ts: number;
+} | {
+    type: 'progress';
+    progressType: 'upload' | 'download';
+    loaded: number;
+    total?: number;
+    ts: number;
+};
+export interface MockProgress {
+    type: 'upload' | 'download';
+    loaded: number;
+    total?: number;
+}

package/src/lib/mock-events.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mock-events.js.map

package/src/lib/mock-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-events.js","sourceRoot":"","sources":["../../../../../tools/openapi-resource-mocks/src/lib/mock-events.ts"],"names":[],"mappings":""}

package/src/lib/mock-resource-bus.d.ts

@@ -0,0 +1,34 @@
+import { EnvironmentProviders } from '@angular/core';
+import type { MockResourceRef } from './mock-resource-ref';
+import type { MockEvent } from './mock-events';
+export interface WindowMockEntry {
+    resolve(value: unknown): void;
+    resolveAfter(delayMs: number, value: unknown): void;
+    setLoading(): void;
+    fail(error: unknown): void;
+    reset(): void;
+    setProgress(type: 'upload' | 'download', loaded: number, total?: number): void;
+    simulateProgress(type: 'upload' | 'download', totalBytes: number, durationMs: number, finalValue: unknown, steps?: number): void;
+    getState(): {
+        status: string;
+        value: unknown;
+        error: unknown;
+        progress: unknown;
+    };
+    getHistory(): MockEvent[];
+    onEvent(cb: (event: MockEvent) => void): () => void;
+}
+declare global {
+    interface Window {
+        __openApiMocks__?: Record<string, WindowMockEntry>;
+    }
+}
+export declare class MockResourceBus {
+    private readonly refs;
+    register<T>(key: string, ref: MockResourceRef<T>): void;
+    get<T>(key: string): MockResourceRef<T> | undefined;
+    private exposeToWindow;
+    private dispatchDomEvent;
+    constructor();
+}
+export declare function provideMockResourceBus(): EnvironmentProviders;

package/src/lib/mock-resource-bus.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockResourceBus = void 0;
+exports.provideMockResourceBus = provideMockResourceBus;
+const core_1 = require("@angular/core");
+class MockResourceBus {
+    refs = new Map();
+    register(key, ref) {
+        const internal = ref;
+        this.refs.set(key, internal);
+        this.exposeToWindow(key, internal);
+    }
+    get(key) {
+        return this.refs.get(key);
+    }
+    exposeToWindow(key, ref) {
+        window.__openApiMocks__ ??= {};
+        const history = [];
+        const listeners = new Set();
+        const emit = (e) => {
+            history.push(e);
+            listeners.forEach((cb) => cb(e));
+            this.dispatchDomEvent(key, e);
+        };
+        ref.onRequest((args) => emit({ type: 'request', args, ts: Date.now() }));
+        window.__openApiMocks__[key] = {
+            resolve: (v) => { ref.resolve(v); emit({ type: 'resolve', value: v, ts: Date.now() }); },
+            resolveAfter: (ms, v) => { ref.resolveAfter(ms, v); },
+            setLoading: () => { ref.setLoading(); emit({ type: 'loading', ts: Date.now() }); },
+            fail: (e) => { ref.fail(e); emit({ type: 'error', error: e, ts: Date.now() }); },
+            reset: () => { ref.reset(); emit({ type: 'reset', ts: Date.now() }); },
+            setProgress: (pt, l, t) => {
+                ref.setProgress(pt, l, t);
+                emit({ type: 'progress', progressType: pt, loaded: l, total: t, ts: Date.now() });
+            },
+            simulateProgress: (pt, total, dur, v, steps) => {
+                ref.simulateProgress(pt, total, dur, v, steps);
+            },
+            getState: () => ({
+                status: String(ref.status()),
+                value: ref.value(),
+                error: ref.error(),
+                progress: ref.progress(),
+            }),
+            getHistory: () => [...history],
+            onEvent: (cb) => { listeners.add(cb); return () => listeners.delete(cb); },
+        };
+    }
+    dispatchDomEvent(key, event) {
+        if (typeof document === 'undefined')
+            return;
+        document.dispatchEvent(new CustomEvent('openapi-mock-event', { detail: { key, event } }));
+    }
+    constructor() {
+        if (typeof document === 'undefined')
+            return;
+        document.addEventListener('openapi-mock-control', (e) => {
+            const detail = e.detail;
+            const ref = this.refs.get(detail.key);
+            if (!ref)
+                return;
+            switch (detail.action) {
+                case 'resolve':
+                    ref.resolve(detail.value);
+                    break;
+                case 'resolveAfter':
+                    ref.resolveAfter(detail.delayMs ?? 0, detail.value);
+                    break;
+                case 'setLoading':
+                    ref.setLoading();
+                    break;
+                case 'fail':
+                    ref.fail(detail.value);
+                    break;
+                case 'reset':
+                    ref.reset();
+                    break;
+                case 'setProgress':
+                    ref.setProgress(detail.progressType, detail.loaded, detail.total);
+                    break;
+                case 'simulateProgress':
+                    ref.simulateProgress(detail.progressType, detail.total, detail.delayMs ?? 1000, detail.value, detail.steps);
+                    break;
+            }
+        });
+    }
+}
+exports.MockResourceBus = MockResourceBus;
+function provideMockResourceBus() {
+    return (0, core_1.makeEnvironmentProviders)([
+        { provide: MockResourceBus, useFactory: () => new MockResourceBus() },
+    ]);
+}
+//# sourceMappingURL=mock-resource-bus.js.map

package/src/lib/mock-resource-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-resource-bus.js","sourceRoot":"","sources":["../../../../../tools/openapi-resource-mocks/src/lib/mock-resource-bus.ts"],"names":[],"mappings":"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"}

package/src/lib/mock-resource-ref.d.ts

@@ -0,0 +1,35 @@
+import { Signal } from '@angular/core';
+import type { ResourceStatus } from '@angular/core';
+import type { MockProgress } from './mock-events';
+export type MockResourceState<T> = {
+    value: T;
+} | {
+    loading: true;
+} | {
+    error: unknown;
+};
+export interface MockResourceRef<T> {
+    readonly value: Signal<T | undefined>;
+    readonly status: Signal<ResourceStatus>;
+    readonly error: Signal<unknown>;
+    readonly isLoading: Signal<boolean>;
+    readonly progress: Signal<MockProgress | undefined>;
+    hasValue(): boolean;
+    reload(): boolean;
+    destroy(): void;
+    set(value: T): void;
+    update(updater: (value: T | undefined) => T): void;
+    asReadonly(): MockResourceRef<T>;
+    resolve(value: T): void;
+    resolveAfter(delayMs: number, value: T): void;
+    setLoading(): void;
+    fail(error: unknown): void;
+    reset(): void;
+    setProgress(type: 'upload' | 'download', loaded: number, total?: number): void;
+    simulateProgress(type: 'upload' | 'download', totalBytes: number, durationMs: number, finalValue: T, steps?: number): void;
+    onRequest(cb: (args: unknown[]) => void): () => void;
+}
+export interface MockResourceRefInternal<T> extends MockResourceRef<T> {
+    _notifyRequest(args: unknown[]): void;
+}
+export declare function createMockResourceRef<T>(initialState?: MockResourceState<T>): MockResourceRef<T>;

package/src/lib/mock-resource-ref.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMockResourceRef = createMockResourceRef;
+const core_1 = require("@angular/core");
+function createMockResourceRef(initialState) {
+    const _status = (0, core_1.signal)('idle');
+    const _value = (0, core_1.signal)(undefined);
+    const _error = (0, core_1.signal)(undefined);
+    const _progress = (0, core_1.signal)(undefined);
+    const requestListeners = new Set();
+    if (initialState) {
+        if ('value' in initialState) {
+            _value.set(initialState.value);
+            _status.set('resolved');
+        }
+        else if ('loading' in initialState) {
+            _status.set('loading');
+        }
+        else if ('error' in initialState) {
+            _error.set(initialState.error);
+            _status.set('error');
+        }
+    }
+    const ref = {
+        value: _value.asReadonly(),
+        status: _status.asReadonly(),
+        error: _error.asReadonly(),
+        progress: _progress.asReadonly(),
+        isLoading: (0, core_1.computed)(() => _status() === 'loading' || _status() === 'reloading'),
+        hasValue: () => _value() !== undefined,
+        resolve(v) {
+            _value.set(v);
+            _error.set(undefined);
+            _progress.set(undefined);
+            _status.set('resolved');
+        },
+        resolveAfter(ms, v) {
+            ref.setLoading();
+            setTimeout(() => ref.resolve(v), ms);
+        },
+        setLoading() {
+            _error.set(undefined);
+            _status.set('loading');
+        },
+        fail(e) {
+            _error.set(e);
+            // progress intentionally kept — shows where transfer was when it failed
+            _status.set('error');
+        },
+        reset() {
+            _value.set(undefined);
+            _error.set(undefined);
+            _progress.set(undefined);
+            _status.set('idle');
+        },
+        set(v) {
+            _value.set(v);
+            _status.set('local');
+        },
+        update(fn) {
+            _value.update(fn);
+            _status.set('local');
+        },
+        setProgress(type, loaded, total) {
+            _progress.set({ type, loaded, total });
+            _status.set('loading');
+        },
+        simulateProgress(type, totalBytes, durationMs, finalValue, steps = 10) {
+            ref.setLoading();
+            const stepDelay = durationMs / steps;
+            for (let i = 1; i <= steps; i++) {
+                setTimeout(() => {
+                    ref.setProgress(type, Math.round((totalBytes / steps) * i), totalBytes);
+                }, stepDelay * i);
+            }
+            setTimeout(() => ref.resolve(finalValue), durationMs + stepDelay);
+        },
+        reload: () => false,
+        destroy: () => { },
+        asReadonly: () => ref,
+        onRequest: (cb) => {
+            requestListeners.add(cb);
+            return () => requestListeners.delete(cb);
+        },
+        _notifyRequest: (args) => {
+            requestListeners.forEach((cb) => cb(args));
+        },
+    };
+    return ref;
+}
+//# sourceMappingURL=mock-resource-ref.js.map

package/src/lib/mock-resource-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-resource-ref.js","sourceRoot":"","sources":["../../../../../tools/openapi-resource-mocks/src/lib/mock-resource-ref.ts"],"names":[],"mappings":"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"}

package/src/lib/provide-mock-resource.d.ts

@@ -0,0 +1,4 @@
+import { InjectionToken, FactoryProvider } from '@angular/core';
+import { httpResource } from '@angular/common/http';
+import { type MockResourceState } from './mock-resource-ref';
+export declare function provideMockResource<T>(token: InjectionToken<(...args: unknown[]) => ReturnType<typeof httpResource<T>>>, key: string, initialState?: MockResourceState<T>): FactoryProvider;

package/src/lib/provide-mock-resource.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provideMockResource = provideMockResource;
+const core_1 = require("@angular/core");
+const mock_resource_bus_1 = require("./mock-resource-bus");
+const mock_resource_ref_1 = require("./mock-resource-ref");
+function provideMockResource(token, key, initialState) {
+    return {
+        provide: token,
+        useFactory: () => {
+            const bus = (0, core_1.inject)(mock_resource_bus_1.MockResourceBus);
+            const ref = (0, mock_resource_ref_1.createMockResourceRef)(initialState);
+            bus.register(key, ref);
+            return (...args) => {
+                ref._notifyRequest(args);
+                return ref;
+            };
+        },
+    };
+}
+//# sourceMappingURL=provide-mock-resource.js.map

package/src/lib/provide-mock-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide-mock-resource.js","sourceRoot":"","sources":["../../../../../tools/openapi-resource-mocks/src/lib/provide-mock-resource.ts"],"names":[],"mappings":";;AASA,kDAiBC;AA1BD,wCAAwE;AAExE,2DAAsD;AACtD,2DAI6B;AAE7B,SAAgB,mBAAmB,CACjC,KAAiF,EACjF,GAAW,EACX,YAAmC;IAEnC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,GAAG,EAAE;YACf,MAAM,GAAG,GAAG,IAAA,aAAM,EAAC,mCAAe,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,IAAA,yCAAqB,EAAI,YAAY,CAAC,CAAC;YACnD,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,IAAe,EAAsC,EAAE;gBAC/D,GAAkC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBACzD,OAAO,GAAoD,CAAC;YAC9D,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}