@1sat/types 0.0.39 → 0.0.41

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2GH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACpB,4BAAe,CAAA;IACf,4BAAe,CAAA;AAChB,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IACjC,oDAA0B,CAAA;IAC1B,kDAAwB,CAAA;IACxB,gDAAsB,CAAA;IACtB,2CAAiB,CAAA;AAClB,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACzB,6BAAW,CAAA;IACX,mCAAiB,CAAA;AAClB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAiID,qEAAqE;AACrE,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACvB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;AAClB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAkTD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2GH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACpB,4BAAe,CAAA;IACf,4BAAe,CAAA;AAChB,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IACjC,oDAA0B,CAAA;IAC1B,kDAAwB,CAAA;IACxB,gDAAsB,CAAA;IACtB,2CAAiB,CAAA;AAClB,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACzB,6BAAW,CAAA;IACX,mCAAiB,CAAA;AAClB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAiID,qEAAqE;AACrE,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACvB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;AAClB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAkTD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA"}

package/dist/intentLabel.test.js

@@ -1,16 +1,59 @@
 import { describe, expect, test } from 'bun:test';
-import { P1SAT_INTENTS, P1SAT_INTENT_LABEL_PREFIX, P1SAT_LABEL, buildIntentLabel, hasP1SatDispatchLabel, parseIntentLabel, } from './constants';
-describe('intent labels', () => {
-    test('build / parse round-trip', () => {
-        const label = buildIntentLabel(P1SAT_INTENTS.OPNS_REGISTER);
-        expect(label).toBe(`${P1SAT_INTENT_LABEL_PREFIX}opns.register`);
-        expect(parseIntentLabel([label, 'other'])).toBe('opns.register');
+import { P1SAT_LABEL, buildActionDispatchLabel, buildExternalInputLabel, buildInputAssetLabel, ensureSchemeActionLabel, hasAssetDispatchLabel, hasSchemeDispatchLabel, parseInputAssetLabels, parseOneInputLabel, } from './constants.js';
+describe('scheme dispatch labels', () => {
+    test('buildActionDispatchLabel', () => {
+        expect(buildActionDispatchLabel('1sat')).toBe('p 1sat action');
+        expect(buildActionDispatchLabel('opns')).toBe('p opns action');
+        expect(P1SAT_LABEL).toBe('p 1sat action');
     });
-    test('hasP1SatDispatchLabel accepts intent or bare action', () => {
-        expect(hasP1SatDispatchLabel([P1SAT_LABEL])).toBe(true);
-        expect(hasP1SatDispatchLabel([buildIntentLabel('opns.register')])).toBe(true);
-        expect(hasP1SatDispatchLabel(['p 1sat input opns x'])).toBe(false);
-        expect(hasP1SatDispatchLabel(undefined)).toBe(false);
+    test('hasSchemeDispatchLabel / hasAssetDispatchLabel', () => {
+        expect(hasSchemeDispatchLabel([P1SAT_LABEL], '1sat')).toBe(true);
+        expect(hasSchemeDispatchLabel(['p opns input id abc'], 'opns')).toBe(true);
+        expect(hasSchemeDispatchLabel(['p opns input id abc'], '1sat')).toBe(false);
+        expect(hasAssetDispatchLabel(['p bsv21 action'])).toBe(true);
+        expect(hasAssetDispatchLabel(['p 1sat'])).toBe(false);
+        expect(hasAssetDispatchLabel(undefined)).toBe(false);
+    });
+    test('ensureSchemeActionLabel', () => {
+        expect(ensureSchemeActionLabel(undefined, '1sat')).toEqual([P1SAT_LABEL]);
+        expect(ensureSchemeActionLabel(['other'], 'opns')).toEqual([
+            'other',
+            'p opns action',
+        ]);
+        expect(ensureSchemeActionLabel([P1SAT_LABEL], '1sat')).toEqual([
+            P1SAT_LABEL,
+        ]);
+    });
+});
+describe('input labels', () => {
+    test('held: p <scheme> input id <key>', () => {
+        const label = buildInputAssetLabel('1sat', 'id1');
+        expect(label).toBe('p 1sat input id id1');
+        expect(parseInputAssetLabels([label])).toEqual([
+            { scheme: '1sat', basket: '1sat', id: 'id1' },
+        ]);
+    });
+    test('opns / bsv21', () => {
+        expect(buildInputAssetLabel('opns', 'abc')).toBe('p opns input id abc');
+        expect(buildInputAssetLabel('bsv21', 'tok')).toBe('p bsv21 input id tok');
+        expect(parseInputAssetLabels(['p opns input id abc'])).toEqual([
+            { scheme: 'opns', basket: 'opns', id: 'abc' },
+        ]);
+    });
+    test('rejects legacy basket-middle and bare-key forms', () => {
+        expect(parseOneInputLabel('p 1sat input opns oldid')).toBeUndefined();
+        expect(parseOneInputLabel('p 1sat input barekey')).toBeUndefined();
+        expect(parseInputAssetLabels(['p 1sat input opns oldid'])).toEqual([]);
+    });
+    test('external: p <scheme> input <outpoint>', () => {
+        const op = `${'aa'.repeat(32)}.0`;
+        const label = buildExternalInputLabel('1sat', op);
+        expect(label).toBe(`p 1sat input ${op}`);
+        expect(parseOneInputLabel(label)).toEqual({
+            kind: 'outpoint',
+            scheme: '1sat',
+            outpoint: op,
+        });
     });
 });
 //# sourceMappingURL=intentLabel.test.js.map

package/dist/intentLabel.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"intentLabel.test.js","sourceRoot":"","sources":["../src/intentLabel.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EACN,aAAa,EACb,yBAAyB,EACzB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GAChB,MAAM,aAAa,CAAA;AAEpB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;QAC3D,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,yBAAyB,eAAe,CAAC,CAAA;QAC/D,MAAM,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,qBAAqB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,MAAM,CAAC,qBAAqB,CAAC,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CACtE,IAAI,CACJ,CAAA;QACD,MAAM,CAAC,qBAAqB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClE,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}
+{"version":3,"file":"intentLabel.test.js","sourceRoot":"","sources":["../src/intentLabel.test.ts"],"names":[],"mappings":"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"}

package/dist/ordinalTags.d.ts

@@ -1,38 +1,33 @@
-import type { OrdfsMetadata } from './services';
-/** Longest `name:` tag value we store. */
+import type { OrdfsMetadata } from './services.js';
+/** Longest display name we put in customInstructions (not tags). */
 export declare const MAX_NAME_TAG_LENGTH = 64;
 /**
- * Canonical identity tags for an ordinal, derived from ORDFS metadata.
- *
- * The single place that decides what tags an ordinal carries. Every path that
- * reads from ORDFS — `resolveOrdinalTags` in actions, the wallet's
- * `OriginIndexer`, the permission module's verification — must go through
- * here, so an asset is tagged identically whether it arrived by sync, by
- * purchase, or by transfer.
- *
- * Pure: callers fetch through their own services and pass the result in.
- *
- * Emits:
- * - `origin:<outpoint>` — the resolved genesis. **Omitted entirely when
- *   unknown**; an empty `origin:` reads as a resolved value and is never
- *   correct. The bare `origin` marker is a separate thing, set only on the
- *   inscription transaction itself, where the output cannot know its own
- *   outpoint.
- * - `type:<category>` **and** `type:<base>` — hierarchical, so callers can
- *   query broadly (`type:image`) or exactly (`type:image/png`).
- * - `name:<name>` — from MAP `name`, else `subTypeData.name`, truncated.
+ * Ordinals / indexer outpoint form: `txid_vout`.
+ * Accepts dotted (BRC-100) or underscore input. Used for origin tags, CI
+ * origin, BSV21 tokenId-style ids, and OrdFS keys.
+ */
+export declare function formatOrdinalOutpoint(outpoint: string): string;
+/** @deprecated Use {@link formatOrdinalOutpoint} */
+export declare const formatOriginOutpoint: typeof formatOrdinalOutpoint;
+/**
+ * Canonical identity tags for an ordinal (BRC-147).
  *
- * @param metadata - ORDFS metadata, resolved at seq `-2`
- * @param fallbackOrigin - used only when metadata carries no origin
+ * Emits filter tags (lowercase-safe). Does **not** emit `name:` (→ CI `name`).
+ * Bare `origin` is only for the mint out itself (caller stamps that).
  */
 export declare function ordinalTagsFromMetadata(metadata: Partial<OrdfsMetadata> | undefined, fallbackOrigin?: string): string[];
 /**
- * Hierarchical `type:` tags for a content type.
- *
- * `image/png; charset=x` yields `type:image` and `type:image/png`. Returns
- * empty for a missing or blank content type — an empty `type:` is never useful.
+ * Single `type:<mime>` tag. Strips `;…` parameters. No category dual-tag.
+ */
+export declare function contentTypeTag(contentType: string | undefined): string | undefined;
+/**
+ * @deprecated Use {@link contentTypeTag}. Returns 0–1 tags for spread compat.
  */
 export declare function contentTypeTags(contentType: string | undefined): string[];
-/** MAP name, falling back to `subTypeData.name`. */
+/** Parse MAP `subTypeData` (object or JSON string). */
+export declare function parseMapSubTypeData(map: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+/** MAP name, falling back to `subTypeData.name`. For CI `name`, not tags. */
 export declare function nameFromMap(map: Record<string, unknown> | undefined): string | undefined;
+/** Truncate display name for CI. */
+export declare function displayNameForCi(name: string | undefined): string | undefined;
 //# sourceMappingURL=ordinalTags.d.ts.map

package/dist/ordinalTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ordinalTags.d.ts","sourceRoot":"","sources":["../src/ordinalTags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAC5C,cAAc,CAAC,EAAE,MAAM,GACrB,MAAM,EAAE,CAYV;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAQzE;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAOpB"}
+{"version":3,"file":"ordinalTags.d.ts","sourceRoot":"","sources":["../src/ordinalTags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,8BAAwB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAC5C,cAAc,CAAC,EAAE,MAAM,GACrB,MAAM,EAAE,CAuCV;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,GAAG,SAAS,CAIpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAGzE;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAiBrC;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAOpB;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG7E"}

package/dist/ordinalTags.js

@@ -1,64 +1,118 @@
-/** Longest `name:` tag value we store. */
+/** Longest display name we put in customInstructions (not tags). */
 export const MAX_NAME_TAG_LENGTH = 64;
 /**
- * Canonical identity tags for an ordinal, derived from ORDFS metadata.
- *
- * The single place that decides what tags an ordinal carries. Every path that
- * reads from ORDFS — `resolveOrdinalTags` in actions, the wallet's
- * `OriginIndexer`, the permission module's verification — must go through
- * here, so an asset is tagged identically whether it arrived by sync, by
- * purchase, or by transfer.
- *
- * Pure: callers fetch through their own services and pass the result in.
- *
- * Emits:
- * - `origin:<outpoint>` — the resolved genesis. **Omitted entirely when
- *   unknown**; an empty `origin:` reads as a resolved value and is never
- *   correct. The bare `origin` marker is a separate thing, set only on the
- *   inscription transaction itself, where the output cannot know its own
- *   outpoint.
- * - `type:<category>` **and** `type:<base>` — hierarchical, so callers can
- *   query broadly (`type:image`) or exactly (`type:image/png`).
- * - `name:<name>` — from MAP `name`, else `subTypeData.name`, truncated.
+ * Ordinals / indexer outpoint form: `txid_vout`.
+ * Accepts dotted (BRC-100) or underscore input. Used for origin tags, CI
+ * origin, BSV21 tokenId-style ids, and OrdFS keys.
+ */
+export function formatOrdinalOutpoint(outpoint) {
+    const s = outpoint.trim();
+    if (s.length >= 66) {
+        const sep = s[64];
+        if (sep === '.' || sep === '_') {
+            return `${s.slice(0, 64)}_${s.slice(65)}`;
+        }
+    }
+    const dot = s.indexOf('.');
+    if (dot === 64)
+        return `${s.slice(0, 64)}_${s.slice(65)}`;
+    return s.replace('.', '_');
+}
+/** @deprecated Use {@link formatOrdinalOutpoint} */
+export const formatOriginOutpoint = formatOrdinalOutpoint;
+/**
+ * Canonical identity tags for an ordinal (BRC-147).
  *
- * @param metadata - ORDFS metadata, resolved at seq `-2`
- * @param fallbackOrigin - used only when metadata carries no origin
+ * Emits filter tags (lowercase-safe). Does **not** emit `name:` (→ CI `name`).
+ * Bare `origin` is only for the mint out itself (caller stamps that).
  */
 export function ordinalTagsFromMetadata(metadata, fallbackOrigin) {
     const tags = [];
     const origin = metadata?.origin || fallbackOrigin;
     if (origin)
-        tags.push(`origin:${origin}`);
-    for (const t of contentTypeTags(metadata?.contentType))
-        tags.push(t);
-    const name = nameFromMap(metadata?.map);
-    if (name)
-        tags.push(`name:${name.slice(0, MAX_NAME_TAG_LENGTH)}`);
+        tags.push(`origin:${formatOrdinalOutpoint(origin)}`);
+    const map = metadata?.map;
+    const subTypeData = parseMapSubTypeData(map);
+    // Display pointer when media is not at origin (e.g. OrdFS parent / MAP content)
+    const content = typeof map?.content === 'string'
+        ? map.content
+        : typeof metadata?.parent === 'string'
+            ? metadata.parent
+            : undefined;
+    if (content)
+        tags.push(`content:${formatOrdinalOutpoint(content)}`);
+    // collectionId is often nested: MAP subTypeData JSON (collection items)
+    const collectionId = typeof map?.collectionId === 'string'
+        ? map.collectionId
+        : typeof map?.collection === 'string'
+            ? map.collection
+            : typeof subTypeData?.collectionId === 'string'
+                ? subTypeData.collectionId
+                : typeof subTypeData?.collection === 'string'
+                    ? subTypeData.collection
+                    : undefined;
+    if (collectionId) {
+        tags.push(`collection:${formatOrdinalOutpoint(collectionId)}`);
+    }
+    const app = typeof map?.app === 'string' ? map.app : undefined;
+    if (app)
+        tags.push(`app:${app}`);
+    const typeTag = contentTypeTag(metadata?.contentType);
+    if (typeTag)
+        tags.push(typeTag);
     return tags;
 }
 /**
- * Hierarchical `type:` tags for a content type.
- *
- * `image/png; charset=x` yields `type:image` and `type:image/png`. Returns
- * empty for a missing or blank content type — an empty `type:` is never useful.
+ * Single `type:<mime>` tag. Strips `;…` parameters. No category dual-tag.
  */
-export function contentTypeTags(contentType) {
+export function contentTypeTag(contentType) {
     const base = contentType?.split(';')[0]?.trim();
     if (!base)
-        return [];
-    const category = base.split('/')[0];
-    return category && category !== base
-        ? [`type:${category}`, `type:${base}`]
-        : [`type:${base}`];
+        return undefined;
+    return `type:${base}`;
 }
-/** MAP name, falling back to `subTypeData.name`. */
+/**
+ * @deprecated Use {@link contentTypeTag}. Returns 0–1 tags for spread compat.
+ */
+export function contentTypeTags(contentType) {
+    const t = contentTypeTag(contentType);
+    return t ? [t] : [];
+}
+/** Parse MAP `subTypeData` (object or JSON string). */
+export function parseMapSubTypeData(map) {
+    if (!map)
+        return undefined;
+    const raw = map.subTypeData;
+    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    if (typeof raw === 'string' && raw.trim()) {
+        try {
+            const o = JSON.parse(raw);
+            if (o && typeof o === 'object' && !Array.isArray(o)) {
+                return o;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return undefined;
+}
+/** MAP name, falling back to `subTypeData.name`. For CI `name`, not tags. */
 export function nameFromMap(map) {
     if (!map)
         return undefined;
     if (typeof map.name === 'string' && map.name)
         return map.name;
-    const subTypeData = map.subTypeData;
+    const subTypeData = parseMapSubTypeData(map);
     const subName = subTypeData?.name;
     return typeof subName === 'string' && subName ? subName : undefined;
 }
+/** Truncate display name for CI. */
+export function displayNameForCi(name) {
+    if (!name?.trim())
+        return undefined;
+    return name.trim().slice(0, MAX_NAME_TAG_LENGTH);
+}
 //# sourceMappingURL=ordinalTags.js.map

package/dist/ordinalTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"ordinalTags.js","sourceRoot":"","sources":["../src/ordinalTags.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,uBAAuB,CACtC,QAA4C,EAC5C,cAAuB;IAEvB,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,IAAI,cAAc,CAAA;IACjD,IAAI,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC,CAAA;IAEzC,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAEpE,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACvC,IAAI,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,EAAE,CAAC,CAAA;IAEjE,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAA+B;IAC9D,MAAM,IAAI,GAAG,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAA;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACnC,OAAO,QAAQ,IAAI,QAAQ,KAAK,IAAI;QACnC,CAAC,CAAC,CAAC,QAAQ,QAAQ,EAAE,EAAE,QAAQ,IAAI,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;AACpB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAC1B,GAAwC;IAExC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAA;IAE7D,MAAM,WAAW,GAAG,GAAG,CAAC,WAAkD,CAAA;IAC1E,MAAM,OAAO,GAAG,WAAW,EAAE,IAAI,CAAA;IACjC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACpE,CAAC"}
+{"version":3,"file":"ordinalTags.js","sourceRoot":"","sources":["../src/ordinalTags.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1sat/types",
-  "version": "0.0.39",
+  "version": "0.0.41",
   "description": "Type definitions for 1Sat Ordinals SDK",
   "type": "module",
   "main": "./dist/index.js",