@kristijorgji/static-asset-upload 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kristijorgji
+
+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,116 @@
+# @kristijorgji/static-asset-upload
+
+Upload a caller-supplied static-asset manifest to S3-compatible object storage (AWS S3, Cloudflare R2, MinIO). Framework-agnostic: there is no Next.js peer and no default `web/` or `_next/` prefix.
+
+The package plans files from local directories, maps Cache-Control and Content-Type, and puts objects. CDN layout, env wiring, and prune/invalidation stay in the app.
+
+## Install
+
+```bash
+pnpm add -D @kristijorgji/static-asset-upload
+```
+
+## Setup
+
+Create `static-assets.config.ts` at the app root (discovered upward as `.ts`, `.mts`, `.js`, or `.mjs`):
+
+```ts
+import { defineStaticAssetsConfig } from '@kristijorgji/static-asset-upload/config';
+
+export default defineStaticAssetsConfig({
+    root: import.meta.dirname,
+    bucket: process.env.ASSETS_BUCKET!,
+    region: process.env.S3_REGION ?? 'auto',
+    commit: process.env.APP_VERSION!,
+    endpoint: process.env.S3_ENDPOINT,
+    forcePathStyle: Boolean(process.env.S3_ENDPOINT),
+    commitPrefix: 'assets/{commit}',
+    sharedPrefix: 'assets/shared',
+    requiredTargetIds: ['hashed-static'],
+    validateCommit: (commit) => {
+        if (!/^[0-9a-f]{7,40}$/i.test(commit)) {
+            throw new Error('commit must be a git hash (7–40 hex characters)');
+        }
+    },
+    targets: [
+        {
+            id: 'hashed-static',
+            localDir: 'dist/static',
+            remotePrefix: '{commitPrefix}/static',
+            versioning: 'commit',
+            cacheControl: 'public, max-age=31536000, immutable',
+        },
+        {
+            id: 'public-icons',
+            localDir: 'public',
+            remotePrefix: '{sharedPrefix}',
+            versioning: 'shared',
+            cacheControl: 'public, max-age=10800',
+            include: ['icon.png'],
+            exclude: ['sw.js'],
+            optional: true,
+        },
+    ],
+});
+```
+
+Add a script:
+
+```json
+{
+  "scripts": {
+    "assets:upload": "kj-static-assets upload",
+    "assets:upload:dry": "kj-static-assets upload --dry-run"
+  }
+}
+```
+
+AWS credentials use the standard SDK chain. Set `endpoint` (and usually `forcePathStyle`) for R2 or MinIO.
+
+## Commands
+
+| Command | Flags | When |
+| --- | --- | --- |
+| `upload` | `--dry-run` | Put planned objects, or print the plan and exit 0 |
+
+## Config
+
+| Field | Default | Purpose |
+| --- | --- | --- |
+| `root` | required | App directory; `localDir` values are relative to this |
+| `bucket` | required | Destination bucket |
+| `commit` | required | Substituted into `{commit}` in prefixes |
+| `commitPrefix` / `sharedPrefix` | required | Remote key prefixes; `{commit}` is expanded |
+| `targets` | required | Directories to walk |
+| `region` | `us-east-1` | Passed to the S3 client (`auto` is valid for R2) |
+| `endpoint` | unset | S3-compatible API URL |
+| `forcePathStyle` | `false` | Path-style addressing for MinIO / some R2 setups |
+| `targetIds` | all targets | Limit the plan to these target ids |
+| `requiredTargetIds` | `[]` | Fail if a listed target produces no files |
+| `validateCommit` | no-op | Optional commit-format check |
+
+Each target sets its own `cacheControl` string. `{commitPrefix}` and `{sharedPrefix}` in `remotePrefix` are expanded by the planner.
+
+## Programmatic API
+
+```ts
+import {
+    assertRequiredTargets,
+    defineStaticAssetsConfig,
+    resolveUploadPlan,
+    runStaticAssetUpload,
+} from '@kristijorgji/static-asset-upload';
+
+const config = defineStaticAssetsConfig({ /* ... */ });
+const plan = resolveUploadPlan(config);
+assertRequiredTargets(plan, config);
+await runStaticAssetUpload(config, { dryRun: true });
+```
+
+`runStaticAssetUpload` constructs an `S3Client` from `region` / `endpoint` / `forcePathStyle`. Tests can pass `{ client: { send } }` instead.
+
+Plan entries use `remoteKey` (object key), not a vendor-specific field name.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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,19 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { logFatalAndExitFromError } from '@kristijorgji/cli-kit';
+import { runUpload } from './commands/upload.js';
+import { loadConfig } from './config/load-config.js';
+const program = new Command();
+program.name('kj-static-assets').description('Upload static assets from a caller-supplied manifest to S3-compatible storage');
+program
+    .command('upload')
+    .description('Upload files from static-assets.config to object storage')
+    .option('--dry-run', 'print the upload plan without putting objects', false)
+    .action(async (options) => {
+    const config = await loadConfig();
+    await runUpload(config, { dryRun: Boolean(options.dryRun) });
+});
+program.parseAsync(process.argv).catch((error) => {
+    logFatalAndExitFromError(error);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,+EAA+E,CAAC,CAAC;AAE9H,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0DAA0D,CAAC;KACvE,MAAM,CAAC,WAAW,EAAE,+CAA+C,EAAE,KAAK,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;IAC5C,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEP,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACtD,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC"}

package/dist/commands/upload.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedStaticAssetsConfig } from '../config/types.js';
+export declare function runUpload(config: ResolvedStaticAssetsConfig, options: {
+    dryRun: boolean;
+}): Promise<void>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/commands/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/commands/upload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGrE,wBAAsB,SAAS,CAC3B,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/commands/upload.js

@@ -0,0 +1,11 @@
+import { cliLogger } from '@kristijorgji/cli-kit';
+import { runStaticAssetUpload } from '../upload/run-upload.js';
+export async function runUpload(config, options) {
+    const result = await runStaticAssetUpload(config, { dryRun: options.dryRun });
+    if (options.dryRun) {
+        cliLogger.info('Dry run complete');
+        return;
+    }
+    cliLogger.info(`Upload complete (${result.totalUploaded} files)`);
+}
+//# sourceMappingURL=upload.js.map

package/dist/commands/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/commands/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,MAAkC,EAClC,OAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACnC,OAAO;IACX,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,aAAa,SAAS,CAAC,CAAC;AACtE,CAAC"}

package/dist/config/define-config.d.ts

@@ -0,0 +1,3 @@
+import type { StaticAssetsConfig } from './types.js';
+export declare function defineStaticAssetsConfig(config: StaticAssetsConfig): StaticAssetsConfig;
+//# sourceMappingURL=define-config.d.ts.map

package/dist/config/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAEvF"}

package/dist/config/define-config.js

@@ -0,0 +1,4 @@
+export function defineStaticAssetsConfig(config) {
+    return config;
+}
+//# sourceMappingURL=define-config.js.map

package/dist/config/define-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IAC/D,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+export { defineStaticAssetsConfig } from './define-config.js';
+export { expandPlaceholders, findConfigFile, loadConfig, resolveStaticAssetsConfig } from './load-config.js';
+export type { ResolvedStaticAssetsConfig, StaticAssetStoreClient, StaticAssetTarget, StaticAssetUploadOptions, StaticAssetsConfig, UploadPlan, UploadPlanEntry, UploadResult, VersioningTier, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7G,YAAY,EACR,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,YAAY,EACZ,cAAc,GACjB,MAAM,YAAY,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export { defineStaticAssetsConfig } from './define-config.js';
+export { expandPlaceholders, findConfigFile, loadConfig, resolveStaticAssetsConfig } from './load-config.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/load-config.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedStaticAssetsConfig, StaticAssetsConfig } from './types.js';
+export declare function findConfigFile(startDir: string): string | null;
+export declare function expandPlaceholders(template: string, vars: Record<string, string>): string;
+export declare function resolveStaticAssetsConfig(config: StaticAssetsConfig, baseDir?: string): ResolvedStaticAssetsConfig;
+export declare function loadConfig(cwd?: string): Promise<ResolvedStaticAssetsConfig>;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/config/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAWjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe9D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEzF;AAED,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,MAAsB,GAChC,0BAA0B,CAuC5B;AAED,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAYjG"}

package/dist/config/load-config.js

@@ -0,0 +1,77 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { createJiti } from 'jiti';
+const CONFIG_FILENAMES = [
+    'static-assets.config.ts',
+    'static-assets.config.mts',
+    'static-assets.config.js',
+    'static-assets.config.mjs',
+];
+const DEFAULT_REGION = 'us-east-1';
+export function findConfigFile(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        for (const filename of CONFIG_FILENAMES) {
+            const candidate = join(current, filename);
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export function expandPlaceholders(template, vars) {
+    return template.replace(/\{(\w+)\}/g, (match, key) => vars[key] ?? match);
+}
+export function resolveStaticAssetsConfig(config, baseDir = process.cwd()) {
+    if (!config.root?.trim()) {
+        throw new Error('static-assets config must set root');
+    }
+    if (!config.bucket?.trim()) {
+        throw new Error('static-assets config must set bucket');
+    }
+    if (!config.commit?.trim()) {
+        throw new Error('static-assets config must set commit');
+    }
+    if (!config.commitPrefix?.trim()) {
+        throw new Error('static-assets config must set commitPrefix');
+    }
+    if (!config.sharedPrefix?.trim()) {
+        throw new Error('static-assets config must set sharedPrefix');
+    }
+    if (!config.targets?.length) {
+        throw new Error('static-assets config must set targets');
+    }
+    config.validateCommit?.(config.commit);
+    const commitVars = { commit: config.commit };
+    const commitPrefix = expandPlaceholders(config.commitPrefix, commitVars).replace(/\/$/, '');
+    const sharedPrefix = expandPlaceholders(config.sharedPrefix, commitVars).replace(/\/$/, '');
+    return {
+        root: resolve(baseDir, config.root),
+        bucket: config.bucket,
+        region: config.region?.trim() || DEFAULT_REGION,
+        commit: config.commit,
+        endpoint: config.endpoint?.trim() || undefined,
+        forcePathStyle: Boolean(config.forcePathStyle),
+        commitPrefix,
+        sharedPrefix,
+        targets: config.targets,
+        targetIds: config.targetIds,
+        requiredTargetIds: config.requiredTargetIds ?? [],
+    };
+}
+export async function loadConfig(cwd = process.cwd()) {
+    const configPath = findConfigFile(cwd);
+    if (!configPath) {
+        throw new Error(`No static-assets.config.ts found from ${cwd}. Create one with defineStaticAssetsConfig().`);
+    }
+    const jiti = createJiti(import.meta.url);
+    const loaded = (await jiti.import(configPath));
+    const config = loaded.default ?? loaded;
+    return resolveStaticAssetsConfig(config, dirname(configPath));
+}
+//# sourceMappingURL=load-config.js.map

package/dist/config/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"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"}

package/dist/config/types.d.ts

@@ -0,0 +1,68 @@
+export type VersioningTier = 'commit' | 'shared';
+export interface StaticAssetTarget {
+    id: string;
+    localDir: string;
+    /** `{commitPrefix}` and `{sharedPrefix}` are expanded by the planner. */
+    remotePrefix: string;
+    versioning: VersioningTier;
+    /** Caller-supplied Cache-Control header value. */
+    cacheControl: string;
+    optional?: boolean;
+    include?: readonly string[];
+    exclude?: readonly string[];
+}
+export interface StaticAssetsConfig {
+    root: string;
+    bucket: string;
+    region?: string;
+    commit: string;
+    /** S3-compatible endpoint (R2, MinIO). Omit for AWS. */
+    endpoint?: string;
+    forcePathStyle?: boolean;
+    /** May include `{commit}`; expanded before remote prefixes. */
+    commitPrefix: string;
+    sharedPrefix: string;
+    targets: readonly StaticAssetTarget[];
+    targetIds?: readonly string[];
+    requiredTargetIds?: readonly string[];
+    validateCommit?: (commit: string) => void;
+}
+export interface ResolvedStaticAssetsConfig {
+    root: string;
+    bucket: string;
+    region: string;
+    commit: string;
+    endpoint?: string;
+    forcePathStyle: boolean;
+    commitPrefix: string;
+    sharedPrefix: string;
+    targets: readonly StaticAssetTarget[];
+    targetIds?: readonly string[];
+    requiredTargetIds: readonly string[];
+}
+export interface UploadPlanEntry {
+    targetId: string;
+    localPath: string;
+    remoteKey: string;
+    contentType: string;
+    cacheControl: string;
+}
+export interface UploadPlan {
+    bucket: string;
+    region: string;
+    commit: string;
+    entries: UploadPlanEntry[];
+}
+export interface UploadResult {
+    uploadedByTarget: Record<string, number>;
+    totalUploaded: number;
+}
+export type StaticAssetStoreClient = {
+    send(command: unknown): Promise<unknown>;
+};
+export interface StaticAssetUploadOptions {
+    dryRun?: boolean;
+    client?: StaticAssetStoreClient;
+    baseDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;IAC3B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IACzB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACjC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/config/types.js

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

package/dist/config/types.js.map

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

package/dist/fs/walk-files.d.ts

@@ -0,0 +1,3 @@
+/** Recursively list all file paths under a directory. */
+export declare function walkFiles(directory: string): string[];
+//# sourceMappingURL=walk-files.d.ts.map

package/dist/fs/walk-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-files.d.ts","sourceRoot":"","sources":["../../src/fs/walk-files.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrD"}

package/dist/fs/walk-files.js

@@ -0,0 +1,18 @@
+import { readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/** Recursively list all file paths under a directory. */
+export function walkFiles(directory) {
+    const entries = readdirSync(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...walkFiles(fullPath));
+        }
+        else if (entry.isFile()) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=walk-files.js.map

package/dist/fs/walk-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-files.js","sourceRoot":"","sources":["../../src/fs/walk-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,SAAiB;IACvC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/glob/match.d.ts

@@ -0,0 +1,4 @@
+/** Match a path against simple glob patterns (`*`, `**`, `/`). */
+export declare function matchesGlob(relativePath: string, pattern: string): boolean;
+export declare function matchesAnyGlob(relativePath: string, patterns: readonly string[]): boolean;
+//# sourceMappingURL=match.d.ts.map

package/dist/glob/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/glob/match.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1E;AA2BD,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEzF"}

package/dist/glob/match.js

@@ -0,0 +1,38 @@
+/** Match a path against simple glob patterns (`*`, `**`, `/`). */
+export function matchesGlob(relativePath, pattern) {
+    const normalizedPath = relativePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    const regex = globToRegExp(normalizedPattern);
+    return regex.test(normalizedPath);
+}
+function globToRegExp(pattern) {
+    const chars = [...pattern];
+    let regex = '^';
+    for (let index = 0; index < chars.length; index += 1) {
+        const char = chars[index];
+        if (char === '*') {
+            if (chars[index + 1] === '*') {
+                regex += '.*';
+                index += 1;
+                if (chars[index + 1] === '/') {
+                    index += 1;
+                }
+            }
+            else {
+                regex += '[^/]*';
+            }
+        }
+        else if (char !== undefined && '.+^${}()|[]\\'.includes(char)) {
+            regex += `\\${char}`;
+        }
+        else {
+            regex += char;
+        }
+    }
+    regex += '$';
+    return new RegExp(regex);
+}
+export function matchesAnyGlob(relativePath, patterns) {
+    return patterns.some((pattern) => matchesGlob(relativePath, pattern));
+}
+//# sourceMappingURL=match.js.map

package/dist/glob/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/glob/match.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,OAAe;IAC7D,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACjC,MAAM,KAAK,GAAa,CAAC,GAAG,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,GAAG,GAAG,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,KAAK,IAAI,IAAI,CAAC;gBACd,KAAK,IAAI,CAAC,CAAC;gBACX,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3B,KAAK,IAAI,CAAC,CAAC;gBACf,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,KAAK,IAAI,OAAO,CAAC;YACrB,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,KAAK,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,KAAK,IAAI,IAAI,CAAC;QAClB,CAAC;IACL,CAAC;IACD,KAAK,IAAI,GAAG,CAAC;IACb,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,QAA2B;IAC5E,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { defineStaticAssetsConfig, loadConfig, resolveStaticAssetsConfig } from './config/index.js';
+export type { ResolvedStaticAssetsConfig, StaticAssetStoreClient, StaticAssetTarget, StaticAssetUploadOptions, StaticAssetsConfig, UploadPlan, UploadPlanEntry, UploadResult, VersioningTier, } from './config/index.js';
+export { assertRequiredTargets, resolveUploadPlan } from './plan/resolve-plan.js';
+export { runStaticAssetUpload } from './upload/run-upload.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACpG,YAAY,EACR,0BAA0B,EAC1B,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,YAAY,EACZ,cAAc,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { defineStaticAssetsConfig, loadConfig, resolveStaticAssetsConfig } from './config/index.js';
+export { assertRequiredTargets, resolveUploadPlan } from './plan/resolve-plan.js';
+export { runStaticAssetUpload } from './upload/run-upload.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAYpG,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/mime/content-type.d.ts

@@ -0,0 +1,2 @@
+export declare function contentTypeForFileName(fileName: string): string;
+//# sourceMappingURL=content-type.d.ts.map

package/dist/mime/content-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.d.ts","sourceRoot":"","sources":["../../src/mime/content-type.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/mime/content-type.js

@@ -0,0 +1,5 @@
+import { lookup as lookupMimeType } from 'mime-types';
+export function contentTypeForFileName(fileName) {
+    return lookupMimeType(fileName) || 'application/octet-stream';
+}
+//# sourceMappingURL=content-type.js.map

package/dist/mime/content-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type.js","sourceRoot":"","sources":["../../src/mime/content-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACnD,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,0BAA0B,CAAC;AAClE,CAAC"}

package/dist/plan/resolve-plan.d.ts

@@ -0,0 +1,4 @@
+import type { StaticAssetsConfig, UploadPlan } from '../config/types.js';
+export declare function resolveUploadPlan(config: StaticAssetsConfig, baseDir?: string): UploadPlan;
+export declare function assertRequiredTargets(plan: UploadPlan, config: StaticAssetsConfig): void;
+//# sourceMappingURL=resolve-plan.d.ts.map

package/dist/plan/resolve-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-plan.d.ts","sourceRoot":"","sources":["../../src/plan/resolve-plan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGR,kBAAkB,EAClB,UAAU,EAEb,MAAM,oBAAoB,CAAC;AAoD5B,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,MAAsB,GAAG,UAAU,CAiBzG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAYxF"}

package/dist/plan/resolve-plan.js

@@ -0,0 +1,74 @@
+import { existsSync } from 'node:fs';
+import { basename, relative, resolve } from 'node:path';
+import { expandPlaceholders, resolveStaticAssetsConfig } from '../config/load-config.js';
+import { walkFiles } from '../fs/walk-files.js';
+import { matchesAnyGlob } from '../glob/match.js';
+import { contentTypeForFileName } from '../mime/content-type.js';
+function shouldIncludeFile(relativePath, target) {
+    if (target.exclude?.length && matchesAnyGlob(relativePath, target.exclude)) {
+        return false;
+    }
+    if (target.include?.length) {
+        return matchesAnyGlob(relativePath, target.include);
+    }
+    return true;
+}
+function resolveTargetEntries(config, target) {
+    const localDirectory = resolve(config.root, target.localDir);
+    if (!existsSync(localDirectory)) {
+        if (target.optional) {
+            return [];
+        }
+        throw new Error(`Missing required directory: ${localDirectory}`);
+    }
+    const remotePrefix = expandPlaceholders(target.remotePrefix, {
+        commit: config.commit,
+        commitPrefix: config.commitPrefix,
+        sharedPrefix: config.sharedPrefix,
+    }).replace(/\/$/, '');
+    const entries = [];
+    for (const filePath of walkFiles(localDirectory)) {
+        const relativePath = relative(localDirectory, filePath).split('\\').join('/');
+        if (!shouldIncludeFile(relativePath, target)) {
+            continue;
+        }
+        entries.push({
+            targetId: target.id,
+            localPath: filePath,
+            remoteKey: `${remotePrefix}/${relativePath}`,
+            contentType: contentTypeForFileName(basename(relativePath)),
+            cacheControl: target.cacheControl,
+        });
+    }
+    return entries;
+}
+export function resolveUploadPlan(config, baseDir = process.cwd()) {
+    const resolved = resolveStaticAssetsConfig(config, baseDir);
+    const entries = [];
+    for (const target of resolved.targets) {
+        if (resolved.targetIds && !resolved.targetIds.includes(target.id)) {
+            continue;
+        }
+        entries.push(...resolveTargetEntries(resolved, target));
+    }
+    return {
+        bucket: resolved.bucket,
+        region: resolved.region,
+        commit: resolved.commit,
+        entries,
+    };
+}
+export function assertRequiredTargets(plan, config) {
+    const requiredTargetIds = config.requiredTargetIds ?? [];
+    const knownIds = new Set(config.targets.map((target) => target.id));
+    for (const targetId of requiredTargetIds) {
+        if (!knownIds.has(targetId)) {
+            throw new Error(`Unknown required upload target: ${targetId}`);
+        }
+        const count = plan.entries.filter((entry) => entry.targetId === targetId).length;
+        if (count === 0) {
+            throw new Error(`Required upload target "${targetId}" produced no files`);
+        }
+    }
+}
+//# sourceMappingURL=resolve-plan.js.map

package/dist/plan/resolve-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-plan.js","sourceRoot":"","sources":["../../src/plan/resolve-plan.ts"],"names":[],"mappings":"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"}

package/dist/upload/run-upload.d.ts

@@ -0,0 +1,3 @@
+import type { StaticAssetUploadOptions, StaticAssetsConfig, UploadResult } from '../config/types.js';
+export declare function runStaticAssetUpload(config: StaticAssetsConfig, options?: StaticAssetUploadOptions): Promise<UploadResult>;
+//# sourceMappingURL=run-upload.d.ts.map

package/dist/upload/run-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-upload.d.ts","sourceRoot":"","sources":["../../src/upload/run-upload.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAER,wBAAwB,EACxB,kBAAkB,EAElB,YAAY,EACf,MAAM,oBAAoB,CAAC;AA2B5B,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,YAAY,CAAC,CAsBvB"}

package/dist/upload/run-upload.js

@@ -0,0 +1,44 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { cliLogger } from '@kristijorgji/cli-kit';
+import { resolveStaticAssetsConfig } from '../config/load-config.js';
+import { assertRequiredTargets, resolveUploadPlan } from '../plan/resolve-plan.js';
+import { S3UploadProvider } from './s3-provider.js';
+function createS3Client(config) {
+    return new S3Client({
+        region: config.region,
+        ...(config.endpoint ? { endpoint: config.endpoint } : {}),
+        ...(config.forcePathStyle ? { forcePathStyle: true } : {}),
+    });
+}
+function logDryRunPlan(plan) {
+    cliLogger.info(`Dry run — ${plan.entries.length} files would upload to s3://${plan.bucket}/`);
+    for (const entry of plan.entries) {
+        cliLogger.info(`  [${entry.targetId}] ${entry.remoteKey} (${entry.contentType}, ${entry.cacheControl})`);
+    }
+}
+function logUploadSummary(result) {
+    for (const [targetId, count] of Object.entries(result.uploadedByTarget)) {
+        cliLogger.info(`Uploaded ${count} files for target "${targetId}"`);
+    }
+    cliLogger.info(`Uploaded ${result.totalUploaded} files total`);
+}
+export async function runStaticAssetUpload(config, options = {}) {
+    const baseDir = options.baseDir ?? process.cwd();
+    const resolved = resolveStaticAssetsConfig(config, baseDir);
+    const plan = resolveUploadPlan(resolved, baseDir);
+    assertRequiredTargets(plan, resolved);
+    if (plan.entries.length === 0) {
+        cliLogger.warn('Upload plan is empty — no files matched manifest targets');
+    }
+    const dryRun = Boolean(options.dryRun);
+    if (dryRun) {
+        logDryRunPlan(plan);
+        return { uploadedByTarget: {}, totalUploaded: 0 };
+    }
+    cliLogger.info(`Uploading static assets to s3://${plan.bucket}/ (commit ${plan.commit})`);
+    const client = options.client ?? createS3Client(resolved);
+    const result = await new S3UploadProvider(client).upload(plan, { dryRun: false });
+    logUploadSummary(result);
+    return result;
+}
+//# sourceMappingURL=run-upload.js.map

package/dist/upload/run-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-upload.js","sourceRoot":"","sources":["../../src/upload/run-upload.ts"],"names":[],"mappings":"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"}

package/dist/upload/s3-provider.d.ts

@@ -0,0 +1,9 @@
+import type { StaticAssetStoreClient, UploadPlan, UploadResult } from '../config/types.js';
+export declare class S3UploadProvider {
+    private readonly client;
+    constructor(client: StaticAssetStoreClient);
+    upload(plan: UploadPlan, options: {
+        dryRun: boolean;
+    }): Promise<UploadResult>;
+}
+//# sourceMappingURL=s3-provider.d.ts.map

package/dist/upload/s3-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-provider.d.ts","sourceRoot":"","sources":["../../src/upload/s3-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3F,qBAAa,gBAAgB;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,sBAAsB;IAErD,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAuBtF"}

package/dist/upload/s3-provider.js

@@ -0,0 +1,26 @@
+import { readFileSync } from 'node:fs';
+import { PutObjectCommand } from '@aws-sdk/client-s3';
+export class S3UploadProvider {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async upload(plan, options) {
+        const uploadedByTarget = {};
+        for (const entry of plan.entries) {
+            uploadedByTarget[entry.targetId] = (uploadedByTarget[entry.targetId] ?? 0) + 1;
+            if (options.dryRun) {
+                continue;
+            }
+            await this.client.send(new PutObjectCommand({
+                Bucket: plan.bucket,
+                Key: entry.remoteKey,
+                Body: readFileSync(entry.localPath),
+                ContentType: entry.contentType,
+                CacheControl: entry.cacheControl,
+            }));
+        }
+        return { uploadedByTarget, totalUploaded: plan.entries.length };
+    }
+}
+//# sourceMappingURL=s3-provider.js.map

package/dist/upload/s3-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-provider.js","sourceRoot":"","sources":["../../src/upload/s3-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,MAAM,OAAO,gBAAgB;IACI;IAA7B,YAA6B,MAA8B;QAA9B,WAAM,GAAN,MAAM,CAAwB;IAAG,CAAC;IAE/D,KAAK,CAAC,MAAM,CAAC,IAAgB,EAAE,OAA4B;QACvD,MAAM,gBAAgB,GAA2B,EAAE,CAAC;QAEpD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAE/E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,SAAS;YACb,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAClB,IAAI,gBAAgB,CAAC;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,KAAK,CAAC,SAAS;gBACpB,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC;gBACnC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;aACnC,CAAC,CACL,CAAC;QACN,CAAC;QAED,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IACpE,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@kristijorgji/static-asset-upload",
+  "version": "0.1.0",
+  "description": "Framework-agnostic manifest uploader for static assets to S3-compatible object storage",
+  "type": "module",
+  "license": "MIT",
+  "author": "kristijorgji",
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "bin": {
+    "kj-static-assets": "./dist/cli.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kristijorgji/js-devkit.git",
+    "directory": "packages/static-asset-upload"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3",
+    "@kristijorgji/cli-kit": "workspace:^",
+    "commander": "^15",
+    "jiti": "^2",
+    "mime-types": "^2"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^2",
+    "@types/node": "^26",
+    "typescript": "^5",
+    "vitest": "^5"
+  }
+}

package/skills/static-asset-upload/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: static-asset-upload
+description: >-
+    Use when uploading hashed or shared static files to S3-compatible storage
+    from a caller-supplied manifest, or wiring kj-static-assets into a new project.
+---
+
+# static-asset-upload
+
+CLI: `kj-static-assets` from `@kristijorgji/static-asset-upload`.
+
+## Commands
+
+| Command | Flags | When |
+| --- | --- | --- |
+| `upload` | `--dry-run` | Put planned objects, or print the plan |
+
+## Config
+
+`static-assets.config.ts` via `defineStaticAssetsConfig({ root, bucket, commit, commitPrefix, sharedPrefix, targets, ... })`.
+
+Keep app-specific CDN prefixes, env names, and cache lifetimes in the consumer config. Do not hardcode them in this package.
+
+Example prefixes: `commitPrefix: 'assets/{commit}'`, `sharedPrefix: 'assets/shared'`.
+
+Each target supplies `cacheControl` as a header string. There is no package-level 1y/3h enum.
+
+`runStaticAssetUpload` builds the S3 client from `region` / `endpoint` / `forcePathStyle`. Inject `{ client: { send } }` in tests. No live AWS.
+
+## Out of scope
+
+Prune, CloudFront invalidation, and extra storage backends. An S3-compatible `endpoint` is enough for R2 and MinIO.