ngx-media 1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,70 @@
+# Contributing
+
+## Setup
+
+```bash
+pnpm install
+```
+
+Husky git hooks are installed automatically.
+
+## Commit Convention
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/).
+Every commit message is validated by **commitlint** via a husky `commit-msg` hook.
+
+### Format
+
+```
+<type>(<scope>): <short description>
+```
+
+### Common types
+
+| Type       | When to use                          | Triggers release? |
+| ---------- | ------------------------------------ | ----------------- |
+| `feat`     | A new feature                        | minor             |
+| `fix`      | A bug fix                            | patch             |
+| `docs`     | Documentation only                   | no                |
+| `style`    | Formatting, missing semicolons, etc. | no                |
+| `refactor` | Code change that is not feat or fix  | no                |
+| `perf`     | Performance improvement              | patch             |
+| `test`     | Adding or updating tests             | no                |
+| `chore`    | Tooling, dependencies, CI            | no                |
+
+A commit with `BREAKING CHANGE:` in the footer (or `!` after the type) triggers a **major** release.
+
+### Examples
+
+```
+feat(camera): add device switching support
+fix(stream): handle permission denied on Safari
+docs: update README installation steps
+feat!: drop Angular 18 support
+```
+
+## Building
+
+```bash
+pnpm build:lib          # build the library
+pnpm build              # build everything (library + demo)
+```
+
+## Releases
+
+Releases are fully automated via **semantic-release** on GitHub Actions.
+Pushing to `main` (or `master`) triggers:
+
+1. Version bump based on commit types
+2. `CHANGELOG.md` update
+3. npm publish
+4. GitHub release with notes
+
+No manual version bumps or tags are needed.
+
+### Required repository secrets
+
+| Secret         | Purpose                      |
+| -------------- | ---------------------------- |
+| `NPM_TOKEN`    | npm publish authentication   |
+| `GITHUB_TOKEN` | Provided automatically by CI |

package/README.md

@@ -0,0 +1,19 @@
+# What it is
+
+_Angular library for easier camera/media access in web apps._
+
+---
+
+# Planned features
+
+- Auto Destroy and clearance on component destroy
+- Easy to use ML features
+- Easy to use component
+
+---
+
+# Installation
+
+```bash
+npm install ngx-media
+```

package/angular.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "cli": {
+    "packageManager": "pnpm"
+  },
+  "newProjectRoot": "projects",
+  "projects": {
+    "ngx-media": {
+      "projectType": "library",
+      "root": "projects/ngx-media",
+      "sourceRoot": "projects/ngx-media/src",
+      "prefix": "lib",
+      "schematics": {
+        "@schematics/angular:service": {
+          "skipTests": true,
+          "addTypeToClassName": true,
+          "type": "service",
+          "path": "projects/ngx-media/src/lib/services"
+        }
+      },
+      "architect": {
+        "build": {
+          "builder": "@angular/build:ng-packagr",
+          "configurations": {
+            "production": {
+              "tsConfig": "projects/ngx-media/tsconfig.lib.prod.json"
+            },
+            "development": {
+              "tsConfig": "projects/ngx-media/tsconfig.lib.json"
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "test": {
+          "builder": "@angular/build:unit-test",
+          "options": {
+            "tsConfig": "projects/ngx-media/tsconfig.spec.json"
+          }
+        }
+      }
+    },
+    "demo": {
+      "projectType": "application",
+      "schematics": {
+        "@schematics/angular:component": {
+          "skipTests": true,
+          "path": "projects/demo/src/app/components"
+        }
+      },
+      "root": "projects/demo",
+      "sourceRoot": "projects/demo/src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular/build:application",
+          "options": {
+            "browser": "projects/demo/src/main.ts",
+            "tsConfig": "projects/demo/tsconfig.app.json",
+            "assets": [
+              {
+                "glob": "**/*",
+                "input": "projects/demo/public"
+              }
+            ],
+            "styles": ["projects/demo/src/styles.css"],
+            "server": "projects/demo/src/main.server.ts",
+            "outputMode": "server",
+            "security": {
+              "allowedHosts": []
+            },
+            "ssr": {
+              "entry": "projects/demo/src/server.ts"
+            }
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "500kB",
+                  "maximumError": "1MB"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "4kB",
+                  "maximumError": "8kB"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular/build:dev-server",
+          "configurations": {
+            "production": {
+              "buildTarget": "demo:build:production"
+            },
+            "development": {
+              "buildTarget": "demo:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        },
+        "test": {
+          "builder": "@angular/build:unit-test"
+        }
+      }
+    }
+  }
+}

package/commitlint.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "ngx-media",
+  "version": "1.0.0",
+  "scripts": {
+    "ng": "ng",
+    "start": "ng serve --project=demo",
+    "build": "ng build",
+    "build:lib": "ng build ngx-media --configuration production",
+    "watch": "ng build --watch --configuration development",
+    "test": "ng test",
+    "semantic-release": "semantic-release",
+    "serve:ssr:demo": "node dist/demo/server/server.mjs",
+    "prepare": "husky"
+  },
+  "private": false,
+  "packageManager": "pnpm@11.5.2",
+  "dependencies": {
+    "@angular/common": "^22.0.0",
+    "@angular/compiler": "^22.0.0",
+    "@angular/core": "^22.0.0",
+    "@angular/forms": "^22.0.0",
+    "@angular/platform-browser": "^22.0.0",
+    "@angular/platform-server": "^22.0.0",
+    "@angular/router": "^22.0.0",
+    "@angular/ssr": "^22.0.5",
+    "express": "^5.1.0",
+    "rxjs": "~7.8.0",
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@angular/build": "^22.0.5",
+    "@angular/cli": "^22.0.5",
+    "@angular/compiler-cli": "^22.0.0",
+    "@commitlint/cli": "^21.2.0",
+    "@commitlint/config-conventional": "^21.2.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@tailwindcss/postcss": "^4.1.12",
+    "@types/express": "^5.0.1",
+    "@types/node": "^20.17.19",
+    "husky": "^9.1.7",
+    "jsdom": "^28.0.0",
+    "ng-packagr": "^22.0.0",
+    "postcss": "^8.5.3",
+    "prettier": "^3.8.1",
+    "rxjs-watcher": "^1.2.2",
+    "semantic-release": "^25.0.5",
+    "tailwindcss": "^4.1.12",
+    "typescript": "~6.0.2",
+    "vitest": "^4.0.8"
+  }
+}

package/projects/demo/.postcssrc.json

@@ -0,0 +1,5 @@
+{
+  "plugins": {
+    "@tailwindcss/postcss": {}
+  }
+}

package/projects/demo/src/app/app.config.server.ts

@@ -0,0 +1,10 @@
+import { mergeApplicationConfig, ApplicationConfig } from '@angular/core';
+import { provideServerRendering, withRoutes } from '@angular/ssr';
+import { appConfig } from './app.config';
+import { serverRoutes } from './app.routes.server';
+
+const serverConfig: ApplicationConfig = {
+  providers: [provideServerRendering(withRoutes(serverRoutes))],
+};
+
+export const config = mergeApplicationConfig(appConfig, serverConfig);

package/projects/demo/src/app/app.config.ts

@@ -0,0 +1,9 @@
+import { ApplicationConfig, provideBrowserGlobalErrorListeners } from '@angular/core';
+import { provideRouter } from '@angular/router';
+
+import { routes } from './app.routes';
+import { provideClientHydration } from '@angular/platform-browser';
+
+export const appConfig: ApplicationConfig = {
+  providers: [provideBrowserGlobalErrorListeners(), provideRouter(routes), provideClientHydration()],
+};

package/projects/demo/src/app/app.css

@@ -0,0 +1,5 @@
+@reference "tailwindcss";
+
+:host {
+  @apply flex flex-col justify-center items-center min-h-screen;
+}

package/projects/demo/src/app/app.html

@@ -0,0 +1 @@
+<router-outlet />

package/projects/demo/src/app/app.routes.server.ts

@@ -0,0 +1,8 @@
+import { RenderMode, ServerRoute } from '@angular/ssr';
+
+export const serverRoutes: ServerRoute[] = [
+  {
+    path: '**',
+    renderMode: RenderMode.Client,
+  },
+];

package/projects/demo/src/app/app.routes.ts

@@ -0,0 +1,28 @@
+import { Routes } from '@angular/router';
+import { Layout } from './components/layout/layout';
+
+export const routes: Routes = [
+  {
+    path: '',
+    component: Layout,
+    children: [
+      {
+        path: '',
+        loadComponent: () => import('./components/home/home').then((c) => c.Home),
+      },
+      {
+        path: 'about',
+        loadComponent: () => import('./components/about/about').then((c) => c.About),
+      },
+      {
+        path: 'samples',
+        loadComponent: () => import('./components/samples/samples').then((c) => c.Samples),
+      },
+      {
+        path: '**',
+        redirectTo: '',
+        pathMatch: 'full',
+      },
+    ],
+  },
+];

package/projects/demo/src/app/app.spec.ts

@@ -0,0 +1,23 @@
+import { TestBed } from '@angular/core/testing';
+import { App } from './app';
+
+describe('App', () => {
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [App],
+    }).compileComponents();
+  });
+
+  it('should create the app', () => {
+    const fixture = TestBed.createComponent(App);
+    const app = fixture.componentInstance;
+    expect(app).toBeTruthy();
+  });
+
+  it('should render title', async () => {
+    const fixture = TestBed.createComponent(App);
+    await fixture.whenStable();
+    const compiled = fixture.nativeElement as HTMLElement;
+    expect(compiled.querySelector('h1')?.textContent).toContain('Hello, demo');
+  });
+});

package/projects/demo/src/app/app.ts

@@ -0,0 +1,12 @@
+import { Component, signal } from '@angular/core';
+import { RouterOutlet } from '@angular/router';
+
+@Component({
+  selector: 'app-root',
+  imports: [RouterOutlet],
+  templateUrl: './app.html',
+  styleUrl: './app.css',
+})
+export class App {
+  protected readonly title = signal('demo');
+}

package/projects/demo/src/app/components/about/about.html

@@ -0,0 +1 @@
+<p>about works!</p>

package/projects/demo/src/app/components/about/about.ts

@@ -0,0 +1,9 @@
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-about',
+  imports: [],
+  templateUrl: './about.html',
+  styleUrl: './about.css',
+})
+export class About {}

package/projects/demo/src/app/components/home/home.css

@@ -0,0 +1,5 @@
+@reference "tailwindcss";
+
+.video-container {
+  @apply flex flex-row gap-4 wrap-normal;
+}

package/projects/demo/src/app/components/home/home.html

@@ -0,0 +1,8 @@
+<h1>Home</h1>
+<p>It works!</p>
+<hr />
+
+<div class="video-container">
+  <app-video-horizontal />
+  <app-video-vertical />
+</div>

package/projects/demo/src/app/components/home/home.ts

@@ -0,0 +1,11 @@
+import { Component } from '@angular/core';
+import { VideoHorizontal } from '../video-horizontal/video-horizontal';
+import { VideoVertical } from '../video-vertical/video-vertical';
+
+@Component({
+  selector: 'app-home',
+  imports: [VideoHorizontal, VideoVertical],
+  templateUrl: './home.html',
+  styleUrl: './home.css',
+})
+export class Home {}

package/projects/demo/src/app/components/layout/layout.css

@@ -0,0 +1,13 @@
+@reference "tailwindcss";
+
+:host {
+  @apply flex flex-row max-w-7xl w-full border-2;
+}
+
+aside {
+  @apply max-w-60 min-w-45 p-4 bg-amber-200;
+}
+
+main {
+  @apply grow p-4;
+}

package/projects/demo/src/app/components/layout/layout.html

@@ -0,0 +1,10 @@
+<aside>
+  <ul>
+    <li><a routerLink="/">Home</a></li>
+    <li><a routerLink="/about">About</a></li>
+    <li><a routerLink="/samples">Samples</a></li>
+  </ul>
+</aside>
+<main>
+  <router-outlet />
+</main>

package/projects/demo/src/app/components/layout/layout.ts

@@ -0,0 +1,10 @@
+import { Component } from '@angular/core';
+import { RouterLink, RouterOutlet } from '@angular/router';
+
+@Component({
+  selector: 'app-layout',
+  imports: [RouterOutlet, RouterLink],
+  templateUrl: './layout.html',
+  styleUrl: './layout.css',
+})
+export class Layout {}

package/projects/demo/src/app/components/samples/samples.html

@@ -0,0 +1 @@
+<p>samples works!</p>

package/projects/demo/src/app/components/samples/samples.ts

@@ -0,0 +1,9 @@
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-samples',
+  imports: [],
+  templateUrl: './samples.html',
+  styleUrl: './samples.css',
+})
+export class Samples {}

package/projects/demo/src/app/components/video-horizontal/video-horizontal.html

@@ -0,0 +1,3 @@
+<p>video-horizontal works!</p>
+
+<video #video width="300" height="400" autoplay [srcObject]="stream()"></video>

package/projects/demo/src/app/components/video-horizontal/video-horizontal.ts

@@ -0,0 +1,20 @@
+import { Component, DestroyRef, inject } from '@angular/core';
+import { NgxMedia } from '../../../../../ngx-media/src/lib/ngx-media';
+
+@Component({
+  selector: 'app-video-horizontal',
+  imports: [],
+  templateUrl: './video-horizontal.html',
+  styleUrl: './video-horizontal.css',
+})
+export class VideoHorizontal {
+  private readonly cameraService = new NgxMedia(inject(DestroyRef));
+
+  protected readonly stream = this.cameraService.stream;
+
+  constructor() {
+    this.cameraService.startStream({
+      video: { facingMode: 'user', aspectRatio: 1, width: { exact: 400 }, height: { exact: 300 }, frameRate: 30 },
+    });
+  }
+}

package/projects/demo/src/app/components/video-vertical/video-vertical.html

@@ -0,0 +1,3 @@
+<p>video-vertical works!</p>
+
+<video #video width="300" height="400" autoplay [srcObject]="stream$ | async"></video>

package/projects/demo/src/app/components/video-vertical/video-vertical.ts

@@ -0,0 +1,25 @@
+import { Component, OnDestroy } from '@angular/core';
+import { NgxMedia } from '../../../../../ngx-media/src/lib/ngx-media';
+import { AsyncPipe } from '@angular/common';
+
+@Component({
+  selector: 'app-video-vertical',
+  imports: [AsyncPipe],
+  templateUrl: './video-vertical.html',
+  styleUrl: './video-vertical.css',
+})
+export class VideoVertical implements OnDestroy {
+  private readonly ngxMedia = new NgxMedia();
+
+  protected readonly stream$ = this.ngxMedia.stream$;
+
+  constructor() {
+    this.ngxMedia.startStream({
+      video: { facingMode: 'user', aspectRatio: 1, width: { exact: 300 }, height: { exact: 400 }, frameRate: 30 },
+    });
+  }
+
+  ngOnDestroy() {
+    this.ngxMedia.destroy();
+  }
+}

package/projects/demo/src/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Demo</title>
+    <base href="/" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" type="image/x-icon" href="favicon.ico" />
+  </head>
+  <body>
+    <app-root></app-root>
+  </body>
+</html>

package/projects/demo/src/main.server.ts

@@ -0,0 +1,7 @@
+import { BootstrapContext, bootstrapApplication } from '@angular/platform-browser';
+import { App } from './app/app';
+import { config } from './app/app.config.server';
+
+const bootstrap = (context: BootstrapContext) => bootstrapApplication(App, config, context);
+
+export default bootstrap;

package/projects/demo/src/main.ts

@@ -0,0 +1,5 @@
+import { bootstrapApplication } from '@angular/platform-browser';
+import { appConfig } from './app/app.config';
+import { App } from './app/app';
+
+bootstrapApplication(App, appConfig).catch((err) => console.error(err));

package/projects/demo/src/server.ts

@@ -0,0 +1,66 @@
+import {
+  AngularNodeAppEngine,
+  createNodeRequestHandler,
+  isMainModule,
+  writeResponseToNodeResponse,
+} from '@angular/ssr/node';
+import express from 'express';
+import { join } from 'node:path';
+
+const browserDistFolder = join(import.meta.dirname, '../browser');
+
+const app = express();
+const angularApp = new AngularNodeAppEngine();
+
+/**
+ * Example Express Rest API endpoints can be defined here.
+ * Uncomment and define endpoints as necessary.
+ *
+ * Example:
+ * ```ts
+ * app.get('/api/{*splat}', (req, res) => {
+ *   // Handle API request
+ * });
+ * ```
+ */
+
+/**
+ * Serve static files from /browser
+ */
+app.use(
+  express.static(browserDistFolder, {
+    maxAge: '1y',
+    index: false,
+    redirect: false,
+  }),
+);
+
+/**
+ * Handle all other requests by rendering the Angular application.
+ */
+app.use((req, res, next) => {
+  angularApp
+    .handle(req)
+    .then((response) => (response ? writeResponseToNodeResponse(response, res) : next()))
+    .catch(next);
+});
+
+/**
+ * Start the server if this module is the main entry point, or it is ran via PM2.
+ * The server listens on the port defined by the `PORT` environment variable, or defaults to 4000.
+ */
+if (isMainModule(import.meta.url) || process.env['pm_id']) {
+  const port = process.env['PORT'] || 4000;
+  app.listen(port, (error) => {
+    if (error) {
+      throw error;
+    }
+
+    console.log(`Node Express server listening on http://localhost:${port}`);
+  });
+}
+
+/**
+ * Request handler used by the Angular CLI (for dev-server and during build) or Firebase Cloud Functions.
+ */
+export const reqHandler = createNodeRequestHandler(app);

package/projects/demo/src/styles.css

@@ -0,0 +1,3 @@
+/* You can add global styles to this file, and also import other style files */
+
+@import 'tailwindcss';

package/projects/demo/tsconfig.app.json

@@ -0,0 +1,10 @@
+/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */
+/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.spec.ts"]
+}