@ibgib/vcs-gib 0.0.30 → 0.0.32

package/src/engine/item/item-types.mts

@@ -1,137 +0,0 @@
-/**
- * @module item-types
- *
- * Baseline type definitions for B2tFS filesystem item IbGibs.
- */
-
-import { IbGibAddr, TransformResult } from '@ibgib/ts-gib/dist/types.mjs';
-import { IbGibData_V1, IbGibRel8ns_V1, IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
-import { CommentIbGib_V1 } from '@ibgib/core-gib/dist/common/comment/comment-types.mjs';
-
-import { SpaceQualifiedIbGibAddr } from '../index/index-types.mjs';
-import { LineDiffChunk } from '../diff/line-diff-helper.mjs';
-
-/**
- * Filesystem projection type: file or folder.
- */
-export type B2tFSType = 'file' | 'folder';
-
-export const B2tFSType = {
-    file: 'file' as 'file',
-    folder: 'folder' as 'folder',
-} satisfies { [key: string]: B2tFSType };
-
-export const B2TFS_TYPE_VALUES: B2tFSType[] = Object.values(B2tFSType);
-
-/**
- * Rel8n names used by B2tFS items.
- */
-export const B2TFS_CHILD_ITEM_REL8N_NAME = 'b2tfs_child';
-export const BINARY_REL8N_NAME = 'bin';
-
-/**
- * Intrinsic data payload for B2tFS item IbGibs.
- */
-export interface B2tFSItemData_V1 extends IbGibData_V1 {
-    /**
-     * Raw filesystem name of file or folder (e.g. 'index.mts')
-     */
-    name: string;
-    /**
-     * SHA-256 hash of raw name
-     */
-    nameHash: string;
-    /**
-     * Filesystem item type ('file' | 'folder')
-     */
-    fsType: B2tFSType;
-    /**
-     * Filter patterns for folders (e.g. from .ibgibignore)
-     */
-    filterPatterns?: string[];
-    /**
-     * File name sans extension
-     */
-    fileNameSansExt?: string;
-    /**
-     * File extension (e.g. 'mts')
-     */
-    fileExt?: string;
-    /**
-     * SHA-256 hash of file contents
-     */
-    fileHash?: string;
-    /**
-     * File encoding (defaults to 'utf8')
-     */
-    fileEncoding?: string;
-    /**
-     * Grouping UUID for atomic diff transactions
-     */
-    diffTransactionId: string;
-}
-
-/**
- * Extrinsic relationships (DAG links) for B2tFS item IbGibs.
- */
-export interface B2tFSItemRel8ns_V1 extends IbGibRel8ns_V1 {
-    /**
-     * Links to child B2tFS item addresses (for folders)
-     */
-    [B2TFS_CHILD_ITEM_REL8N_NAME]?: IbGibAddr[];
-    /**
-     * Links to binary content payload IbGibs (for files)
-     */
-    [BINARY_REL8N_NAME]?: IbGibAddr[];
-    /**
-     * Links to commit message comment IbGibs
-     */
-    comment?: IbGibAddr[];
-}
-
-/**
- * B2tFS Item IbGib object structure.
- */
-export interface B2tFSItemIbGib_V1 extends IbGib_V1<B2tFSItemData_V1, B2tFSItemRel8ns_V1> {
-    data: B2tFSItemData_V1;
-}
-
-/**
- * Diff information tree structure.
- */
-export interface B2tFSItemDiffInfo {
-    fsType?: B2tFSType;
-    fsName?: string;
-    timestampInTicks: string;
-    diffTransactionId: string;
-    existingItemSQAddr?: SpaceQualifiedIbGibAddr;
-    newItemSQAddr?: SpaceQualifiedIbGibAddr;
-    existingItem?: B2tFSItemIbGib_V1;
-    newItem?: B2tFSItemIbGib_V1;
-    transformResults?: TransformResult<IbGib_V1>[];
-    applyCommentText?: string;
-    applyCommentIbGib?: CommentIbGib_V1;
-    childDiffs?: B2tFSItemDiffInfo[];
-    errorMsg?: string;
-    ignored?: boolean;
-    inputPath?: string;
-}
-
-export interface B2tFSItemDiffInfo_Folder extends B2tFSItemDiffInfo {
-    fsType: 'folder';
-    childNamesAdded: string[];
-    childAddrsAdded: string[];
-    childNamesRemoved: string[];
-    childAddrsRemoved: string[];
-    childNamesModified: string[];
-    childAddrsModified: { [prevAddr: string]: string };
-    filterPatterns: string[];
-}
-
-export interface B2tFSItemDiffInfo_File extends B2tFSItemDiffInfo {
-    fsType: 'file';
-    fileEncoding?: string;
-    oldData?: Uint8Array;
-    newData: Uint8Array;
-    lineChunks?: LineDiffChunk[];
-}

package/src/engine/item/item.respec.mts

@@ -1,92 +0,0 @@
-/**
- * @module item.respec.node
- * 
- * Unit tests for createB2tFSItemIbGib and evolveB2tFSItemIbGib timeline transforms.
- */
-
-import {
-    respecfully, ifWe, iReckon
-} from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
-import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
-import { getGibInfo } from '@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs';
-
-import { createB2tFSItemIbGib, evolveB2tFSItemIbGib } from './item-helper.mjs';
-import { B2tFSItemIbGib_V1 } from './item-types.mjs';
-
-const lc = `[apps/vcs-gib/src/engine/item/item.respec.node.mts]`;
-
-await respecfully(lc, `B2tFS Item Timeline Transforms`, async () => {
-
-    await respecfully(lc, `createB2tFSItemIbGib`, async () => {
-        await ifWe(lc, `creates brand-new file item with TJP and DNA`, async () => {
-            const res = await createB2tFSItemIbGib({
-                fsType: 'file',
-                name: 'test.txt',
-                data: {
-                    fileHash: 'hash_abc_123',
-                },
-            });
-
-            const item = res.newIbGib as B2tFSItemIbGib_V1;
-            iReckon(lc, item).isGonnaBeTruthy();
-            iReckon(lc, item.data?.name).willEqual('test.txt');
-            iReckon(lc, item.data?.fileHash).willEqual('hash_abc_123');
-            iReckon(lc, item.rel8ns?.ancestor).isGonnaBeTruthy();
-            iReckon(lc, item.rel8ns?.tjp).isGonnaBeTruthy();
-
-            const gibInfo = getGibInfo({ gib: item.gib });
-            iReckon(lc, gibInfo.tjpGib).isGonnaBeTruthy();
-            iReckon(lc, gibInfo.punctiliarHash).isGonnaBeTruthy();
-        });
-
-        await ifWe(lc, `creates brand-new folder item`, async () => {
-            const res = await createB2tFSItemIbGib({
-                fsType: 'folder',
-                name: 'src',
-            });
-
-            const item = res.newIbGib as B2tFSItemIbGib_V1;
-            iReckon(lc, item).isGonnaBeTruthy();
-            iReckon(lc, item.data?.fsType).willEqual('folder');
-            iReckon(lc, item.data?.name).willEqual('src');
-        });
-    });
-
-    await respecfully(lc, `evolveB2tFSItemIbGib`, async () => {
-        await ifWe(lc, `evolves existing item via mut8/rel8, generating two-part timeline gib and rel8ns.past`, async () => {
-            const createRes = await createB2tFSItemIbGib({
-                fsType: 'file',
-                name: 'config.json',
-                data: {
-                    fileHash: 'hash_v1',
-                },
-            });
-
-            const initialItem = createRes.newIbGib as B2tFSItemIbGib_V1;
-            const initialAddr = getIbGibAddr({ ibGib: initialItem });
-            const initialGibInfo = getGibInfo({ gib: initialItem.gib });
-
-            // Evolve item with updated fileHash
-            const evolveRes = await evolveB2tFSItemIbGib({
-                existingItem: initialItem,
-                dataToUpdate: {
-                    fileHash: 'hash_v2',
-                },
-            });
-
-            const evolvedItem = evolveRes.newIbGib as B2tFSItemIbGib_V1;
-            const evolvedAddr = getIbGibAddr({ ibGib: evolvedItem });
-            const evolvedGibInfo = getGibInfo({ gib: evolvedItem.gib });
-
-            iReckon(lc, evolvedItem.data?.fileHash).willEqual('hash_v2');
-            iReckon(lc, evolvedItem.rel8ns?.past).includes(initialAddr);
-            iReckon(lc, evolvedItem.rel8ns?.ancestor).isGonnaBeTruthy();
-            iReckon(lc, evolvedItem.rel8ns?.tjp).willEqual(initialItem.rel8ns?.tjp);
-
-            // Verify two-part composite timeline gib address
-            iReckon(lc, evolvedGibInfo.tjpGib).willEqual(initialGibInfo.tjpGib);
-            iReckon(lc, evolvedGibInfo.punctiliarHash).isGonnaBeTruthy();
-            iReckon(lc, evolvedGibInfo.punctiliarHash !== initialGibInfo.punctiliarHash).isGonnaBeTrue();
-        });
-    });
-});