aemdm 0.1.3 → 0.3.0

package/README.md

@@ -189,36 +189,19 @@ aemdm search --raw-query @./query.json
 
 ## Publishing
 
-Before publishing a new release, verify the package contents and publish from the repo root:
+The repository includes a `/release` skill for Claude Code that automates the full release process:
 
-```bash
-npm test
-npm run pack:check
-npm publish
 ```
-
-`prepack` builds `dist/`, and `prepublishOnly` runs the test suite during `npm publish`.
-
-### Automated npm publish from GitHub
-
-The repository includes a GitHub Actions workflow that publishes to npm when you push a version tag like `v0.1.3` or publish a GitHub release for that tag.
-
-Required setup:
-
-```bash
-NPM_TOKEN
+/release patch   # 0.2.1 → 0.2.2
+/release minor   # 0.2.1 → 0.3.0
+/release major   # 0.2.1 → 1.0.0
 ```
 
-Add `NPM_TOKEN` as a GitHub repository secret with permission to publish the `aemdm` package on npm.
-
-Release flow:
+The skill bumps the version across all files, builds, tests, commits, pushes, creates a git tag, and creates a GitHub release.
 
-```bash
-git tag v0.1.3
-git push origin v0.1.3
-```
+Publishing to npm is triggered automatically when a GitHub release is created. The workflow uses npm trusted publishing (OIDC) via the `npm` GitHub environment — no token secret is needed.
 
-The workflow verifies that the tag matches the `version` field in `package.json`, runs `lint`, `build`, and `test`, and then publishes the package.
+The workflow verifies that the release tag matches the `version` field in `package.json`, runs `lint`, `build`, and `test`, and then publishes the package with provenance.
 
 ## References
 

package/dist/cli.js

@@ -1,12 +1,18 @@
 #!/usr/bin/env node
-import { pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
 import { Command, CommanderError, Option } from "commander";
 import { z } from "zod";
-import { CliError, request, requestJson, resolveBucket, resolveOptionalImsToken, resolveSearchAuth, } from "./lib/client.js";
+import { CliError, normalizeBucket, request, requestJson, resolveBucket, resolveOptionalImsToken, resolveSearchAuth, } from "./lib/client.js";
 import { readProfileConfig, writeProfileConfig, } from "./lib/config.js";
 import { buildAssetUrl, buildMetadataUrl, deliveryFormatSchema, resolveDimensions, } from "./lib/delivery.js";
 import { buildSearchRequest, getAssetIdFromHit, loadRawQuery, } from "./lib/search.js";
 import { formatSearchResults, writeBinaryOutput, writeJson, writeLine, } from "./lib/output.js";
+function verbose(runtime, message) {
+    if (runtime.verbose) {
+        writeLine(runtime.stderr, `[verbose] ${message}`);
+    }
+}
 const numberOption = (flagName) => (value) => {
     const parsed = Number(value);
     if (!Number.isInteger(parsed)) {
@@ -161,8 +167,19 @@ async function handleAssetGet(assetId, options, runtime) {
     const parsed = parseWithSchema(assetGetSchema, options);
     const profile = await readProfileConfig(runtime.env);
     const baseUrl = resolveBucket(parsed.bucket, runtime.env, profile.bucket);
-    const imsToken = resolveOptionalImsToken(parsed.imsToken, runtime.env);
+    const imsToken = resolveOptionalImsToken(parsed.imsToken, runtime.env, profile.imsToken);
     const dimensions = resolveDimensions(parsed.size, parsed.width, parsed.height);
+    verbose(runtime, `bucket: ${baseUrl}`);
+    verbose(runtime, `asset:  ${assetId}`);
+    if (imsToken)
+        verbose(runtime, `auth:   IMS token provided`);
+    if (dimensions.width || dimensions.height) {
+        verbose(runtime, `dimensions: ${dimensions.width ?? "auto"}x${dimensions.height ?? "auto"}`);
+    }
+    if (parsed.format)
+        verbose(runtime, `format: ${parsed.format}`);
+    if (parsed.quality)
+        verbose(runtime, `quality: ${parsed.quality}`);
     if (parsed.metadata) {
         const metadata = imsToken
             ? await requestJson(buildMetadataUrl(baseUrl, assetId), {
@@ -210,9 +227,21 @@ async function handleSearch(options, runtime) {
     const parsed = parseWithSchema(searchSchema, options);
     const profile = await readProfileConfig(runtime.env);
     const baseUrl = resolveBucket(parsed.bucket, runtime.env, profile.bucket);
-    const { imsToken, apiKey } = resolveSearchAuth(parsed.imsToken, parsed.apiKey, runtime.env);
+    const { imsToken, apiKey } = resolveSearchAuth(parsed.imsToken, parsed.apiKey, runtime.env, profile.imsToken);
     const searchBody = await buildSearchBody(parsed);
     const searchUrl = `${baseUrl}/search`;
+    verbose(runtime, `bucket:   ${baseUrl}`);
+    verbose(runtime, `search:   POST ${searchUrl}`);
+    verbose(runtime, `api-key:  ${apiKey}`);
+    verbose(runtime, `auth:     IMS token provided`);
+    if (parsed.text)
+        verbose(runtime, `text:     "${parsed.text}"`);
+    if (parsed.where.length > 0)
+        verbose(runtime, `where:    ${parsed.where.join(", ")}`);
+    if (parsed.limit !== undefined)
+        verbose(runtime, `limit:    ${parsed.limit}`);
+    if (parsed.rawQuery)
+        verbose(runtime, `raw-query: ${parsed.rawQuery}`);
     const response = await requestJson(searchUrl, {
         method: "POST",
         imsToken,
@@ -220,6 +249,9 @@ async function handleSearch(options, runtime) {
         jsonBody: searchBody,
         fetchImpl: runtime.fetchImpl,
     });
+    const resultCount = response.hits?.results?.length ?? 0;
+    const totalCount = response.search_metadata?.totalCount?.total;
+    verbose(runtime, `results:  ${resultCount} returned${totalCount !== undefined ? ` (${totalCount} total)` : ""}`);
     if (parsed.json) {
         writeJson(runtime.stdout, response);
         return;
@@ -315,13 +347,17 @@ function buildProgram(runtime) {
     program
         .name("aemdm")
         .description("CLI for Adobe Dynamic Media with OpenAPI")
-        .version("0.1.0")
+        .version("0.3.0")
         .showHelpAfterError()
+        .option("-v, --verbose", "Show additional diagnostic output")
         .configureOutput({
         writeOut: (text) => runtime.stdout.write(text),
         writeErr: (text) => runtime.stderr.write(text),
     })
-        .exitOverride();
+        .exitOverride()
+        .hook("preAction", () => {
+        runtime.verbose = program.opts().verbose === true;
+    });
     configureCommonDeliveryOptions(program.command("asset").description("Asset operations"))
         .command("get <assetId>")
         .description("Build a delivery URL, fetch metadata, or download a binary for an asset")
@@ -365,7 +401,8 @@ Core commands:
 Important defaults:
 - Bucket comes from --bucket or AEMDM_BUCKET.
 - A standalone call like aemdm --bucket delivery-p123-e456.adobeaemcloud.com saves the default bucket to the local aemdm profile config.
-- Search auth comes from --ims-token/AEMDM_IMS_TOKEN and --api-key/AEMDM_API_KEY.
+- aemdm --ims-token <token> saves the IMS token to the profile config. Both can be saved together.
+- Search auth comes from --ims-token/AEMDM_IMS_TOKEN/profile config and --api-key/AEMDM_API_KEY.
 - asset get prints a URL by default.
 - asset get --metadata prints full JSON metadata when authenticated, or basic public JSON metadata when no token is supplied.
 - asset get --binary downloads the asset and requires --output.
@@ -408,14 +445,31 @@ LLM usage guidance:
 - Prefer --first-binary with --output when the user wants the downloaded file.
 `;
 }
-function getStandaloneBucketValue(argv) {
-    if (argv.length === 1 && argv[0].startsWith("--bucket=")) {
-        return argv[0].slice("--bucket=".length);
+function parseStandaloneConfig(argv) {
+    const config = {};
+    const args = [...argv];
+    while (args.length > 0) {
+        const arg = args.shift();
+        if (arg.startsWith("--bucket=")) {
+            config.bucket = arg.slice("--bucket=".length);
+        }
+        else if (arg === "--bucket" && args.length > 0) {
+            config.bucket = args.shift();
+        }
+        else if (arg.startsWith("--ims-token=")) {
+            config.imsToken = arg.slice("--ims-token=".length);
+        }
+        else if (arg === "--ims-token" && args.length > 0) {
+            config.imsToken = args.shift();
+        }
+        else {
+            return undefined;
+        }
     }
-    if (argv.length === 2 && argv[0] === "--bucket") {
-        return argv[1];
+    if (!config.bucket && !config.imsToken) {
+        return undefined;
     }
-    return undefined;
+    return config;
 }
 function toCliError(error) {
     if (error instanceof CliError) {
@@ -442,14 +496,25 @@ export async function runCli(argv, runtimeOverrides = {}) {
         stdout: process.stdout,
         stderr: process.stderr,
         fetchImpl: fetch,
+        verbose: false,
         ...runtimeOverrides,
     };
     try {
-        const standaloneBucket = getStandaloneBucketValue(argv);
-        if (standaloneBucket !== undefined) {
-            const bucket = resolveBucket(standaloneBucket, runtime.env);
-            const configPath = await writeProfileConfig(runtime.env, { bucket });
-            writeLine(runtime.stdout, `Saved bucket to profile config: ${bucket}`);
+        const standaloneConfig = parseStandaloneConfig(argv);
+        if (standaloneConfig !== undefined) {
+            const existing = await readProfileConfig(runtime.env);
+            const merged = { ...existing };
+            if (standaloneConfig.bucket) {
+                merged.bucket = normalizeBucket(standaloneConfig.bucket);
+            }
+            if (standaloneConfig.imsToken) {
+                merged.imsToken = standaloneConfig.imsToken;
+            }
+            const configPath = await writeProfileConfig(runtime.env, merged);
+            if (merged.bucket)
+                writeLine(runtime.stdout, `Saved bucket: ${merged.bucket}`);
+            if (standaloneConfig.imsToken)
+                writeLine(runtime.stdout, `Saved IMS token to profile config`);
             writeLine(runtime.stdout, `Config file: ${configPath}`);
             return 0;
         }
@@ -470,7 +535,7 @@ export async function runCli(argv, runtimeOverrides = {}) {
     }
 }
 const executedDirectly = process.argv[1] !== undefined &&
-    import.meta.url === pathToFileURL(process.argv[1]).href;
+    fileURLToPath(import.meta.url) === realpathSync(process.argv[1]);
 if (executedDirectly) {
     const exitCode = await runCli(process.argv.slice(2));
     process.exitCode = exitCode;

package/dist/lib/client.js

@@ -40,11 +40,11 @@ export function resolveBucket(explicitValue, env, profileBucket) {
     }
     return normalizeBucket(bucket);
 }
-export function resolveOptionalImsToken(explicitValue, env) {
-    return explicitValue ?? env.AEMDM_IMS_TOKEN;
+export function resolveOptionalImsToken(explicitValue, env, profileImsToken) {
+    return explicitValue ?? env.AEMDM_IMS_TOKEN ?? profileImsToken;
 }
-export function resolveSearchAuth(imsToken, apiKey, env) {
-    const resolvedImsToken = imsToken ?? env.AEMDM_IMS_TOKEN;
+export function resolveSearchAuth(imsToken, apiKey, env, profileImsToken) {
+    const resolvedImsToken = imsToken ?? env.AEMDM_IMS_TOKEN ?? profileImsToken;
     const resolvedApiKey = apiKey ?? env.AEMDM_API_KEY ?? "asset_search_service";
     if (!resolvedImsToken) {
         throw new CliError("Missing IMS token. Use --ims-token or set AEMDM_IMS_TOKEN.");

package/dist/lib/config.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { z } from "zod";
 const profileSchema = z.object({
     bucket: z.string().optional(),
+    imsToken: z.string().optional(),
 });
 export function resolveConfigPath(env) {
     if (env.AEMDM_CONFIG_PATH) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aemdm",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "CLI for Adobe Dynamic Media with OpenAPI",
   "license": "Apache-2.0",
   "author": "Chris Pilsworth",