@airdraft/plugin-media 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [0.2.1](https://github.com/aevrHQ/airdraft/compare/plugin-media@v0.2.0...plugin-media@v0.2.1) (2026-05-22)
+
+
+### Features
+
+* add Next.js app detection and prompt for app directory in init commands ([2ed1afd](https://github.com/aevrHQ/airdraft/commit/2ed1afdd1ba3142fd50a9bfd4133f01c2ad22ae9))
+* add schema editor plugin and GitHub schema adapter for managing airdraft.schema.json ([46fd7f2](https://github.com/aevrHQ/airdraft/commit/46fd7f271afe8bc562d5f2fe72b94390cb257161))
+* add versioning and changelog support for all packages ([d6c85df](https://github.com/aevrHQ/airdraft/commit/d6c85dfed37f11c42151c93b49a80ede90699616))
+* **cli,core,docs:** implement local filesystem mode with enhanced initialization and error handling ([1848408](https://github.com/aevrHQ/airdraft/commit/1848408738ee3d2bfa0ef532e6dec7a3beef0fb1))
+* **cli:** add CMS client template and optional blog scaffolding to initialization ([cf7bda8](https://github.com/aevrHQ/airdraft/commit/cf7bda8137777aa319acd8edf55fb2cd718a9cd1))
+* **cli:** enhance project initialization templates with schema path support ([a3b20c9](https://github.com/aevrHQ/airdraft/commit/a3b20c9d0dbf0e23594079f1685be8d688e7779b))
+* **client:** add convenience methods for listing and retrieving entries ([c48e3f6](https://github.com/aevrHQ/airdraft/commit/c48e3f6848772bf1ed860785e1e3f9eadffb5ddc))
+* **content:** update content package with new field components and type changes ([e1bd5fa](https://github.com/aevrHQ/airdraft/commit/e1bd5fa8af9b2903024c39a0fa945e49f87754d3))
+* enhance media input components and add scoped media adapter for project isolation ([e599cf2](https://github.com/aevrHQ/airdraft/commit/e599cf2c488cf73164d1cb7b1ce479d6005cf923))
+* implement terminal UI helpers for improved user interaction ([0e0dca4](https://github.com/aevrHQ/airdraft/commit/0e0dca4a4e06196abea22e99c9a350fdd202a948))
+* **react-ui:** add CMSAdmin component and update related files for new admin functionality ([50f1459](https://github.com/aevrHQ/airdraft/commit/50f14598c268823615f61428ee1e0e399c610630))
+
+
+### Bug Fixes
+
+* improve error handling for missing schema file in buildProjectHandler ([4c3d318](https://github.com/aevrHQ/airdraft/commit/4c3d3184c9c454062fd2d9b33fb0593d5e91b71c))
+* update cloud package version to 0.1.4 and enhance audit log persistence logic ([e1fb0e5](https://github.com/aevrHQ/airdraft/commit/e1fb0e5509c7f95c4e659495bcdbd1339da20cea))
+* update package versions and enhance schema cache handling ([7f4f395](https://github.com/aevrHQ/airdraft/commit/7f4f39572168b4e75dd6f1d756ebd5ef2d7ddbe1))
+* update schema URL from airdraft.dev to airdraft.space ([dbace6e](https://github.com/aevrHQ/airdraft/commit/dbace6e13334f915feace70661810d5dc919f69b))
+
+
+### Documentation
+
+* add Releasing & Publishing section to README ([132193b](https://github.com/aevrHQ/airdraft/commit/132193bebff585ad3223ccb82176c30615f21443))
+
+# Changelog
+
 All notable changes to `@airdraft/plugin-media` will be documented here.
 
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { withMedia } from './withMedia.js';
 export type { WithMediaOptions, MediaUploadResult } from './withMedia.js';
+export { withAutoMedia } from './withAutoMedia.js';
+export type { WithAutoMediaOptions } from './withAutoMedia.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,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { withMedia } from './withMedia.js';
+export { withAutoMedia } from './withAutoMedia.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,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/withAutoMedia.d.ts

@@ -0,0 +1,38 @@
+import type { Plugin, StorageAdapter } from '@airdraft/core';
+export interface WithAutoMediaOptions {
+    /**
+     * Pass the content StorageAdapter to enable the full media library (sidecar
+     * metadata at `_media/{key}.json`). Omit for upload-only mode.
+     */
+    storageAdapter?: StorageAdapter;
+    /** Key prefix. Default: `'uploads'` */
+    prefix?: string;
+    /** MIME allowlist. Default: common image types. */
+    allowedTypes?: string[];
+    /** Max upload size in bytes. Default: 5 MB. */
+    maxSize?: number;
+    /**
+     * Root directory for local uploads (when `AWS_S3_BUCKET_NAME` is not set).
+     * Default: `{cwd}/public` — Next.js serves these files at `/{key}`.
+     */
+    localRoot?: string;
+}
+/**
+ * Builds a media plugin automatically from environment variables.
+ *
+ * - `AWS_S3_BUCKET_NAME` set → S3-compatible storage via `files-sdk` +
+ *   `@airdraft/media-adapter-files-sdk` (must be installed separately).
+ * - Otherwise → `@airdraft/media-adapter-local` writing to `{localRoot}/public`.
+ *
+ * @example
+ * ```ts
+ * import { withAutoMedia } from '@airdraft/plugin-media'
+ *
+ * const adapter = new LocalAdapter({ root: './content' })
+ * const media = await withAutoMedia({ storageAdapter: adapter })
+ *
+ * export default defineConfig({ adapter, plugins: [media] })
+ * ```
+ */
+export declare function withAutoMedia(options?: WithAutoMediaOptions): Promise<Plugin>;
+//# sourceMappingURL=withAutoMedia.d.ts.map

package/dist/withAutoMedia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAutoMedia.d.ts","sourceRoot":"","sources":["../src/withAutoMedia.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG5D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BvF"}

package/dist/withAutoMedia.js

@@ -0,0 +1,43 @@
+import { withMedia } from './withMedia.js';
+/**
+ * Builds a media plugin automatically from environment variables.
+ *
+ * - `AWS_S3_BUCKET_NAME` set → S3-compatible storage via `files-sdk` +
+ *   `@airdraft/media-adapter-files-sdk` (must be installed separately).
+ * - Otherwise → `@airdraft/media-adapter-local` writing to `{localRoot}/public`.
+ *
+ * @example
+ * ```ts
+ * import { withAutoMedia } from '@airdraft/plugin-media'
+ *
+ * const adapter = new LocalAdapter({ root: './content' })
+ * const media = await withAutoMedia({ storageAdapter: adapter })
+ *
+ * export default defineConfig({ adapter, plugins: [media] })
+ * ```
+ */
+export async function withAutoMedia(options = {}) {
+    const { storageAdapter, prefix = 'uploads', allowedTypes = ['image/jpeg', 'image/png', 'image/webp', 'image/gif', 'image/svg+xml'], maxSize = 5 * 1024 * 1024, localRoot = process.cwd() + '/public', } = options;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let adapter;
+    if (process.env.AWS_S3_BUCKET_NAME) {
+        // Dynamic — requires files-sdk + @airdraft/media-adapter-files-sdk to be installed.
+        const { Files } = await import('files-sdk');
+        const { s3 } = await import('files-sdk/s3');
+        const { FilesSdkMediaAdapter } = await import('@airdraft/media-adapter-files-sdk');
+        const files = new Files({
+            adapter: s3({
+                bucket: process.env.AWS_S3_BUCKET_NAME,
+                region: process.env.AWS_REGION ?? 'us-east-1',
+                // Credentials auto-loaded from AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY
+            }),
+        });
+        adapter = new FilesSdkMediaAdapter({ files });
+    }
+    else {
+        const { LocalMediaAdapter } = await import('@airdraft/media-adapter-local');
+        adapter = new LocalMediaAdapter({ root: localRoot });
+    }
+    return withMedia({ adapter, storageAdapter, prefix, allowedTypes, maxSize });
+}
+//# sourceMappingURL=withAutoMedia.js.map

package/dist/withAutoMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAutoMedia.js","sourceRoot":"","sources":["../src/withAutoMedia.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAqB1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,EACJ,cAAc,EACd,MAAM,GAAG,SAAS,EAClB,YAAY,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,CAAC,EACtF,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EACzB,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,SAAS,GACtC,GAAG,OAAO,CAAA;IAEX,8DAA8D;IAC9D,IAAI,OAAY,CAAA;IAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,oFAAoF;QACpF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,WAAqB,CAA+B,CAAA;QACnF,MAAM,EAAE,EAAE,EAAE,GAAK,MAAM,MAAM,CAAC,cAAwB,CAAkC,CAAA;QACxF,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,mCAA6C,CAAuD,CAAA;QAClJ,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;YACtB,OAAO,EAAE,EAAE,CAAC;gBACV,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;gBACtC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW;gBAC7C,yEAAyE;aAC1E,CAAC;SACH,CAAC,CAAA;QACF,OAAO,GAAG,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/C,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAAyC,CAAmD,CAAA;QACvI,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAA;AAC9E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airdraft/plugin-media",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Airdraft media plugin — image upload, optimisation, CDN",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,7 +11,11 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist", "README.md", "CHANGELOG.md"],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
@@ -25,7 +29,9 @@
     "release:minor": "standard-version --release-as minor",
     "release:major": "standard-version --release-as major"
   },
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -37,5 +43,7 @@
   "dependencies": {
     "@airdraft/core": "*"
   },
-  "engines": { "node": ">=18.0.0" }
+  "engines": {
+    "node": ">=18.0.0"
+  }
 }