@junobuild/cli-tools 0.12.2 → 0.12.3

package/dist/types/commands/prune.d.ts

@@ -0,0 +1,17 @@
+import type { PruneFilesFn, PruneParams, PruneResult } from '../types/prune';
+/**
+ * Identifies and removes stale assets from a satellite's storage.
+ *
+ * @param {Object} options
+ * @param {PruneParams} options.params - Prune parameters including `dryRun` and `batchSize`.
+ * @param {PruneFilesFn} options.pruneFn - Function used to delete the resolved stale assets.
+ *
+ * @returns {Promise<PruneResult>}
+ *   - `{ result: 'skipped' }` when no stale assets are found.
+ *   - `{ result: 'simulated', files }` when `dryRun` is true; no files are deleted.
+ *   - `{ result: 'pruned', files }` when stale assets are successfully deleted.
+ */
+export declare const prune: ({ params: { dryRun, batchSize, ...rest }, pruneFn }: {
+    params: PruneParams;
+    pruneFn: PruneFilesFn;
+}) => Promise<PruneResult>;

package/dist/types/constants/deploy.constants.d.ts

@@ -5,5 +5,3 @@ export declare const DEPLOY_DEFAULT_ENCODING: never[];
 export declare const DEPLOY_DEFAULT_PRECOMPRESS: Required<Precompress>;
 export declare const IGNORE_OS_FILES: string[];
 export declare const UPLOAD_DEFAULT_BATCH_SIZE = 50;
-export declare const COLLECTION_DAPP = "#dapp";
-export declare const COLLECTION_CDN_RELEASES = "#_juno/releases";

package/dist/types/constants/prune.constants.d.ts

@@ -0,0 +1 @@
+export declare const PRUNE_DEFAULT_BATCH_SIZE = 100;

package/dist/types/constants/storage.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const COLLECTION_DAPP = "#dapp";
+export declare const COLLECTION_CDN_RELEASES = "#_juno/releases";

package/dist/types/index.d.ts

@@ -1,11 +1,15 @@
 export * from './commands/build';
 export * from './commands/deploy';
 export * from './commands/generate';
+export * from './commands/prune';
 export * from './commands/publish';
 export * from './constants/deploy.constants';
+export * from './constants/storage.constants';
+export { ListAssets } from './types/assets';
 export type * from './types/deploy';
 export type * from './types/pkg';
 export type * from './types/proposal';
+export type * from './types/prune';
 export type * from './types/publish';
 export * from './utils/args.utils';
 export * from './utils/cmd.utils';

package/dist/types/services/deploy.prepare.services.d.ts

@@ -1,5 +1,6 @@
 import type { CliConfig } from '@junobuild/config';
-import type { FileDetails, ListAssets, PrepareDeployOptions } from '../types/deploy';
+import type { ListAssets } from '../types/assets';
+import type { FileDetails, PrepareDeployOptions } from '../types/deploy';
 export declare const prepareDeploy: ({ config, listAssets, assertSourceDirExists, includeAllFiles }: {
     config: CliConfig;
     listAssets: ListAssets;

package/dist/types/services/prune.prepare.services.d.ts

@@ -0,0 +1,9 @@
+import type { CliConfig } from '@junobuild/config';
+import type { ListAssets } from '../types/assets';
+import type { PreparePruneOptions, PruneFileStorage } from '../types/prune';
+export declare const preparePrune: ({ config, listAssets, assertSourceDirExists }: {
+    config: CliConfig;
+    listAssets: ListAssets;
+} & PreparePruneOptions) => Promise<{
+    files: PruneFileStorage[];
+}>;

package/dist/types/services/prune.services.d.ts

@@ -0,0 +1,5 @@
+import type { PruneFilesFn, PruneFileStorage, PruneParams } from '../types/prune';
+export declare const prune: ({ files: groupFiles, pruneFn, batchSize }: {
+    files: PruneFileStorage[];
+    pruneFn: PruneFilesFn;
+} & Required<Pick<PruneParams, "batchSize">>) => Promise<void>;

package/dist/types/types/assets.d.ts

@@ -0,0 +1,12 @@
+import type { CliConfig } from '@junobuild/config';
+import type { Asset } from '@junobuild/storage';
+export interface PrepareAssetsOptions {
+    assertSourceDirExists?: (source: string) => void;
+}
+export type ListAssets = ({ startAfter }: {
+    startAfter?: string;
+}) => Promise<Asset[]>;
+export interface AssetsParams {
+    config: CliConfig;
+    listAssets: ListAssets;
+}

package/dist/types/types/deploy.d.ts

@@ -1,5 +1,6 @@
-import type { CliConfig, EncodingType } from '@junobuild/config';
-import type { Asset, OnUploadProgress } from '@junobuild/storage';
+import type { EncodingType } from '@junobuild/config';
+import type { OnUploadProgress } from '@junobuild/storage';
+import type { AssetsParams, PrepareAssetsOptions } from './assets';
 export type MimeType = string;
 export type FileExtension = string;
 export interface FileDetails {
@@ -15,9 +16,6 @@ export interface FileAndPaths {
     file: FileDetails;
     paths: FilePaths;
 }
-export type ListAssets = ({ startAfter }: {
-    startAfter?: string;
-}) => Promise<Asset[]>;
 export interface UploadFileStorage {
     filename: string;
     data: Blob;
@@ -58,13 +56,10 @@ export type DeployResultWithProposal = {
     files: Pick<FileDetails, 'file'>[];
     proposalId: bigint;
 };
-export interface PrepareDeployOptions {
-    assertSourceDirExists?: (source: string) => void;
+export interface PrepareDeployOptions extends PrepareAssetsOptions {
     includeAllFiles?: boolean;
 }
-export type DeployParams = PrepareDeployOptions & {
-    config: CliConfig;
-    listAssets: ListAssets;
+export type DeployParams = PrepareDeployOptions & AssetsParams & {
     assertMemory: () => Promise<void>;
     uploadBatchSize?: number;
 };

package/dist/types/types/prune.d.ts

@@ -0,0 +1,18 @@
+import type { AssetsParams, PrepareAssetsOptions } from './assets';
+export type PreparePruneOptions = PrepareAssetsOptions;
+export type PruneParams = PrepareAssetsOptions & AssetsParams & {
+    dryRun?: boolean;
+    batchSize?: number;
+};
+export interface PruneFileStorage {
+    fullPath: string;
+}
+export type PruneFilesFn = (params: {
+    files: PruneFileStorage[];
+}) => Promise<void>;
+export type PruneResult = {
+    result: 'pruned' | 'simulated';
+    files: PruneFileStorage[];
+} | {
+    result: 'skipped';
+};

package/dist/types/types/upload.d.ts

@@ -1,5 +1,5 @@
 import type { OnUploadProgress } from '@junobuild/storage';
-import type { COLLECTION_CDN_RELEASES, COLLECTION_DAPP } from '../constants/deploy.constants';
+import type { COLLECTION_CDN_RELEASES, COLLECTION_DAPP } from '../constants/storage.constants';
 import type { FileAndPaths } from './deploy';
 export interface UploadFilesParams {
     files: FileAndPaths[];

package/dist/types/utils/assets.utils.d.ts

@@ -0,0 +1,4 @@
+export declare const fullPath: ({ file, sourceAbsolutePath }: {
+    file: string;
+    sourceAbsolutePath: string;
+}) => string;

package/dist/types/utils/deploy.utils.d.ts

@@ -1,8 +1,4 @@
 import type { SatelliteConfig } from '@junobuild/config';
-export declare const fullPath: ({ file, sourceAbsolutePath }: {
-    file: string;
-    sourceAbsolutePath: string;
-}) => string;
-export declare const listSourceFiles: ({ sourceAbsolutePath, ignore }: {
+export declare const listSourceFilesForDeploy: ({ sourceAbsolutePath, ignore }: {
     sourceAbsolutePath: string;
 } & Required<Pick<SatelliteConfig, "ignore">>) => string[];

package/dist/types/utils/prune.utils.d.ts

@@ -0,0 +1,8 @@
+import type { SatelliteConfig } from '@junobuild/config';
+/**
+ * Scans the local source directory and returns a Set of fullPaths that are present.
+ * Throws if the directory cannot be read.
+ */
+export declare const listSourceFilesForPrune: ({ sourceAbsolutePath, ignore }: {
+    sourceAbsolutePath: string;
+} & Required<Pick<SatelliteConfig, "ignore">>) => Set<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junobuild/cli-tools",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "description": "A collection of tools for Juno CLIs and Plugins.",
   "author": "David Dal Busco (https://daviddalbusco.com)",
   "license": "MIT",
@@ -55,10 +55,10 @@
     "ora": "^9"
   },
   "dependencies": {
-    "file-type": "^21.1.1",
-    "listr2": "^9.0.5",
+    "file-type": "^21.3.2",
+    "listr2": "^10.2.1",
     "mime-types": "^3.0.2",
-    "minimatch": "^10.1.2"
+    "minimatch": "^10.2.4"
   },
   "devDependencies": {
     "@types/mime-types": "^3.0.1",