@alpefe/ozure 0.0.0-stage → 0.2.1

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# ozure
+
+Read, edit and install **Fujifilm custom recipes (C1–C7)** over USB PTP, from
+the terminal. Ships 126 curated recipes (Fuji X Weekly, Osan-Bilgi, Alex
+Armitage, …) and keeps the same safety rails as the Python package: dry run by
+default, backup before writing, read-back verification.
+
+```bash
+npm install -g ozure
+
+ozure connect              # find the camera, list the seven slots
+ozure list                 # what is loaded right now
+ozure catalogs             # what could be installed
+ozure apply kodak-gold-200 --slot C6        # dry run: shows the diff, exit 10
+ozure apply kodak-gold-200 --slot C6 --yes  # writes, re-reads and verifies
+ozure catalog export       # save the camera's recipes into your own catalog
+```
+
+On the camera, pick **USB RAW CONV./BACKUP RESTORE**. Windows needs WinUSB on
+the PTP interface (Zadig, vendor id `04CB`); Linux may need a udev rule.
+
+No camera? `ozure connect --mock` runs against a simulated body.
+
+The npm package is a thin launcher: it runs the prebuilt binary for your
+platform (`ozure-<platform>-<arch>`). If that binary is missing and you
+already have the Python package, it falls back to `python -m ozure`.
+
+Docs, schema, protocol notes and the agent skill:
+[github.com/AlPeFe/ozure](https://github.com/AlPeFe/ozure).
+
+MIT.

package/bin/ozure.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+// ozure launcher: prefer the prebuilt binary that matches this platform,
+// otherwise fall back to a local Python install of the same version.
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const PLATFORM = `${process.platform}-${process.arch}`;
+const BINARY = process.platform === 'win32' ? 'ozure.exe' : 'ozure';
+// Stamped by tools/build_npm.py: the launcher package name, scoped or not.
+const PACKAGE_NAME = "@alpefe/ozure";
+const PLATFORM_PACKAGE = process.env.OZURE_NPM_PACKAGE || `${PACKAGE_NAME}-${PLATFORM}`;
+const args = process.argv.slice(2);
+
+function bundledBinary() {
+  try {
+    const manifest = require.resolve(`${PLATFORM_PACKAGE}/package.json`);
+    const candidate = path.join(path.dirname(manifest), 'bin', BINARY);
+    return fs.existsSync(candidate) ? candidate : null;
+  } catch {
+    return null;
+  }
+}
+
+function pythonModule() {
+  for (const candidate of ['python3', 'python', 'py']) {
+    const probe = spawnSync(candidate, ['-m', 'ozure', '--version'], {
+      stdio: 'ignore',
+      shell: false,
+    });
+    if (probe.status === 0) return candidate;
+  }
+  return null;
+}
+
+function run(command, commandArgs) {
+  const result = spawnSync(command, commandArgs, { stdio: 'inherit', shell: false });
+  if (result.error) {
+    console.error(`ozure: ${result.error.message}`);
+    process.exit(1);
+  }
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+    return;
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+const binary = bundledBinary();
+if (binary) {
+  run(binary, args);
+}
+
+const python = pythonModule();
+if (python) {
+  run(python, ['-m', 'ozure', ...args]);
+}
+
+console.error(
+  [
+    `ozure: no binary for ${PLATFORM} and no local Python install.`,
+    '',
+    '  npm:      npm install -g ozure   (binaries ship per platform)',
+    '  python:   pipx install "ozure[usb]"',
+    '',
+    'On macOS/Linux the prebuilt binary comes from the GitHub Releases page:',
+    '  https://github.com/AlPeFe/ozure/releases',
+  ].join('\n'),
+);
+process.exit(1);

package/package.json

@@ -1,6 +1,44 @@
-{
-  "name": "@alpefe/ozure",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@alpefe/ozure",
+  "version": "0.2.1",
+  "description": "Fujifilm custom recipes over USB PTP: read, edit and install C1-C7, with 126 recipes bundled",
+  "keywords": [
+    "fujifilm",
+    "fuji",
+    "x100vi",
+    "recipes",
+    "film-simulation",
+    "ptp",
+    "camera",
+    "cli",
+    "agent-skill"
+  ],
+  "homepage": "https://github.com/AlPeFe/ozure",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlPeFe/ozure.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AlPeFe/ozure/issues"
+  },
+  "license": "MIT",
+  "author": "Alex P\u00e9rez Fern\u00e1ndez",
+  "bin": {
+    "ozure": "bin/ozure.js"
+  },
+  "files": [
+    "bin/ozure.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "optionalDependencies": {
+    "@alpefe/ozure-win32-x64": "0.2.1",
+    "@alpefe/ozure-win32-arm64": "0.2.1",
+    "@alpefe/ozure-darwin-arm64": "0.2.1",
+    "@alpefe/ozure-darwin-x64": "0.2.1",
+    "@alpefe/ozure-linux-x64": "0.2.1",
+    "@alpefe/ozure-linux-arm64": "0.2.1"
+  }
+}