@chirag127/omni-publish 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chirag Singhal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @chirag127/omni-publish
+
+[![npm](https://img.shields.io/npm/v/@chirag127/omni-publish.svg)](https://www.npmjs.com/package/@chirag127/omni-publish)
+[![CI](https://github.com/chirag127/omni-publish-npm-pkg/actions/workflows/ci.yml/badge.svg)](https://github.com/chirag127/omni-publish-npm-pkg/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+Auto-publish release notes / blog posts to multiple platforms on tag push or release create. Platform fan-out is filtered by which env vars are set — if only `DEVTO_API_KEY` exists, only dev.to is targeted.
+
+## Install
+
+```sh
+npm i -D @chirag127/omni-publish
+# or
+pnpm add -D @chirag127/omni-publish
+```
+
+## Supported platforms / env vars
+
+Set the env var for each platform you want to publish to. Unset = skipped.
+
+| Platform     | Env var              |
+|--------------|----------------------|
+| dev.to       | `DEVTO_API_KEY`      |
+| Hashnode     | `HASHNODE_API_KEY`   |
+| Medium       | `MEDIUM_API_KEY`     |
+| X / Twitter  | `X_API_KEY`          |
+| LinkedIn     | `LINKEDIN_API_KEY`   |
+| Bluesky      | `BLUESKY_API_KEY`    |
+| Mastodon     | `MASTODON_API_KEY`   |
+| Reddit       | `REDDIT_API_KEY`     |
+
+## GitHub Actions
+
+```yaml
+name: Cross-post release
+on:
+  release: { types: [published] }
+  push: { tags: ['v*.*.*'] }
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - run: npx -y @chirag127/omni-publish
+        env:
+          DEVTO_API_KEY:    ${{ secrets.DEVTO_API_KEY }}
+          HASHNODE_API_KEY: ${{ secrets.HASHNODE_API_KEY }}
+          MEDIUM_API_KEY:   ${{ secrets.MEDIUM_API_KEY }}
+          X_API_KEY:        ${{ secrets.X_API_KEY }}
+          LINKEDIN_API_KEY: ${{ secrets.LINKEDIN_API_KEY }}
+          BLUESKY_API_KEY:  ${{ secrets.BLUESKY_API_KEY }}
+          MASTODON_API_KEY: ${{ secrets.MASTODON_API_KEY }}
+          REDDIT_API_KEY:   ${{ secrets.REDDIT_API_KEY }}
+```
+
+## Status
+
+`v0.1.x` — slug reservation + stub. Per-platform adapters land in `v0.1.1`.
+
+Part of the [`chirag127/oriz`](https://github.com/chirag127/oriz) family.
+
+## Cross-refs
+
+- [security policy](./SECURITY.md) · [code of conduct](./CODE_OF_CONDUCT.md) · [contributing](./CONTRIBUTING.md)

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@chirag127/omni-publish",
+  "version": "0.1.0",
+  "description": "Auto-publish release notes / blog posts to multiple platforms (dev.to, hashnode, medium, X/Twitter, LinkedIn, Bluesky, Mastodon, Reddit) on tag push or release create. Platform fan-out filtered by which env vars are set.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Chirag Singhal <chirag@oriz.in>",
+  "homepage": "https://github.com/chirag127/omni-publish-npm-pkg#readme",
+  "repository": { "type": "git", "url": "git+https://github.com/chirag127/omni-publish-npm-pkg.git" },
+  "bugs": { "url": "https://github.com/chirag127/omni-publish-npm-pkg/issues" },
+  "keywords": ["chirag127", "oriz", "release-notes", "devto", "hashnode", "medium", "twitter", "linkedin", "bluesky", "mastodon", "reddit", "cross-post"],
+  "files": ["src", "LICENSE", "README.md"],
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "bin": { "omni-publish": "./src/index.ts" },
+  "exports": { ".": "./src/index.ts" },
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "vitest": "^2.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "happy-dom": "^15.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest'
+import { __pkg, publish } from '../index'
+
+describe('package smoke', () => {
+  it('exports __pkg constant', () => {
+    expect(__pkg).toMatch(/^@chirag127\//)
+  })
+
+  it('publish() resolves without throwing on empty config', async () => {
+    await expect(publish({ platforms: [], title: 't', body: 'b' })).resolves.toBeUndefined()
+  })
+})

package/src/index.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// @chirag127/omni-publish
+// v0.1.0 stub. See README for status.
+export const __pkg = '@chirag127/omni-publish' as const
+
+export type OmniPublishConfig = {
+  platforms: string[]
+  title: string
+  body: string
+  canonicalUrl?: string
+}
+
+export async function publish(_cfg: OmniPublishConfig): Promise<void> {
+  /* TODO: implement per-platform adapters in v0.1.1 */
+}