Skip to content

Releases

Release v1.16.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 21:17

v1.16.0

Changelog

Identifier-keyed push subscription port (REQ-ARCH-001 rule 3). No change is required: an existing
PushSubscriptionProviderInterface keeps working. See UPGRADING.

Added

  • PushRecipientSubscriptionProviderInterface (findRecipientSubscriptions(string $userIdentifier),
    removeRecipientSubscription(string $userIdentifier, PushSubscriptionData)): the push test endpoint looks
    subscriptions up by the authenticated user's identifier, with no Symfony security type in the port. It is preferred
    when the host defines it (also when the same class implements the old port).
  • Internal LegacyPushSubscriptionProviderAdapter (wired by PushSubscriptionProviderPass) bridges a host
    PushSubscriptionProviderInterface: it only answers for the user of the current security token and passes that same
    user object, so recipients are exactly those of 1.15 and a push never reaches another user's devices.

Deprecated

  • PushSubscriptionProviderInterface (keyed by Symfony\Component\Security\Core\User\UserInterface), removed in
    2.0. Implement PushRecipientSubscriptionProviderInterface instead; a deprecation is triggered when the adapter is
    built.

Tests

  • Equivalence of the old and new ports (PushRecipientPortEquivalenceTest: same responses, sent endpoints and
    removals per scenario, users alternating on one controller), adapter tests, and a DDD host kernel test
    (DddHostPushTest: XML-mapped host entity on a dedicated entity manager, user referenced by id, only the new port;
    1,500 requests alternating alice, bob and a guest on one kernel without services_resetter, flat memory).

Documentation

  • USAGE: "Standard Symfony host" and "DDD / hexagonal host" sections; examples use the new port.
  • USAGE: new section "Using it from a DDD / hexagonal application" (where the bundle sits in a hexagonal host, the ports, events and DTOs to build an anti-corruption layer on, and the known limitations).

What's Changed

  • chore(deps): bump the phpstan group with 2 updates by @dependabot[bot] in #67
  • chore(deps): Dependabot batch 2026-11-09 by @HecFranco in #72
  • ci: run the PR title check on pull_request by @HecFranco in #74
  • docs: using it from a DDD / hexagonal application by @HecFranco in #73
  • ci: run the igor worker-state audit by @HecFranco in #75
  • feat(webpush): identifier-keyed push subscription port (REQ-ARCH-001) by @HecFranco in #76

Full Changelog: v1.15.0...v1.16.0

Release v1.15.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 23:58

v1.15.0

Changelog

Optional brand consumer (spec 220 S4). No change for hosts without a nowo-tech/brand-contracts brand provider. See
UPGRADING.

Added

  • Brand from a BrandProviderInterface service (nowo-tech/brand-contracts ^1.0, optional): when the app has a
    brand provider (InstanceSettingsBundle's opt-in brand bridge, or a small host class), the manifest and the head tags
    read the brand. The nowo_pwa configuration stays the fallback for everything the brand does not give, and for
    everything when there is no provider or the provider fails (the error is logged, the manifest and the page never
    fail because of the brand).
    • Manifest (new BrandManifestOverlayProvider, tag nowo_pwa.manifest_overlay_provider, priority 1024, so host
      overlays still run after it): theme_color from the light primary, background_color from the light paper,
      and icons from the app_icon slot (after the contract's fallback chain to a square mark of 512 px or more)
      when it is PNG, JPEG or WebP, square and at least 192 px: one any entry and, for an app_icon of 512 px or
      more, one maskable entry. SVG, ICO and other images are never used as icons; the configured manifest.icons
      then stay. name and short_name come from the brand only when it is not the default brand (Beacon's rule),
      unless brand.override_name: true.
    • Head (nowo_pwa_head() and the context of the install prompt and links): the two theme-color meta tags from
      the light and dark paper, the same manifest values, the Apple title from the brand short name when the name
      applies, the brand icon as apple-touch-icon where the configuration declares one, and the manifest URL with
      ?v=<Brand::$version>, so browsers fetch the new manifest as soon as the brand changes.
    • Manifest HTTP cache: with a brand, the response carries an ETag built from Brand::$version and a hash of the
      body, and a matching If-None-Match gets a 304. Cache-Control is unchanged.
  • nowo_pwa.brand: mode: auto (default) or off, override_name: false (default). brand: off is accepted as a
    shorthand.
  • nowo-tech/brand-contracts in require-dev and suggest, with a conflict on <1.0 || >=2.0.

Security

  • The brand values reach the manifest only through JsonResponse's escaping (<, >, &, quotes as \u00XX) and the
    head only through Twig auto-escaping; colours are #rrggbb (contract-checked); icon URLs are re-checked with
    BrandAsset::isSafeUrl() (root-relative or https:// only); only raster icons are used. Audited: Appendix IU,
    Pass-Low. IU-L2: the icons use the full-size original upload until BrandContracts 1.1 adds variant URLs; IU-I6 / IU-I7
    (overlay scope and per-session providers) are documented in USAGE and SECURITY.

What's Changed

  • feat(brand): optional brand-contracts consumer for the manifest and head tags (spec 220 S4) by @HecFranco in #66

Full Changelog: v1.14.1...v1.15.0

Release v1.14.1

Choose a tag to compare

@github-actions github-actions released this 08 Nov 12:10

v1.14.1

Changelog

"Not now" works in the modal install prompt (HC-L1).

Fixed

  • Install prompt, display: modal: the "Not now" button now stores the dismissal and closes the prompt. Every element with an install action is bound, not only the first one; in modal mode the backdrop came first and took the only dismiss-remind listener (audit HC-L1, Low, since 1.1.0). pwa.js rebuilt. No change in banner or flash mode, nor in the markup.

Security

  • HC-L1 fix. Audited: Appendix IE, Pass (good) / Info.

What's Changed

  • fix(install-prompt): Not now works in modal mode (HC-L1) by @HecFranco in #65

Full Changelog: v1.14.0...v1.14.1

Release v1.14.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 18:12

v1.14.0

Changelog

Changed

  • Install prompt motion: the banner, flash and modal displays open and close on UiKit's --nowo-ui-motion-medium*, --nowo-ui-motion-scale and easing tokens (own fallbacks: 200 ms in, 150 ms out, scale 0.98). The close waits for the fade before hidden, with a timer if transitionend never fires. Reduced motion keeps an 80 ms fade with no movement; html[data-motion="full"] keeps the full effect. No !important.
  • Turbo: running fades finish on turbo:before-cache, so that a cached page never holds a half-closed surface. Install prompt: audit finding HW-L5.

What's Changed

  • feat(motion): install prompt opens and closes on the motion tokens by @HecFranco in #64

Full Changelog: v1.13.0...v1.14.0

Release v1.13.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 17:14

v1.13.0

Changelog

Host control of the install prompt buttons and more pwa.css tokens. No change for hosts that change nothing. The
service worker, the manifest and what they cache are untouched. See UPGRADING.

Added

  • nowo_pwa.install_prompt.button_paint (kit by default, or host): with host the install prompt buttons carry
    only the UiKit slot classes and pwa.css does not paint them, so host button classes win without specificity
    overrides. The actions wrapper is __actions-host in that mode.
  • pwa.css tokens for values that were hard-coded: --nowo-pwa-install-z-index, -banner-max-width,
    -banner-inset-x, -banner-offset-bottom, -banner-offset-top, -flash-max-width, -modal-padding,
    -modal-panel-padding, -eyebrow-font-weight, -eyebrow-letter-spacing, -title-line-height,
    -button-border-color, --nowo-pwa-install-links-font-size, -links-font-weight, -links-line-height. Their
    defaults are the previous values.

Documentation

  • src/push-checks.ts is declared a public entry covered by semver, with a test that pins its exports.

Security

  • REQ-SEC-004 audit: Pass (good) / Low (2026-11-06). No advisory needed. The service worker, the manifest, their scope and their cache rules did not change.
  • Known issue, also in 1.12.0: with install_prompt.display: modal the "Not now" button has no effect; "Don't ask again" and a backdrop click work. A fix follows in a patch release.

What's Changed

  • chore(deps): bump the phpstan group across 1 directory with 2 updates by @dependabot[bot] in #61
  • chore(deps): bump nowo-tech/ui-kit-bundle from 2.17.2 to 2.17.5 by @dependabot[bot] in #60
  • chore(deps): Symfony security release 2026-11-04 by @HecFranco in #62
  • feat(install-prompt): host button paint option and more pwa.css tokens by @HecFranco in #63

Full Changelog: v1.12.0...v1.13.0

Release v1.12.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 16:44

v1.12.0

Changelog

Bundle-level HTTP timeouts on Web Push deliveries (REQ-RUNTIME-001). See UPGRADING.

Added

  • nowo_pwa.web_push.timeout (default 5.0 s, total) and nowo_pwa.web_push.connect_timeout (default 3.0 s,
    connect / inactivity): bundle-level deadlines on every Web Push delivery (REQ-RUNTIME-001). A host Symfony
    Psr18Client is kept and cloned with these deadlines; without a host client the bundle builds a Symfony
    Psr18Client with them (when symfony/http-client is installed); other PSR-18 clients are used as-is.
  • WebPushHttpClientFactory (resolves the PSR-18 client with the deadlines) and a timeout test against an
    unresponsive local socket.

Fixed

  • A push service that sends headers and then stalls the body is now reported as a failed delivery instead of a
    Symfony TransportException escaping MinishlinkWebPushSender::send().

What's Changed

  • chore(deps): bump nowo-tech/ui-kit-bundle from 2.6.1 to 2.7.0 by @dependabot[bot] in #55
  • chore(deps): bump vite from 8.3.4 to 8.3.5 by @dependabot[bot] in #56
  • feat(web-push): bundle-level HTTP timeouts on push deliveries (REQ-RUNTIME-001) by @HecFranco in #57

Full Changelog: v1.11.0...v1.12.0

Release v1.11.0

Choose a tag to compare

@github-actions github-actions released this 23 Oct 07:25

Release v1.11.0

release-check: OK 1753783

Changelog

Added

  • nowo_pwa.install_prompt.mark_template: a Twig template included as the install prompt's brand mark (for example an
    inline SVG that follows the site theme), so a host no longer overrides pwa/install_prompt.html.twig for it; wins
    over mark_asset.

Full Changelog: v1.10.2...v1.11.0

Release v1.10.2

Choose a tag to compare

@github-actions github-actions released this 22 Oct 06:08

v1.10.2

Changelog

Controllers in coverage scope, translation key parity, Web Push timeout docs, demo smoke fixes. See UPGRADING.

Changed

  • Controllers are part of the PHPUnit coverage scope again (src/Controller no longer excluded); new tests for the disabled-feature guards and cacheable manifest responses keep lines at 100% (REQ-TEST-003).
  • validate-translations checks key parity across the shipped locales (REQ-MAKE-004).
  • Docs: Web Push HTTP timeout guidance (REQ-RUNTIME-001), documented route-loader exception to attribute routes (REQ-SF-004), PSR evaluation updated for the Web Push sender (PSR-3, PSR-7/17, PSR-18) (REQ-CS-007).
  • Demo DNS block commented (REQ-DEMO-009); new Demo smoke workflow (tags, weekly, manual) (REQ-TEST-011).

Fixed

  • .scripts/check-no-cursor-coauthor.sh also runs inside git worktrees (.git file instead of directory).
  • Demo make up installs Composer dependencies in a one-off container before FrankenPHP starts (a fresh checkout crash-looped the worker on the missing vendor/, so make demo-smoke failed).
  • Pending Rector code-quality suggestions applied (PwaController offline URL concatenation, PwaRouteTargeting legacy pattern check) so rector-dry is clean again.

Full Changelog: v1.10.1...v1.10.2

Release v1.10.1

Choose a tag to compare

@github-actions github-actions released this 20 Oct 12:36

v1.10.1

Changelog

Dependency refresh (bundle and demos), php-cs-fixer ParallelConfig(2). See UPGRADING.

Changed

  • Dependencies refreshed (Composer and pnpm/npm lock files of the bundle and its demos, campaign 2026-10-19); shipped assets rebuilt.
  • .php-cs-fixer.dist.php: new ParallelConfig(2) (REQ-CS-001).
  • Documentation: wave-1 REQ compliance — README standard badge line (order, Symfony 7.4 | 8.0 | 8.1+, Coverage badge), canonical FrankenPHP claim line and documentation list order, CONTRIBUTING Cursor Agent settings and post-release-commit trailer check, CODEOWNERS header and canonical bug-report template, demo .env.example comments, doc TOCs, Spec Kit inventory refresh (64/64).

What's Changed

  • chore(deps): bump jsdom from 30.1.2 to 30.1.3 by @dependabot[bot] in #53
  • chore(deps): bump nowo-tech/phpstan-frankenphp from 1.2.3 to 1.3.0 by @dependabot[bot] in #54

Full Changelog: v1.10.0...v1.10.1

Release v1.10.0

Choose a tag to compare

@github-actions github-actions released this 18 Oct 10:52

v1.10.0

Changelog

Install prompt and offline page on the UiKit 2.2 page contract (REQ-UI-003): theme slots, one-block @!NowoPwaBundle overrides (namespace now registered), self-contained offline status page; show_never_option: false honoured. See UPGRADING.

Added

  • UiKit page contract (REQ-UI-003) — requires nowo-tech/ui-kit-bundle ^2.2. The install prompt, install links
    and push diagnostics read the UiKit theme slots of NowoPwaBundle (card, card_title, card_intro, muted,
    toolbar, btn_primary, btn_secondary, btn_link, btn_sm; nowo_ui_attrs('card' | 'toolbar')), so a host
    themes them once in nowo_ui_kit.theme (or theme.bundles.NowoPwaBundle). Widget roots carry
    data-nowo-ui-bundle="NowoPwaBundle" (per-bundle tokens) and data-testid="pwa-install-prompt".
  • Install prompt blocks for one-block @! overrides: pwa_install_backdrop, pwa_install_panel, pwa_install_text,
    pwa_install_message, pwa_install_button_install, pwa_install_button_remind, pwa_install_button_never
    (existing: pwa_install_mark, pwa_install_eyebrow, pwa_install_title, pwa_install_actions); install links:
    pwa_install_link, pwa_uninstall_link.
  • nowo_pwa.web_ui.templates.{head,install_prompt,install_links,offline} and nowo_pwa.web_ui.layout_template
    (layout of the offline page; null = @NowoUiKit/layout/status.html.twig).
  • Nowo\PwaBundle\View\OfflinePage::create() — the offline page view model (UiKit AuthPage).
  • docs/TEMPLATES.md; contract test (PageContractTestCase) and widget tests with a stub theme.
  • Demo: UiKit document layout with a host theme (tokens + class map), a one-block install prompt override, Playwright
    e2e (make -C demo/symfony8 test-e2e) and README screenshots (make -C demo/symfony8 demo-screenshots, REQ-DEMO-013).

Changed

  • Offline page (pwa/offline.html.twig): renders on the self-contained UiKit status layout (inline critical CSS
    with the request CSP nonce, theme tokens, no stylesheet / script request) with the page/auth panel regions and
    slots; the 1.x standalone page (dark --nowo-pwa-offline-* palette) moved to pwa/offline_standalone.html.twig.
  • pwa.css: the --nowo-pwa-install-* tokens fall back to the UiKit --nowo-ui-* tokens (surface, text, muted, border,
    radius, primary); the panel (not the root) is the painted surface; [hidden] always hides the prompt.
  • Install prompt markup: eyebrow / title / message wrapped in .nowo-pwa-install__text; aria-describedby on the root.

Deprecated

  • nowo_pwa.templates.* → nowo_pwa.web_ui.templates.*.
  • nowo_pwa.install_prompt.button_class / dismiss_button_class / never_button_class → UiKit theme slots
    btn_primary / btn_secondary / btn_link (nowo_ui_kit.theme.bundles.NowoPwaBundle.classes.*). Still applied
    when set.
  • pwa/offline_standalone.html.twig (1.x offline page, opt-in).

Fixed

  • @!NowoPwaBundle/… is now registered (the bundle templates without the app overrides), so a host override can extend
    the bundle template and redefine one block instead of copying the file.
  • install_prompt.show_never_option: false hides the "Don't ask again" button (the Twig default filter turned
    false into true).

Full Changelog: v1.9.1...v1.10.0