@happy垂直/smrt-资产
提供人-不可知资产管理,包括版本、类型分类、元数据领域和通用/认证协会.
AssetAssociation 是将资产与任意
对象,当没有模型所有名词加入表格。 基地/领域
关系应使用专用连接,例如 content_assets, (中文(简体) ),
profile_assets, (中文(简体) ), event_assets, (中文(简体) ), place_assets,以及 product_assets。 。 。 .
特色食谱
assets.library 提供模型支持的文件和媒体库:资产,
文件夹、分类、状态和元数据定义.
assets.attachments 添加记录附件来源并需要库.
他们分享 文件和媒体 分类卡和目录 资产 导航
区域,并同时在生成的列表中嵌入了用户显示的帮助。 食谱
发布浏览器安全模拟固定导出 @happyvertical/smrt-assets/playground。 。 。 .
AssetManager 需要主机持续回调和 AttachmentPanel 需求
记录范围授权附件,因此两个附件都不宣布为独立附件
放置。 储存供应商仍然拥有应用程序,因此秘方宣布
无供养.
套接字游乐场是一个 Moock 预览. 其资产网格使用记忆道具 和数据 URI 缩略图,及其附件面板显示提供了本地 表格数据。 它从不执行真正的网络上传或创建公共 存储 URL.
安装
pnpm add @happyvertical/smrt-assets
使用量
import {
Asset, AssetCollection,
AssetType, AssetStatus, AssetMetafield,
AssetAssociation, AssetAssociationCollection,
Folder, FolderCollection,
AssetStore,
} from '@happyvertical/smrt-assets';
// Create lookup records
const imageType = new AssetType({ slug: 'image', name: 'Image' });
await imageType.save();
const published = new AssetStatus({ slug: 'published', name: 'Published' });
await published.save();
// Create an asset
const photo = new Asset({
name: 'Product Photo',
slug: 'product-photo-001',
sourceUri: 's3://bucket/products/photo-001.jpg',
mimeType: 'image/jpeg',
typeSlug: 'image',
statusSlug: 'published',
version: 1,
});
await photo.save();
// Versioning -- chain via primaryVersionId, increment version number
const v2 = new Asset({
...photo, slug: 'product-photo-002', version: 2, primaryVersionId: photo.id,
sourceUri: 's3://bucket/products/photo-002.jpg',
});
await v2.save();
// Derivatives via sourceAssetId (renamed from `parentId` in R3-D)
const thumb = new Asset({
name: 'Thumbnail', slug: 'product-photo-001-thumb', sourceAssetId: photo.id,
sourceUri: 's3://bucket/products/photo-001-thumb.jpg',
mimeType: 'image/jpeg', typeSlug: 'image', statusSlug: 'published',
});
await thumb.save();
// Generic/provenance association -- link asset to an arbitrary object
const assoc = new AssetAssociation({
assetId: photo.id,
metaType: 'Image',
metaId: 'derived-image-123',
role: 'derivation-source',
sortOrder: 0,
});
await assoc.save();
// Base/domain-owned asset relationships should use dedicated noun joins instead:
// content_assets, profile_assets, event_assets, place_assets, product_assets
// Folder organization (its own SmrtHierarchical model, `folders` table)
const folder = new Folder({ name: 'Product Images', slug: 'product-images' });
await folder.save();
// Move an asset into a folder
photo.folderId = folder.id;
await photo.save();
// AssetStore -- provider-agnostic file I/O + record creation
const store = await new AssetStore(assetRoot, collection).initialize();
await store.store('screenshot', buffer, { mimeType: 'image/png' });
便携式本地存储
对于新的桌面安装, 通过相同的便携式存储配置 用于处理其管理文件的资产运行时间、工人和服务:
const assets = await createAssetRuntime({
db,
storage: { type: 'local', basePath: assetRoot, locatorMode: 'relative' },
});
使用绝对的,应用的 assetRoot。该商店持续
asset-local:<key>,例如 asset-local:document/17f6.txt。 。 。 .
密钥是在所配置的根下一个原始的,被斜线分隔的路径
包含不跳出 URL。 使用 ASCII 字母、数字、下划线和
型号为"鼻涕"和"ID"的连字符. 商店拒绝转弯,绝对的钥匙,
Windows设备名称,根部或下方的链接,以及非正则文件. 保留
; 文件系统检查假设
不通过不信任的本地进程同时进行修改.
复制安装时, 复制数据库和资产目录
并设定 basePath
转到已复制的目录。 通过
运行时间。 存储解析器可以选择便携式写入的路径, 但是
以后读取和删除必须使用内建本地密钥
运行时间的文件系统 .
选项只更改新写 。 现有的本地选项和S3
定位器保留其格式. 本地商店可以读取便携
定位器是否选择写入它们 。 在便携式模式下,
现有 file:// 定位器仍然可以读取或删除
在配置的根内识别一个有效的密钥; 更改根
不移动此类记录。 从新的桌面数据或手柄开始
在移动安装前已有绝对定位器.
API 密码
模型( smrt 对象)
| 导出 | 说明 |
|---|---|
Asset | 具有版本的核心资产(primaryVersionId, (中文(简体) ), version),衍生链(sourceAssetId, (中文(简体) ), sourceUri, (中文(简体) ), mimeType, (中文(简体) ), typeSlug, (中文(简体) ), statusSlug, (中文(简体) ), ownerProfileId |
AssetAssociation | 通用/ 证明多态结合 : assetId + 键 metaType + 键 metaId + 键 role + 键 sortOrder; 不包括已经拥有名词表的基数/域名加盟 |
AssetType | 资产类型分类查询表 |
AssetStatus | 生命周期状态查询表 |
AssetMetafield | 自定义带有 JSON 验证规则的元数据字段定义 |
Folder | 资产分级容器;自有 folders 扩展的表格 SmrtHierarchical |
收藏( 收藏)
| 导出 | 说明 |
|---|---|
AssetCollection | 资产收缴 |
AssetAssociationCollection | 为资产协会募捐 |
AssetTypeCollection | 资产类型收藏 |
AssetStatusCollection | 资产状况收集 |
AssetMetafieldCollection | 资产Metafield的收藏 |
FolderCollection | 文件夹收藏 |
公用事业
| 导出 | 说明 |
|---|---|
AssetStore | 提供者不可知文件 I/O , 它会写入存储和创建资产记录的缓冲 |
类型
| 导出 | 说明 |
|---|---|
AssetOptions | 备选方案 Asset 构造器 |
AssetAssociationOptions | 备选方案 AssetAssociation 构造器 |
AssetTypeOptions | 备选方案 AssetType 构造器 |
AssetStatusOptions | 备选方案 AssetStatus 构造器 |
AssetMetafieldOptions | 备选方案 AssetMetafield 构造器 |
FolderOptions | 备选方案 Folder 构造器 |
StoreOptions | 备选方案 AssetStore.store() |
ProviderOptions | 提供者配置 AssetStore |
依赖关系
| 软件包 | 目的 |
|---|---|
@happyvertical/smrt-core | ORM 基础( Smrt Object, Smrt Collection) |
@happyvertical/smrt-tags | 标签集成( E)addTag编号 :removeTag (单位:千美元) |
@happyvertical/smrt-tenancy | 备选租户范围界定 |
@happyvertical/files | 资产仓库的提供者不可知文件系统 |
本地私人附属物
AttachmentPanel, (中文(简体) ), AttachmentList 财务报告和审定财务报表 AttachmentUpload 授权编制
私人链接,呼叫器提供版本历史,以及本地多段上传.
它们保留请求身份和失败操作元数据而不产生
公共存储 URL. 见 附加合同 页:1
公共类型、当地有效载荷、回收和服务器责任.
过 onremove(attachment) 和(或) removeAction (原始内容存档于2019-10-21) (中文(简体) )
添加已确认的每个附件删除按钮;见
合同中的"去除附件".
多态相交集类型
AssetAssociationCollection 扩展 SmrtJunctionBase共享 byRight, (中文(简体) ),
命令,定位,和登记警卫 与普通的交叉口。 内容
byLeft, (中文(简体) ), attach, (中文(简体) ), detach,以及 setLinks 两种方法都需要 metaType
财务报告和审定财务报表 metaId;它们不执行单所有者 SmrtJunction 合同.
使用 instanceof SmrtJunctionBase 认清任何一种交叉点时.
资产协会不再满足 instanceof SmrtJunction。 。 。 .
在建造工作空间后, node scripts/verify-packed-junction-types.mjs
使用
skipLibCheck: false,继承的结果类型,以及负所有者-参数测试.
完整的节点Next声明可移植性在#3524中单独跟踪.
消费者固定安装在临时目录中宣布的依赖性
没有祖先 node_modules;它从来不连接生产者的依赖性. 它保留
项目的公开登记路线,不复制证书。 设定
SMRT_PACKED_EVIDENCE_DIR 保留柏油球和消费锁文件。 对于一个
(c) 明确分开的上游验证, SMRT_PACKED_OVERRIDES 可能名称
a Pnpm 的 JSON 文件覆盖;这种证明不能证明正常
已公布的依赖性图表.