@zampsn/old-man-yells-at 1.0.0 → 1.1.0

package/README.md

@@ -1,5 +1,11 @@
-[![ci](https://github.com/zampsn/old-man-yells-at/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/zampsn/old-man-yells-at/actions/workflows/ci.yaml)
-[![codecov](https://codecov.io/gh/zampsn/old-man-yells-at/graph/badge.svg?token=ACgVjXxFeS)](https://codecov.io/gh/zampsn/old-man-yells-at)
-[![Version](https://img.shields.io/github/v/release/zampsn/old-man-yells-at)](https://github.com/zampsn/old-man-yells-at/releases)
+<p align="center"><img src="/static/old-man-yells-at.png" width="128" alt="Old man yells at" /></p>
+<h3 align="center">old-man-yells-at</h3>
+<p align="center">
+<a href="https://npmjs.com/package/@zampsn/old-man-yells-at"><img src="https://badgen.net/npm/v/@zampsn/old-man-yells-at" alt="npm"></a> 
+<a href="https://github.com/zampsn/old-man-yells-at/actions"><img src="https://github.com/zampsn/old-man-yells-at/actions/workflows/ci.yaml/badge.svg" alt="workflow status">
+<a href="https://codecov.io/gh/zampsn/old-man-yells-at"><img src="https://codecov.io/gh/zampsn/old-man-yells-at/graph/badge.svg?token=ACgVjXxFeS" alt="code coverage"/></a></a>
+</p>
 
-# old-man-yells-at
+---
+
+You've got an opinion. A strong one. About something that probably doesn't deserve this much energy. old-man-yells-at is a TypeScript package that turns that frustration into art — specifically, Abe Simpson shaking his fist at whatever you point it at. Pass in a target, get back a meme. Simple as that.

package/dist/builder.d.ts

@@ -0,0 +1,13 @@
+import type sharp from 'sharp';
+export declare class Builder {
+    private readonly inputPath;
+    private readonly templateBuffer;
+    private outputWidth;
+    private outputHeight;
+    constructor(inputPath: string, templateBuffer: Buffer);
+    resize(width: number, height: number): this;
+    toSharp(): Promise<sharp.Sharp>;
+    toBuffer(): Promise<Buffer>;
+    toFile(outputPath: string): Promise<void>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,YAAY,CAAwB;gBAEhC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAKrD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMrC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAS/B,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD"}

package/dist/builder.js

@@ -0,0 +1,32 @@
+import { compositeImages } from './composite.js';
+const DEFAULT_SIZE = 128;
+export class Builder {
+    inputPath;
+    templateBuffer;
+    outputWidth = DEFAULT_SIZE;
+    outputHeight = DEFAULT_SIZE;
+    constructor(inputPath, templateBuffer) {
+        this.inputPath = inputPath;
+        this.templateBuffer = templateBuffer;
+    }
+    resize(width, height) {
+        this.outputWidth = width;
+        this.outputHeight = height;
+        return this;
+    }
+    async toSharp() {
+        return compositeImages({
+            inputPath: this.inputPath,
+            templateBuffer: this.templateBuffer,
+            width: this.outputWidth,
+            height: this.outputHeight,
+        });
+    }
+    async toBuffer() {
+        return (await this.toSharp()).toBuffer();
+    }
+    async toFile(outputPath) {
+        await (await this.toSharp()).toFile(outputPath);
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB,MAAM,OAAO,OAAO;IACC,SAAS,CAAS;IAClB,cAAc,CAAS;IAChC,WAAW,GAAW,YAAY,CAAC;IACnC,YAAY,GAAW,YAAY,CAAC;IAE5C,YAAY,SAAiB,EAAE,cAAsB;QACjD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,MAAc;QAChC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO;QACT,OAAO,eAAe,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,IAAI,CAAC,WAAW;YACvB,MAAM,EAAE,IAAI,CAAC,YAAY;SAC5B,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC3B,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;CACJ"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,8 @@
+import { yellAt } from './yell-at.js';
+yellAt('test/fixtures/test-input.png')
+    .then((res) => res.toFile('temp.png'))
+    .catch((err) => {
+    console.error('Failed to yell at image', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,8BAA8B,CAAC;KACjC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KACrC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACX,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/composite.d.ts

@@ -0,0 +1,4 @@
+import sharp from 'sharp';
+import type { CompositeOptions } from './types.js';
+export declare const compositeImages: (options: CompositeOptions) => Promise<sharp.Sharp>;
+//# sourceMappingURL=composite.d.ts.map

package/dist/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../src/composite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CASpF,CAAC"}

package/dist/composite.js

@@ -0,0 +1,11 @@
+import sharp from 'sharp';
+const OVERLAY_SIZE = 48;
+export const compositeImages = async (options) => {
+    const { inputPath, templateBuffer, width, height } = options;
+    const overlay = await sharp(inputPath).resize(OVERLAY_SIZE, OVERLAY_SIZE, { fit: 'cover' }).toBuffer();
+    return sharp(templateBuffer)
+        .resize(width, height, { fit: 'cover' })
+        .composite([{ input: overlay, top: 16, left: 0 }])
+        .png();
+};
+//# sourceMappingURL=composite.js.map

package/dist/composite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.js","sourceRoot":"","sources":["../src/composite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,OAAyB,EAAwB,EAAE;IACrF,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE7D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEvG,OAAO,KAAK,CAAC,cAAc,CAAC;SACvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;SACvC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SACjD,GAAG,EAAE,CAAC;AACf,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-export declare const FOO = "bar";
-export interface User {
-    name: string;
-}
+export { yellAt } from './yell-at.js';
+export { Builder } from './builder.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,GAAG,QAAQ,CAAC;AAEzB,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
-export const FOO = 'bar';
+export { yellAt } from './yell-at.js';
+export { Builder } from './builder.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/template.d.ts

@@ -0,0 +1,2 @@
+export declare const getTemplateBuffer: () => Promise<Buffer>;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,MAAM,CAQxD,CAAC"}

package/dist/template.js

@@ -0,0 +1,31 @@
+/**
+ * @summary template fetches the old-man-yells-at.png base image from GitHub.
+ *
+ * For security, we verify the checksum of the image on first access.
+ */
+import { createHash } from 'node:crypto';
+const EXPECTED_CHECKSUM = '7e0095f6b841b97f2745afcdc803b0895028de7caeeeb665e158ef6a20f35b80';
+const TEMPLATE_URL = 'https://github.com/zampsn/old-man-yells-at/blob/main/static/old-man-yells-at.png?raw=true';
+let cachedTemplate;
+const verifyChecksum = (buffer) => {
+    const hash = createHash('sha256').update(buffer).digest('hex');
+    if (hash !== EXPECTED_CHECKSUM) {
+        throw new Error(`Template image checksum mismatch. Expected ${EXPECTED_CHECKSUM}, got ${hash}`);
+    }
+};
+const loadFromRemote = async () => {
+    const response = await fetch(TEMPLATE_URL);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch template image: ${response.status} ${response.statusText}`);
+    }
+    return Buffer.from(await response.arrayBuffer());
+};
+export const getTemplateBuffer = async () => {
+    if (cachedTemplate)
+        return cachedTemplate;
+    const buffer = await loadFromRemote();
+    verifyChecksum(buffer);
+    cachedTemplate = buffer;
+    return buffer;
+};
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,iBAAiB,GAAG,kEAAkE,CAAC;AAC7F,MAAM,YAAY,GAAG,2FAA2F,CAAC;AAEjH,IAAI,cAAkC,CAAC;AAEvC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAQ,EAAE;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,iBAAiB,SAAS,IAAI,EAAE,CAAC,CAAC;IACpG,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,KAAK,IAAqB,EAAE;IAC/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,IAAqB,EAAE;IACzD,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,cAAc,GAAG,MAAM,CAAC;IACxB,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+export interface CompositeOptions {
+    readonly inputPath: string;
+    readonly templateBuffer: Buffer;
+    readonly width: number;
+    readonly height: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/yell-at.d.ts

@@ -0,0 +1,3 @@
+import { Builder } from './builder.js';
+export declare const yellAt: (imagePath: string) => Promise<Builder>;
+//# sourceMappingURL=yell-at.d.ts.map

package/dist/yell-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yell-at.d.ts","sourceRoot":"","sources":["../src/yell-at.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,eAAO,MAAM,MAAM,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,OAAO,CAG/D,CAAC"}

package/dist/yell-at.js

@@ -0,0 +1,7 @@
+import { Builder } from './builder.js';
+import { getTemplateBuffer } from './template.js';
+export const yellAt = async (imagePath) => {
+    const templateBuffer = await getTemplateBuffer();
+    return new Builder(imagePath, templateBuffer);
+};
+//# sourceMappingURL=yell-at.js.map

package/dist/yell-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yell-at.js","sourceRoot":"","sources":["../src/yell-at.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,SAAiB,EAAoB,EAAE;IAChE,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAClD,CAAC,CAAC"}

package/package.json

@@ -24,7 +24,8 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "static"
   ],
   "publishConfig": {
     "access": "public",
@@ -35,6 +36,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^4.1.1",
     "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
@@ -45,5 +47,8 @@
     "typescript-eslint": "^8.57.2",
     "vitest": "^4.1.1"
   },
-  "version": "1.0.0"
+  "dependencies": {
+    "sharp": "^0.34.5"
+  },
+  "version": "1.1.0"
 }