@happyvertical/smrt-assets 0.30.0

package/dist/asset-types.d.ts

@@ -0,0 +1,28 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { AssetType } from './asset-type';
+export declare class AssetTypeCollection extends SmrtCollection<AssetType> {
+    static readonly _itemClass: typeof AssetType;
+    /**
+     * Get or create an asset type by slug
+     *
+     * @param slug - The asset type slug
+     * @param name - The display name (defaults to slug)
+     * @param description - Optional description
+     * @returns The existing or newly created AssetType
+     */
+    getOrCreate(slug: string, name?: string, description?: string): Promise<AssetType>;
+    /**
+     * Initialize common asset types
+     *
+     * Creates standard asset types if they don't exist:
+     * - image
+     * - video
+     * - document
+     * - audio
+     *
+     * Note: `folder` was removed in R3-D. Folders are no longer an asset
+     * subtype — they live on their own `folders` table. See `folder.ts`.
+     */
+    initializeCommonTypes(): Promise<void>;
+}
+//# sourceMappingURL=asset-types.d.ts.map

package/dist/asset-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-types.d.ts","sourceRoot":"","sources":["../src/asset-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,mBAAa;IAEvC;;;;;;;OAOG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC;IAarB;;;;;;;;;;;OAWG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB7C"}

package/dist/asset.d.ts

@@ -0,0 +1,158 @@
+import { SmrtObject } from '@happyvertical/smrt-core';
+import { Tag } from '@happyvertical/smrt-tags';
+import { AssetAssociation } from './asset-association';
+import { AssetStatus } from './asset-status';
+import { AssetType } from './asset-type';
+import { AssetOptions } from './types';
+export interface AssetExternalReference {
+    provider: string;
+    assetId?: string | null;
+    externalId?: string | null;
+    sourceRef?: Record<string, unknown> | null;
+    status?: string | null;
+    metadata?: Record<string, unknown> | null;
+    syncedAt?: string | null;
+    [key: string]: unknown;
+}
+export declare class Asset extends SmrtObject {
+    tenantId: string | null;
+    name: string;
+    sourceUri: string;
+    mimeType: string;
+    description: string;
+    metadata: string;
+    version: number;
+    primaryVersionId: string | null;
+    typeSlug: string;
+    statusSlug: string;
+    ownerProfileId: string | null;
+    /**
+     * FK to the source Asset this one was derived from (e.g. thumbnail
+     * derived from an original image, transcoded video, AI variation).
+     *
+     * Renamed from `parentId` in R3-D to make the derivation semantics
+     * explicit and free `parentId` to mean exactly structural hierarchy
+     * (SmrtHierarchical) across the framework. The column on the assets
+     * table is `source_asset_id`.
+     */
+    sourceAssetId: string | null;
+    folderId: string | null;
+    sourceType: string;
+    externalId: string;
+    externalRefs: string;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: AssetOptions);
+    getMetadata(): Record<string, unknown>;
+    setMetadata(metadata: Record<string, unknown>): void;
+    mergeMetadata(metadata: Record<string, unknown>): void;
+    getExternalRefs(): Record<string, AssetExternalReference>;
+    getExternalRef(provider: string): AssetExternalReference | null;
+    setExternalRef(provider: string, reference: Omit<AssetExternalReference, 'provider'> & {
+        provider?: string;
+    }): void;
+    /**
+     * Get all tags for this asset from @happyvertical/smrt-tags
+     *
+     * @returns Array of Tag instances from @happyvertical/smrt-tags package
+     */
+    getTags(): Promise<Tag[]>;
+    /**
+     * Check if this asset has a specific tag
+     *
+     * @param tagSlug - The slug of the tag to check
+     * @returns True if the asset has this tag
+     */
+    hasTag(tagSlug: string): Promise<boolean>;
+    /**
+     * Resolve the AssetCollection lazily. Going through `ObjectRegistry`
+     * mirrors the pattern used by `SmrtHierarchical._hierarchyCollection`
+     * so source/derivative lookups inherit tenant scoping and ORM
+     * hydration without hard-coding an import of `./assets` (which would
+     * create a module-import cycle).
+     *
+     * The return type is `SmrtCollection<Asset>` (the framework base, type-
+     * only import from core) rather than the concrete `AssetCollection` —
+     * importing the concrete class is what would create the cycle, but the
+     * base-class shape gives callers full `.get()` / `.list()` type
+     * safety here.
+     *
+     * R5-canon: hardcode the base Asset's qualified key so a different
+     * package also registering a class called `Asset` can't be picked
+     * by `findClass`'s multi-strategy fallback. Crucially we DON'T
+     * resolve via `this.constructor._smrtQualifiedName` — for an STI
+     * subclass like `Image`, that would yield the Image collection
+     * (which auto-filters `_meta_type = '...:Image'` on `get`/`list`),
+     * and `getSource()` / `getDerivatives()` would miss cross-type
+     * derivation links (Image derived from a plain Asset, etc.).
+     * `sourceAssetId` is a base-table derivation link, so it always
+     * resolves through the base Asset collection.
+     */
+    private _assetCollection;
+    /**
+     * Get the source asset this one was derived from, if any.
+     *
+     * Renamed from `getParent` in R3-D. The relationship is "I was produced
+     * from that asset" (e.g. a thumbnail's source is its original image),
+     * not a structural-hierarchy parent.
+     *
+     * Goes through the AssetCollection so tenant interceptors and ORM
+     * hydration apply — important because a tenant-scoped consumer with
+     * cross-tenant derivative chains would otherwise return assets from
+     * tenants the caller cannot see, and a raw `db.get` returns
+     * snake_case rows that leave camelCase props (e.g. `sourceUri`) at
+     * their constructor defaults.
+     *
+     * @returns Source Asset instance, or null if this asset has no source
+     */
+    getSource(): Promise<Asset | null>;
+    /**
+     * Get all assets derived from this one (e.g. thumbnails, variants,
+     * transcodes, AI edits).
+     *
+     * Renamed from `getChildren` in R3-D to match the derivation
+     * semantics. Goes through the AssetCollection so tenant interceptors
+     * and ORM hydration apply (see `getSource` for why this matters —
+     * the pre-R3-D `getChildren` used raw `db.list`, which both bypassed
+     * tenant scoping and dropped camelCase property hydration; that
+     * latent breakage is fixed here).
+     *
+     * @returns Array of derivative Asset instances
+     */
+    getDerivatives(): Promise<Asset[]>;
+    /**
+     * Get the type of this asset
+     *
+     * @returns AssetType instance or null
+     */
+    getType(): Promise<AssetType | null>;
+    /**
+     * Get the status of this asset
+     *
+     * @returns AssetStatus instance or null
+     */
+    getStatus(): Promise<AssetStatus | null>;
+    /**
+     * Get all associations for this asset
+     *
+     * @returns Array of AssetAssociation instances
+     */
+    getAssociations(): Promise<AssetAssociation[]>;
+    /**
+     * Associate this asset with a target object
+     *
+     * @param metaType - Target class name or qualified name (e.g., 'Article' or '@pkg:Article')
+     * @param metaId - Target object ID
+     * @param role - Association role (default: 'default')
+     * @returns The created AssetAssociation
+     */
+    associateWith(metaType: string, metaId: string, role?: string): Promise<AssetAssociation>;
+    /**
+     * Get asset by slug
+     *
+     * @param slug - The slug to search for
+     * @returns Asset instance or null
+     */
+    static getBySlug(_slug: string): Promise<Asset | null>;
+}
+//# sourceMappingURL=asset.d.ts.map

package/dist/asset.d.ts.map

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

package/dist/assets.d.ts

@@ -0,0 +1,125 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Asset } from './asset';
+export declare class AssetCollection extends SmrtCollection<Asset> {
+    static readonly _itemClass: typeof Asset;
+    /**
+     * Find all assets belonging to a specific tenant
+     *
+     * @param tenantId - The tenant ID to filter by
+     * @returns Array of assets belonging to this tenant
+     */
+    findByTenant(tenantId: string): Promise<Asset[]>;
+    /**
+     * Find all global assets (assets without a tenant)
+     *
+     * @returns Array of global assets
+     */
+    findGlobal(): Promise<Asset[]>;
+    /**
+     * Find assets belonging to a tenant plus all global assets
+     *
+     * @param tenantId - The tenant ID to include
+     * @returns Array of tenant-specific and global assets
+     */
+    findWithGlobals(tenantId: string): Promise<Asset[]>;
+    /**
+     * Add a tag to an asset (uses @smrt/tags)
+     *
+     * @param assetId - The asset ID to tag
+     * @param tagSlug - The tag slug from @smrt/tags
+     */
+    addTag(assetId: string, tagSlug: string): Promise<void>;
+    /**
+     * Remove a tag from an asset
+     *
+     * @param assetId - The asset ID
+     * @param tagSlug - The tag slug to remove
+     */
+    removeTag(assetId: string, tagSlug: string): Promise<void>;
+    /**
+     * Get all assets with a specific tag
+     *
+     * @param tagSlug - The tag slug to filter by
+     * @returns Array of assets with this tag
+     */
+    getByTag(tagSlug: string): Promise<Asset[]>;
+    /**
+     * Get assets by type
+     *
+     * @param typeSlug - The asset type slug (e.g., 'image', 'video')
+     * @returns Array of assets matching the type
+     */
+    getByType(typeSlug: string): Promise<Asset[]>;
+    /**
+     * Get assets by status
+     *
+     * @param statusSlug - The asset status slug (e.g., 'published', 'draft')
+     * @returns Array of assets matching the status
+     */
+    getByStatus(statusSlug: string): Promise<Asset[]>;
+    /**
+     * Get assets by owner
+     *
+     * @param ownerProfileId - The profile ID of the owner
+     * @returns Array of assets owned by this profile
+     */
+    getByOwner(ownerProfileId: string): Promise<Asset[]>;
+    /**
+     * Create a new version of an existing asset
+     *
+     * @param primaryVersionId - The primary version ID (first version's ID)
+     * @param newSourceUri - The new source URI for this version
+     * @param updates - Optional additional updates
+     * @returns The newly created asset version
+     */
+    createNewVersion(primaryVersionId: string, newSourceUri: string, updates?: Partial<Asset>): Promise<Asset>;
+    /**
+     * Get the latest version of an asset
+     *
+     * @param primaryVersionId - The primary version ID
+     * @returns The latest version or null
+     */
+    getLatestVersion(primaryVersionId: string): Promise<Asset | null>;
+    /**
+     * List all versions of an asset
+     *
+     * @param primaryVersionId - The primary version ID
+     * @returns Array of all asset versions, ordered by version number
+     */
+    listVersions(primaryVersionId: string): Promise<Asset[]>;
+    /**
+     * Get derivative assets of a source asset.
+     *
+     * Renamed from `getChildren(parentId)` in R3-D to match the rename of
+     * the underlying column (`parent_id` → `source_asset_id`) and method
+     * (`Asset.getChildren` → `Asset.getDerivatives`).
+     *
+     * @param sourceAssetId - The source asset ID
+     * @returns Array of derivative assets
+     */
+    getDerivatives(sourceAssetId: string): Promise<Asset[]>;
+    /**
+     * Get assets by MIME type pattern
+     *
+     * @param mimePattern - MIME type pattern (e.g., 'image/*', 'video/mp4')
+     * @returns Array of matching assets
+     */
+    getByMimeType(mimePattern: string): Promise<Asset[]>;
+    /**
+     * Rollback to a previous version by creating a new version with the target's content.
+     * Does NOT delete intermediate versions (safe rollback).
+     *
+     * @param primaryVersionId - The primary version ID of the version chain
+     * @param targetVersion - The version number to rollback to
+     * @returns The newly created asset version with content copied from target
+     */
+    rollbackToVersion(primaryVersionId: string, targetVersion: number): Promise<Asset>;
+    /**
+     * Get assets in a specific folder
+     *
+     * @param folderId - The folder ID to list contents for
+     * @returns Array of assets in this folder
+     */
+    getByFolder(folderId: string): Promise<Asset[]>;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,eAAgB,SAAQ,cAAc,CAAC,KAAK,CAAC;IACxD,MAAM,CAAC,QAAQ,CAAC,UAAU,eAAS;IAMnC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAItD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOzD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAgBjD;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAInD;;;;;OAKG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIvD;;;;;OAKG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI1D;;;;;;;OAOG;IACG,gBAAgB,CACpB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,OAAO,CAAC,KAAK,CAAM,GAC3B,OAAO,CAAC,KAAK,CAAC;IAkDjB;;;;;OAKG;IACG,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IASvE;;;;;OAKG;IACG,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAsB9D;;;;;;;;;OASG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI7D;;;;;OAKG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAS1D;;;;;;;OAOG;IACG,iBAAiB,CACrB,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,CAAC;IAgBjB;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAGtD"}

package/dist/folder.d.ts

@@ -0,0 +1,16 @@
+import { SmrtHierarchical } from '@happyvertical/smrt-core';
+import { FolderOptions } from './types';
+export declare class Folder extends SmrtHierarchical {
+    tenantId: string | null;
+    name: string;
+    description: string;
+    ownerProfileId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FolderOptions);
+    /**
+     * Look up a folder by slug.
+     */
+    static getBySlug(_slug: string): Promise<Folder | null>;
+}
+//# sourceMappingURL=folder.d.ts.map

package/dist/folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../src/folder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAEL,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qBAMa,MAAO,SAAQ,gBAAgB;IAI1C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,IAAI,SAAM;IAEV,WAAW,SAAM;IAEjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGrC,SAAS,OAAc;IACvB,SAAS,OAAc;gBAEX,OAAO,GAAE,aAAkB;IAkBvC;;OAEG;WACU,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAI9D"}

package/dist/folders.d.ts

@@ -0,0 +1,45 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { Asset } from './asset';
+import { AssetCollection } from './assets';
+import { Folder } from './folder';
+export declare class FolderCollection extends SmrtCollection<Folder> {
+    static readonly _itemClass: typeof Folder;
+    /**
+     * Get the folder tree starting from an optional root.
+     *
+     * When `rootId` is omitted, returns top-level folders (those with no
+     * parent). When `rootId` is provided, returns all descendants of that
+     * folder via the inherited SmrtHierarchical BFS traversal — same
+     * cycle-safe, one-query-per-depth behaviour as Place/Event.
+     *
+     * @param rootId - Optional root folder ID; if omitted, returns top-level folders
+     * @returns Array of folders (flat list; use parentId to reconstruct tree)
+     */
+    getTree(rootId?: string): Promise<Folder[]>;
+    /**
+     * Get the path from root to a given folder (ancestors + self).
+     *
+     * @param folderId - The folder ID to get the path for
+     * @returns Array of folders from root to the given folder (inclusive)
+     */
+    getPath(folderId: string): Promise<Folder[]>;
+    /**
+     * Get all assets that are direct children of a folder.
+     *
+     * Folder membership is recorded on `Asset.folderId`, not on the folder
+     * itself, so this is delegated to the asset collection.
+     *
+     * @param folderId - The folder ID
+     * @param assetCollection - An AssetCollection instance for querying
+     * @returns Array of assets in this folder
+     */
+    getContents(folderId: string, assetCollection: AssetCollection): Promise<Asset[]>;
+    /**
+     * Move an asset into a folder (or out, by passing `null`).
+     *
+     * @param asset - The asset to move
+     * @param folderId - The target folder ID (or null to move to root)
+     */
+    moveAsset(asset: Asset, folderId: string | null): Promise<void>;
+}
+//# sourceMappingURL=folders.d.ts.map

package/dist/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../src/folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC1D,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAU;IAEpC;;;;;;;;;;OAUG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsCjD;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOlD;;;;;;;;;OASG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IAMnB;;;;;OAKG;IACG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAItE"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { Asset } from './asset';
+export { AssetAssociation } from './asset-association';
+export { AssetAssociationCollection } from './asset-associations';
+export { type AssetCapabilityName, type AssetCapabilityProvider, type AssetCapabilityRuntime, AssetCapabilitySkippedError, type AssetCapabilitySource, AssetCapabilityUnavailableError, type AssetEnsureVariantInput, type AssetExternalSourceRef, type AssetExternalSyncInput, type AssetExternalSyncResult, type AssetNearbySearchInput, type AssetProcessInput, type AssetProcessResult, type AssetSearchItem, type AssetSearchResult, type AssetVariantFit, type AssetVariantRequest, type AssetVariantResult, type AssetWorkflowInput, type AssetWorkflowInputSelection, type AssetWorkflowResult, } from './asset-capabilities';
+export { ASSET_EXTRACTION_STATUS, ASSET_METADATA_KEYS, ASSET_ROLES, type AssetExtractionStatus, type AssetMetadataKey, type AssetRole, } from './asset-conventions';
+export { AssetMetafield } from './asset-metafield';
+export { AssetMetafieldCollection } from './asset-metafields';
+export { AssetRuntime, type AssetRuntimeDb, type AssetRuntimeLike, type AssetRuntimeOptions, createAssetRuntime, type LinkDerivationOptions, type StoreDerivedAssetOptions, } from './asset-runtime';
+export { AssetServeError, type ResolvedAssetBytes, resolveAssetForServing, type ServeAssetOptions, serveAsset, } from './asset-serving';
+export { AssetStatus } from './asset-status';
+export { AssetStatusCollection } from './asset-statuses';
+export { type AssetStorageOperation, type AssetStorageResolution, type AssetStorageResolveRequest, type AssetStorageResolver, AssetStore, type AssetStoreOptions, type ProviderOptions, type StoreOptions, } from './asset-store';
+export { AssetType } from './asset-type';
+export { AssetTypeCollection } from './asset-types';
+export { AssetCollection } from './assets';
+export { Folder } from './folder';
+export { FolderCollection } from './folders';
+export { type MediaBundleFileDescriptor, type MediaBundleGpsTrackPoint, type MediaBundleInspection, type MediaBundleInspectionLike, type MediaBundleNormalizedMetadata, type MediaBundleSupportFileInspection, type MediaSupportFileVisibility, type PersistMediaBundleAssetInput, type PersistMediaBundleAssociationInput, type PersistMediaBundleInspectionOptions, type PersistMediaBundleInspectionResult, type PersistMediaBundleMetadataArtifactInput, persistMediaBundleInspection, type SmrtMediaBundlePersistenceAdapter, } from './media-bundle-persistence';
+export { type AssetOwnerCollection, type AssetOwnerRecord, addOwnedAssetFromCollection, assertValidOwnedAssetRelationship, assertValidOwnedAssetSortOrder, getOwnedAssetsFromCollection, OWNED_ASSET_RELATIONSHIP_PATTERN, removeOwnedAssetFromCollection, resolveOwnedAssetsById, } from './owned-asset-helpers';
+export type { AssetAssociationOptions, AssetMetafieldOptions, AssetOptions, AssetStatusOptions, AssetTypeOptions, FolderOptions, } from './types';
+//# 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":"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"}