active-svelte

Commit Graph

Author	SHA1	Message	Date
dev	f1055842dd	Bloque A — sweep stale aliases and `App.<Capitalized>` references Audit P1: documentation must stop teaching APIs the runtime no longer exposes. The svelte.config.js aliases are full words now (`$cache`, `$session`, `$connection`, `$timer`, `$logger`, `$format`, `$storage`, `$active-app`, `$bus`); the legacy 4-letter forms (`$cach`, `$sess`, `$conn`, `$timr`, `$logr`, `$fmts`, `$stor`, `$aapp`, `$buss`) were retired earlier but still lived in READMEs, demo pages, comments and a few code docstrings. Likewise, the `App.<service>` surface is lowercase for declarable services. The capitalized form is reserved for the four-piece core (`Logger`, `Bus`, `Timers`, `Orca`). References like `App.Cache`, `App.Sess`, `App.Storage`, `App.Format`, `App.Frontend`, `App.Lang`, `App.Auth`, `App.Perms`, `App.Http`, `App.Dom`, `App.Sium` were either ported to the new lowercase or migrated where it made sense. Mechanical sweep across `src/`, then a guard script: - `scripts/check-aliases.mjs` walks `src/`, fails the run if any forbidden alias or `App.<forbidden capitalized>` appears in any `.ts` / `.svelte` / `.md` / `.txt` / `.js` / `.mjs` file. `arts/active-app/types.ts` is allowlisted because its block comment explicitly documents the legacy uppercase surface as "removed". - `npm run test:aliases` exposes the script. - `npm run test:all` now includes the alias check. No runtime change; tests still 1486 / 1486. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	5 months ago
dev	c5dd0e337c	Add arts/timr, arts/sess, arts/http; sess actor extension; aapp factory New artifacts: arts/timr — runtime timer scheduler (singleton-per-App, never global). Engine + Active split. Race-safe via (id, key, version) guard against stale native callbacks, async tasks resolving after cancel/replace, interval ticks scheduled after dispose, and ack-style timeouts. Per- entry AbortController; intervals reuse the signal across ticks. awaitTask:true (default, no overlap) vs awaitTask:false (fire-and- forget cadence; failures don't stop the interval — semantic frozen). Recursive setTimeout for intervals. scheduleAt(past) → delay 0 (no error). Fake-clock injectable for deterministic tests. Pure computeBackoffDelay helper. 50 server tests + 7 browser tests + full README + DESIGN_TIMR + interactive test page at /test/timr. arts/sess — session lifecycle with three generics (TUser/TCredential/TData) plus optional SessionActor metadata (kind/source/confidence — orthogonal axis to identity). Tagged AdoptResult/RefreshResult/RevokeResult; never void. Generation guard against stale refresh from local cancel, cross-tab storage events, or re-adopt. onRefresh contract (null=fatal, throw=transient). onRevoke replaces revokeUrl (consumer controls fetch; engine just gets boolean). Default scope: 'global' when onRevoke configured. INITIAL_SESSION sync dispatch on subscribe. BroadcastChannel payload: {type, event, generation} only — never tokens. SSR cookie reader validates invariants. withAutoRefresh helper, 401-retry hook with applyAuth + loop guard, JWT exp helper. 103 tests (60 server + 5 browser + 38 actor/error/etc) + README + DESIGN.md + test page at /test/sess. arts/http — HTTP client with Standard Schema body validation, retry + Retry-After, attempt + total timeout via AbortSignal composition, hooks (beforeRequest/beforeRetry/afterResponse/beforeError), tagged HttpResult. Test page at /test/http. arts/conn — DESIGN_CONN.md only (no implementation yet). aapp: - App.createActiveSession<TUser, TCredential, TData>(opts) factory auto-injects App.Logger; throws SessAlreadyCreatedError on second call. App.Sess getter exposes the active session (undefined until first call). Auto-disposed by App.dispose(). - App.Timers integration deferred to timr Fase 3. libs/days: - toEpochMs(value) — permissive coercion (number \| Date \| string) → epoch ms. Exposed alongside the existing day/calendar helpers. Other: - sium examples moved to _examples/ (excluded from public surface). - sium-provider.svelte test removed (port pending; tracked elsewhere). - libs/env.ts — DEV flag single source of truth. - Various README touch-ups across artifacts. All artifacts: 1021 server tests + 12 browser tests; svelte-check + ESLint clean. The 9 server "errors" are pre-existing jsdom missing — unrelated. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	6 months ago

Author

SHA1

Message

Date

dev

f1055842dd

Bloque A — sweep stale aliases and `App.<Capitalized>` references

Audit P1: documentation must stop teaching APIs the runtime no
longer exposes. The svelte.config.js aliases are full words now
(`$cache`, `$session`, `$connection`, `$timer`, `$logger`,
`$format`, `$storage`, `$active-app`, `$bus`); the legacy 4-letter
forms (`$cach`, `$sess`, `$conn`, `$timr`, `$logr`, `$fmts`,
`$stor`, `$aapp`, `$buss`) were retired earlier but still lived in
READMEs, demo pages, comments and a few code docstrings.

Likewise, the `App.<service>` surface is lowercase for declarable
services. The capitalized form is reserved for the four-piece core
(`Logger`, `Bus`, `Timers`, `Orca`). References like `App.Cache`,
`App.Sess`, `App.Storage`, `App.Format`, `App.Frontend`, `App.Lang`,
`App.Auth`, `App.Perms`, `App.Http`, `App.Dom`, `App.Sium` were
either ported to the new lowercase or migrated where it made sense.

Mechanical sweep across `src/`, then a guard script:
- `scripts/check-aliases.mjs` walks `src/`, fails the run if any
  forbidden alias or `App.<forbidden capitalized>` appears in any
  `.ts` / `.svelte` / `.md` / `.txt` / `.js` / `.mjs` file.
  `arts/active-app/types.ts` is allowlisted because its block
  comment explicitly documents the legacy uppercase surface as
  "removed".
- `npm run test:aliases` exposes the script.
- `npm run test:all` now includes the alias check.

No runtime change; tests still 1486 / 1486.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

dev

c5dd0e337c

Add arts/timr, arts/sess, arts/http; sess actor extension; aapp factory

New artifacts:

  arts/timr — runtime timer scheduler (singleton-per-App, never global).
    Engine + Active split. Race-safe via (id, key, version) guard against
    stale native callbacks, async tasks resolving after cancel/replace,
    interval ticks scheduled after dispose, and ack-style timeouts. Per-
    entry AbortController; intervals reuse the signal across ticks.
    awaitTask:true (default, no overlap) vs awaitTask:false (fire-and-
    forget cadence; failures don't stop the interval — semantic frozen).
    Recursive setTimeout for intervals. scheduleAt(past) → delay 0 (no
    error). Fake-clock injectable for deterministic tests. Pure
    computeBackoffDelay helper. 50 server tests + 7 browser tests + full
    README + DESIGN_TIMR + interactive test page at /test/timr.

  arts/sess — session lifecycle with three generics
    (TUser/TCredential/TData) plus optional SessionActor metadata
    (kind/source/confidence — orthogonal axis to identity).
    Tagged AdoptResult/RefreshResult/RevokeResult; never void.
    Generation guard against stale refresh from local cancel, cross-tab
    storage events, or re-adopt. onRefresh contract (null=fatal,
    throw=transient). onRevoke replaces revokeUrl (consumer controls
    fetch; engine just gets boolean). Default scope: 'global' when
    onRevoke configured. INITIAL_SESSION sync dispatch on subscribe.
    BroadcastChannel payload: {type, event, generation} only — never
    tokens. SSR cookie reader validates invariants. withAutoRefresh
    helper, 401-retry hook with applyAuth + loop guard, JWT exp helper.
    103 tests (60 server + 5 browser + 38 actor/error/etc) + README +
    DESIGN.md + test page at /test/sess.

  arts/http — HTTP client with Standard Schema body validation, retry
    + Retry-After, attempt + total timeout via AbortSignal composition,
    hooks (beforeRequest/beforeRetry/afterResponse/beforeError),
    tagged HttpResult. Test page at /test/http.

  arts/conn — DESIGN_CONN.md only (no implementation yet).

aapp:
  - App.createActiveSession<TUser, TCredential, TData>(opts) factory
    auto-injects App.Logger; throws SessAlreadyCreatedError on second
    call. App.Sess getter exposes the active session (undefined until
    first call). Auto-disposed by App.dispose().
  - App.Timers integration deferred to timr Fase 3.

libs/days:
  - toEpochMs(value) — permissive coercion (number | Date | string) →
    epoch ms. Exposed alongside the existing day/calendar helpers.

Other:
  - sium examples moved to _examples/ (excluded from public surface).
  - sium-provider.svelte test removed (port pending; tracked elsewhere).
  - libs/env.ts — DEV flag single source of truth.
  - Various README touch-ups across artifacts.

All artifacts: 1021 server tests + 12 browser tests; svelte-check + ESLint
clean. The 9 server "errors" are pre-existing jsdom missing — unrelated.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2 Commits (49bfa6bd8fb6f57a0fa4beb3e6e1c23c9fa436bd)